---
name: internal-links-docs
description: "Suggests, then implements internal links for new documentation pages"
argument-hint: "[filename]"
---

The goal is to add new internal links to new docs pages for SEO.

1. Analyze the local documentation page.
2. Review all other files in the `pages/docs` and `content/blog` directories.
3. Identify 3-5 locations in existing pages or blog posts where a link to the new documentation page would be relevant.
4. Suggest 2-3 existing pages or blog posts that I should link to from the new documentation page.

Instructions for suggestions:

- Create unique suggestion numbers across all suggestions so it is easy to approve.
- Follow the links rules in [AGENTS.md](../../../AGENTS.md)
- Use existing text in the documentation page when possible. Avoid new text.
- Inline links mid-sentence are ideal using descriptive, context-rich anchor text.
- Additional links in "Next steps" or "Further Reference" sections are also OK if related.