anchor-links

Validate in-page anchor and skip links for meaningful text and visible focus.

39|2|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/mgifford/accessibility-skills --skill anchor-links
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: anchor-links
Source: https://github.com/mgifford/accessibility-skills/tree/main/skills/anchor-links
Command: npx skills add https://github.com/mgifford/accessibility-skills --skill anchor-links

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps ensure in-page anchor links, skip links, and heading links meet accessibility standards by ensuring meaningful text, reachable targets, and visible focus indicators.

Core Features & Use Cases

  • Validate that all anchor links have descriptive, contextual text that remains meaningful out of context.
  • Ensure skip links are the first focusable element in the DOM and visible when focused, and that targets are properly reachable.
  • Provide guidance for focus management and smooth scrolling that respects reduced-motion preferences.

Quick Start

Review your project for in-page navigation and apply the anchor-links rules to ensure meaningful link text, reachable targets, and visible focus indicators.

Frequently Asked Questions about anchor-links

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make skip links visible when focused for keyboard navigation?

To make skip links visible, ensure they are the first focusable element in the DOM and display them prominently when focused. This accessibility skill enforces visible focus indicators and proper skip-link semantics for keyboard navigation.

How do I fix ambiguous anchor link text for web accessibility audits?

Fix ambiguous anchor link text by ensuring all in-page anchors have descriptive, contextual text that remains meaningful out of context. This skill validates heading links and anchor targets during design reviews to meet accessibility standards.

What is the correct scroll behavior for accessible heading links?

Correct scroll behavior for heading links requires appropriate focus management and smooth scrolling that respects reduced-motion preferences. This skill provides guidance to ensure reachable targets and accessible scroll behavior.

Do I need descriptive link text for in-page anchor navigation?

Yes, you need descriptive link text for in-page anchor navigation to meet accessibility standards. This skill enforces descriptive link text requirements, ensuring anchor links remain meaningful out of context for screen reader users.

How do I ensure anchor link targets are reachable during accessibility reviews?

Ensure anchor link targets are reachable by validating that skip links and heading links have properly reachable targets and correct semantics. This skill audits in-page navigation to fix hidden skip links and ambiguous labels.

Why does my skip link not receive focus on page load?

Skip links fail to receive focus when they are not the first focusable element in the DOM or lack proper semantics. This skill helps audit and fix skip-link placement, ensuring they are reachable and display visible focus indicators.