link-text-design
Write link text that makes sense out of context for screen reader users and improves usability for everyone. Use when writing or reviewing links, calls to action, navigation labels, or any clickable text. Triggers on: link text, click here, read more, learn more, screen reader links, link purpose, anchor text, call to action, CTA, ambiguous link.
- Installs
- 74
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/owl-listener/inclusive-design-skills --skill link-text-design- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads link-text-design automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Link Text Design
Write link text that tells users where they're going before they get there. Screen reader users often navigate by pulling up a list of all links on a page — if every link says "click here" or "read more", that list is useless.
Core Principle
Every link should make sense when read completely on its own, outside of any surrounding sentence or context.
Rules
Link Text Describes the Destination
- Good: "View your order history"
- Bad: "Click here"
- Good: "Download the accessibility guidelines (PDF, 2.4MB)"
- Bad: "Download"
- Good: "Read the full Q3 performance report"
- Bad: "Read more"
Never Use Generic Link Text
These phrases mean nothing out of context:
- "Click here"
- "Read more"
- "Learn more"
- "Here"
- "This"
- "More"
- "Link"
If you find yourself writing these, ask: more about what? Here where? That answer is your link text.
Same Text, Same Destination
If two links have the same text, they must go to the same place. Two different "Learn more" links going to different pages is confusing for everyone and disorienting for screen reader users.
Different Destinations, Different Text
If two links go to different places, their text must be different.
- Bad: "View details" / "View details" (going to different products)
- Good: "View details for Standard Plan" / "View details for Pro Plan"
Special Cases
Links That Open New Windows or Tabs
- Warn the user: "View the policy (opens in new tab)"
- Or use a visible external link icon with alt text
Links to Files
- State the file type and size: "Annual report (PDF, 3.1MB)"
- This helps users decide before committing to a download
Links Within Body Text
- The link text should be the meaningful phrase, not the whole sentence
- Good: "See the full list of supported languages"
- Bad: "To see the full list of supported languages, click here"
- Don't link URLs as text unless the URL itself is the information
Image Links
- The image's alt text serves as the link text
- A linked logo: alt="Company name — home page"
- A linked icon: alt describes the action, not the icon
Assessment Checklist
- Every link makes sense read on its own
- No generic "click here" or "read more" links
- Same link text always goes to the same destination
- File links state type and size
- New-window links warn the user
- Image links have descriptive alt text
FAQ
What does the link-text-design skill do?
Write link text that makes sense out of context for screen reader users and improves usability for everyone. Use when writing or reviewing links, calls to action, navigation labels, or any clickable text. Triggers on: link text, click here, read more, learn more, screen reader links, link purpose, anchor text, call to action, CTA, ambiguous link.
How do I install link-text-design?
Run npx skills add https://github.com/owl-listener/inclusive-design-skills --skill link-text-design in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/link-text-design/ (personal) or .claude/skills/link-text-design/ (project).
Which AI agents can use link-text-design?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is link-text-design safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains link-text-design?
It is published by owl-listener in owl-listener/inclusive-design-skills. It has 74 recorded installs.
More from owl-listener/inclusive-design-skills
keyboard-navigation
owl-listener/inclusive-design-skills
Design keyboard navigation and focus management for users who cannot or prefer not to use a mouse or touch screen. Use when designing any interactive interface — forms, menus, modals, tabs, carousels, drag-and-drop, data tables, or custom components. Triggers on: keyboard, focus, tab order, focus trap, skip link, arrow keys, keyboard shortcut, can't use mouse, motor disability, switch access, focus indicator, focus ring.
plain-language-design
owl-listener/inclusive-design-skills
Write and review content for plain language accessibility. Use when writing interface copy, error messages, instructions, onboarding text, help content, legal or medical information, forms, or any user-facing text. Triggers on: plain language, reading level, simplify text, jargon, hard to understand, nobody reads this, unclear copy, rewrite, too complicated, ESL, literacy, readability.
cognitive-load-assessment
owl-listener/inclusive-design-skills
Open the skill to read its SKILL.md instructions.
responsive-review
owl-listener/inclusive-design-skills
Open the skill to read its SKILL.md instructions.
user-preference-respect
owl-listener/inclusive-design-skills
Design interfaces that detect and respond to system-level user preferences. Use when implementing dark mode, reduced motion, high contrast, text scaling, or any user preference that affects how the interface renders. Triggers on: user preference, system preference, prefers-reduced-motion, prefers-contrast, prefers-color-scheme, forced-colors, media query, user settings, system settings, accessibility settings, OS settings.
error-prevention-recovery
owl-listener/inclusive-design-skills
Open the skill to read its SKILL.md instructions.
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown：查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件，或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档，也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.