Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
owl-listener avatar

Link Text Design

  • 34 installs
  • 87 repo stars
  • Updated June 9, 2026
  • owl-listener/inclusive-design-skills

Helps with ai & agent building tasks during AI-assisted development.

About

link-text-design is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted coding.

  • link-text-design
  • AI & Agent Building
  • AI-coding skill

Link Text Design by the numbers

  • 34 all-time installs (skills.sh)
  • +5 installs in the week ending Aug 4, 2026 (Skillselion tracking)
  • Ranked #8,855 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
  • Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/owl-listener/inclusive-design-skills --skill link-text-design

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs34
repo stars87
Last updatedJune 9, 2026
Repositoryowl-listener/inclusive-design-skills

What it does

Helps with ai & agent building tasks during AI-assisted development.

Files

SKILL.mdMarkdownGitHub ↗

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

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.