Agent skill

Link Text Design

by Owl-Listener in Owl-Listener/inclusive-design-skills

Write link text that makes sense out of context for screen reader users and improves usability for everyone.

MITAuto-check passedFrontend & Design

Install Link Text Design

skills CLI
$ npx skills add Owl-Listener/inclusive-design-skills --skill link-text-design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Owl-Listener/inclusive-design-skills link-text-design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Owl-Listener/inclusive-design-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/accessible-content/skills/link-text-design .claude/skills/link-text-design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
link-text-design
GitHub stars
104
Token cost
~702 tokens
SKILL.md length
381 words
Files
1
Skills in repo
55
Repo updated
First seen
Licence
MIT

At a glance

Write link text that makes sense out of context for screen reader users and improves usability for everyone.

  • Reviewing links
  • SKILL.md covers Core Principle, Rules, Special Cases and Assessment Checklist
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Calls to action

What it does

Link Text Design is an agent skill from Owl-Listener/inclusive-design-skills. 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.

Its SKILL.md is about 700 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design, covering Accessibility, UX design and Link building. The repository describes itself as: Inclusive design skills for AI coding agents — from cognitive accessibility to adaptive interfaces, inclusive research, and accessibility decision-making. The licence is MIT.

When your agent uses it

  • Reviewing links
  • Calls to action
  • Navigation labels
  • Any clickable text

Example prompts

  • “/link-text-design”

What it can do on your machine

Read from SKILL.md and the folder at commit 6e0740f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Link Text Design loads about 702 tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 381 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~91
When it runs · the whole SKILL.md, loaded when a task matches
~702

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Owl-Listener/inclusive-design-skills at commit 6e0740f, republished under its MIT licence (© Owl-Listener). 381 words, ~702 tokens.

