Guide · Agent skill
How to use the Identical Links Consistency Check agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The Identical Links Consistency Check is an agent skill that tells an AI agent how to review web page markup and components for links that share the same text but lead to different URLs. It is written for front-end developers, designers and teams preparing an accessibility review. After reading this guide you will know how to install the skill, ask for a review in plain language, and what the agent will and will not do.
Identical Links Consistency Checkthedaviddias/Front-End-Checklist · MIT Download the skill Quick start
- 1Download the ZIP. Get the skill's ZIP file from the download link on this page.
- 2Unzip into a skills folder. Extract it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder.
- 3Or upload in the Claude apps. In the Claude apps, go to Settings → Capabilities → Skills and upload the ZIP.
- 4Give the agent markup to review. Paste the rendered HTML or component code into the conversation, since the skill does not fetch pages.
- 5Ask for a link-text review. Request a check for links with identical text that point to different URLs.
- 6Apply the fixes and verify. Make each link's text unique or point identical text to one destination, then check with accessibility tools.
What an agent skill is and what this one makes the agent do
An agent skill is a folder of written instructions that an AI agent loads when a request matches the skill's description. This skill, identical-links-same-purpose, is a checklist rule rather than a tool that scans sites automatically.
When it applies, the agent looks for links with identical link text that point to different URLs. Its stated purpose is to make sure identical links have consistent destinations, because people who navigate by a list of links, such as screen reader users, cannot tell the destinations apart.
- Flags links that share text but go to different URLs
- Suggests making each link's text unique for its destination, or making identical text always go to the same place
- Explains how the confusion affects people using screen readers
- Explains how to verify fixes with browser accessibility tooling or assistive technology
Install the skill from the ZIP download
Download the ZIP file for the skill from the download link on this page. Then choose one of the two installation routes below.
For Claude Code, unzip the file into your personal skills folder ~/.claude/skills/, or into a project's .claude/skills/ folder if you want the skill limited to one project. The skill folder should contain SKILL.md and a references folder.
To use it in the Claude apps instead, upload the ZIP under Settings → Capabilities → Skills.
- Personal use across projects: ~/.claude/skills/
- Single project: the .claude/skills/ folder inside that project
- Claude apps: Settings → Capabilities → Skills
Trigger the skill with natural requests
You do not need a special command. The skill's description tells the agent when to use it, so ask for a review in ordinary words. Mention the kind of material you are giving the agent: rendered HTML, an interactive component, or a design-system pattern.
Give the agent the actual markup or component code. The skill only guides review of code the agent is given. It does not fetch pages itself, so paste the HTML or upload the files.
- Review this page's HTML for links with the same text pointing to different URLs.
- Check our design-system card component for ambiguous link labels.
- Look at these navigation links and tell me which ones need unique text for an accessibility audit.
Read the agent's findings and apply fixes
The agent should name the specific elements that share link text, explain the problem for people scanning a list of links, and propose a fix. The source gives two standard fixes: make the text unique for each destination, or make sure identical text always leads to the same resource.
The reference guide shows the difference. Two links both reading 'Download Report' to different pages should become 'Download 2022 Report' and 'Download 2023 Report'. Where the destination is genuinely the same, one consistent target is the right answer.
- Unique text for each destination: Download 2022 Report and Download 2023 Report
- Same destination: identical text pointing to one consistent URL
<a href="/report-2022">Download 2022 Report</a>
<a href="/report-2023">Download 2023 Report</a>Verify the fix with accessibility tools
The skill recommends checking the result with browser accessibility tooling or assistive technology rather than trusting the edit alone. Re-run the link list or accessible name check after changing the markup.
Because the skill is a best-practice checklist, treat its output as input to your own testing, not as a final verdict.
- Check that each link's accessible name is distinct in the browser's accessibility tree
- Scan a list of links with a screen reader to confirm the labels make sense out of context
- Review keyboard behaviour and focus order where the links are in interactive components
Safety notes: scripts and network access
The skill runs no scripts and uses no network access, according to its listing. It lists no required dependencies. Its files are SKILL.md and references/rule.md, both of which are plain written instructions.
Because it cannot fetch pages, anything it reviews must come from you. Check the page it is given against the live site yourself if the live version may differ from the code you pasted.
- Runs scripts: no
- Uses network: no
- Requires: nothing listed
What people use it for
- Reviewing a page's navigation or footer for duplicate 'Read more' or 'Download' links that go to different pages
- Checking a design-system card or list component for ambiguous link labels before release
- Preparing a WCAG-oriented accessibility audit by collecting link-text issues to review with your team
- Teaching a junior developer why identical link text confuses screen reader users who scan a link list
Frequently asked questions
How do I install the identical-links-same-purpose skill?
Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder. In the Claude apps, you can instead upload the ZIP under Settings → Capabilities → Skills.
Does this skill need anything else installed?
The listing states it requires nothing and runs no scripts and uses no network access. You supply the markup or component code to review in the conversation.
Is the skill free to use?
The skill is published under the MIT licence. Check the licence text in the source repository for the exact terms before reuse.
Will it scan my whole website automatically?
No. The skill is a written checklist rule and does not crawl sites. It only reviews code you give the agent, and it does not fetch pages itself.
Can I use this instead of a formal accessibility audit?
Not as a sign-off. The skill is a best-practice checklist and not a certified audit or legal compliance check, so use it to support your own testing and review.
What should I do if the agent flags a link that is actually fine?
Check the destinations yourself. If two links with the same text truly go to the same resource, the skill's guidance says that is acceptable, so no change is needed.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
This skill suits front-end developers, designers and teams preparing an accessibility review who want a focused check on duplicate link text. It is a checklist, not an automated scanner or a compliance certificate, so pick a crawler or a full audit tool if you need site-wide coverage or formal sign-off.
Download the skill