Download SKILL.mdSave it as .claude/skills/link-text-design/SKILL.md (or your agent's skills folder).
name
link-text-design
description
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.

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

  • 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"

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

  • Warn the user: "View the policy (opens in new tab)"
  • Or use a visible external link icon with alt text
Show full SKILL.md (141 more words)Show less
  • State the file type and size: "Annual report (PDF, 3.1MB)"
  • This helps users decide before committing to a download
  • 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
  • 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

© Owl-Listener, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in accessible-content/skills/link-text-design of Owl-Listener/inclusive-design-skills.

Open the folder on GitHubat commit 6e0740f

Compare with similar skills

Link Text Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Link Text Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Link Text Design this skillOwl-Listener/inclusive-design-skills104—~702Automated safety check: PassMIT
Color Auditrome-os/rome737—~2.7kAutomated safety check: PassMIT
Dont Make Me Thinkluongnv89/skills131—~2.5kAutomated safety check: PassMIT
Super UI UX Designsyahiidkamil/Software-Engineer-AI-Agent-Atlas401—~9kAutomated safety check: PassNone
Design Critiquegetcrew44/crew44356—~691Automated safety check: PassMIT
UI Automation Workflowsconorluddy/xclaude-plugin183—~2.2kAutomated safety check: PassMIT

Similar skills

  • Color Audit

    rome-os/rome

    Audit a design system's color palette against measurable color-science disciplines — WCAG/APCA contrast of declared token pairs, perceptual (OKLCH) ramp uniformity, color-blindness safety of…

    737 GitHub stars~2.7k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Dont Make Me Think

    luongnv89/skills

    Review UI usability using Steve Krug's principles and produce a scannable report.

    131 GitHub stars~2.5k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Super UI UX Design

    syahiidkamil/Software-Engineer-AI-Agent-Atlas

    Complete UI/UX design capability — a wiki-style knowledge map of design theory (UX laws, Nielsen heuristics, usability, visual hierarchy, typography, contrast/WCAG, design systems…

    401 GitHub stars~9k tokensUpdated 3 mo ago
    Frontend & DesignAuto-check passed
  • Design Critique

    getcrew44/crew44

    Walks an agent through five review passes on a screen, flow or mockup, then returns ranked findings with a severity and a suggested fix for each one.

    356 GitHub stars~691 tokensUpdated 4 mo ago
    Frontend & DesignAuto-check passed
  • UI Automation Workflows

    conorluddy/xclaude-plugin

    Accessibility-first UI automation using IDB. An agent skill from conorluddy/xclaude-plugin.

    183 GitHub stars~2.2k tokensUpdated 27 days ago
    Frontend & DesignAuto-check passed
  • Lamina UX

    aryaniyaps/lamina

    Design understandable and accessible product interactions. An agent skill from aryaniyaps/lamina.

    116 GitHub stars~1k tokensUpdated 8 days ago
    Frontend & DesignAuto-check passed

More from Owl-Listener/inclusive-design-skills

All 55 skills in this repo
  • Assistive Technology Scenarios

    Owl-Listener/inclusive-design-skills

    Writes usage scenarios, use cases and storyboards that show real people using screen readers, switches, voice control and other assistive technology to finish tasks.

    104 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Error Prevention and Recovery

    Owl-Listener/inclusive-design-skills

    Designs forgiving forms and flows: prevent input errors, write messages that say what happened and what to do, and add undo, confirmation and recovery paths.

    104 GitHub stars~739 tokensUpdated 4 mo ago
    Auto-check passed
  • Accessible Heading Structure

    Owl-Listener/inclusive-design-skills

    Designs heading hierarchies for screen reader navigation and cognitive accessibility on pages, articles, dashboards and forms.

    104 GitHub stars~763 tokensUpdated 4 mo ago
    Auto-check passed
  • Ability Spectrum Mapping

    Owl-Listener/inclusive-design-skills

    Maps a feature across a range of vision, hearing, motor and cognitive ability to find where the design starts to fail, and to explain accessibility scope to stakeholders.

    104 GitHub stars~917 tokensUpdated 4 mo ago
    Auto-check passed
  • Accessibility Debt Tracking

    Owl-Listener/inclusive-design-skills

    Track and manage accessibility debt — known accessibility issues that have been deferred.

    104 GitHub stars~869 tokensUpdated 4 mo ago
    Auto-check passed
  • Accessibility Testing Strategy

    Owl-Listener/inclusive-design-skills

    Plan what to test, how to test, and who should test for accessibility.

    104 GitHub stars~1k tokensUpdated 4 mo ago
    Auto-check passed

Questions about Link Text Design

What does Link Text Design do?

Write link text that makes sense out of context for screen reader users and improves usability for everyone. Link Text Design is an agent skill from Owl-Listener/inclusive-design-skills. Write link text that makes sense out of context for screen reader users and improves usability for everyone.

When should I use Link Text Design?

Link Text Design fits situations like: reviewing links; calls to action; navigation labels; any clickable text.

How do I install Link Text Design in Claude Code?

Run `npx skills add Owl-Listener/inclusive-design-skills --skill link-text-design -a claude-code`. Or copy the skill folder (accessible-content/skills/link-text-design in Owl-Listener/inclusive-design-skills) into .claude/skills/link-text-design in your project. Claude Code loads it when a task matches its description.

How do I install Link Text Design in Codex?

Run `npx skills add Owl-Listener/inclusive-design-skills --skill link-text-design -a codex`. Or copy the skill folder (accessible-content/skills/link-text-design in Owl-Listener/inclusive-design-skills) into .agents/skills/link-text-design in your project. Codex loads it when a task matches its description.

Can I use Link Text Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Owl-Listener/inclusive-design-skills --skill link-text-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/link-text-design, .gemini/skills/link-text-design, .github/skills/link-text-design and .opencode/skills/link-text-design in your project.

What does Link Text Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Link Text Design is instructions for the agent only.

Does Link Text Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Link Text Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Link Text Design use?

Link Text Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Link Text Design use?

About 702 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Link Text Design?

Skills that share tags, products or a category with Link Text Design: Color Audit (rome-os/rome, 737 stars), Dont Make Me Think (luongnv89/skills, 131 stars), Super UI UX Design (syahiidkamil/Software-Engineer-AI-Agent-Atlas, 401 stars) and Design Critique (getcrew44/crew44, 356 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Link Text Design?

Owl-Listener (a GitHub user) maintains it in Owl-Listener/inclusive-design-skills, which has 104 GitHub stars. The repository holds 55 skills in this directory. The repository was last updated on June 9, 2026.

Source: Owl-Listener/inclusive-design-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.