recursica-skill-link

Guides correct usage of the Recursica link component for navigation, labeling, and accessibility.

1|Updated May 29, 2026
One-click install
npx skills add https://github.com/borderux/recursica-knowledge --skill recursica-skill-link-borderux
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: recursica-skill-link
Source: https://github.com/borderux/recursica-knowledge/tree/main/skills/components/recursica-skill-link
Command: npx skills add https://github.com/borderux/recursica-knowledge --skill recursica-skill-link-borderux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams frequently misuse links for actions that change data or state, build fake links from divs and click handlers, or write vague labels like "Click here" that break screen reader navigation. This Skill encodes the Recursica design system's rules for the link component so every navigational element is semantic, accessible, and consistent. ## Core Features & Use Cases - Link vs. button decision rules: Distinguishes navigation (link) from state-changing actions (button), including table rows, modals, and CTAs. - Label and behavior standards: Enforces destination-naming labels, real href attributes, external-link marking, and the prohibition on disabled links and automatic new tabs. - Accessibility requirements: Covers screen reader announcements, keyboard and focus behavior, and multi-channel signaling for external links. - Use Case: When adding a "View invoice" link to a table row, use this Skill to confirm it should be a real anchor naming its destination, persistently visible, and never disabled. ## Quick Start Ask the AI to review or add a link in your UI using the Recursica link guidelines, for example to check whether an element should be a link or a button.

Frequently Asked Questions about recursica-skill-link

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

FAQPage Schema
When should I use a link instead of a button?▼

Use a link when activating it changes the user's location, such as navigating to another page, section, external site, or download. Use a button when the action changes data or state, like Save, Delete, or opening a modal, even if a link would look lighter.

How do I write accessible link text for screen readers?▼

Link labels must name the destination with no verb, such as "Billing settings" instead of "Click here". Screen reader users list links out of context, so each label must be unique, self-sufficient, and identical labels must point to the same destination.

Can a link be disabled in the Recursica design system?▼

No, a link is never disabled because navigation to a related object is always available. If a destination should not exist for a user, omit the link entirely or explain why in adjacent text instead of rendering a disabled state.

Should external links open in a new tab automatically?▼

No, links should never open a new tab automatically; users choose via their context menu or modifier keys. External links must be marked as leaving the product, and that marking cannot rely on color or icon alone.

Why is a div with a click handler not a valid link?▼

A div or span with a click handler is not announced as a link, does not appear in screen reader link lists, and is unreachable by keyboard. Only a real anchor with an href provides right-click, middle-click, copy link address, and proper focus behavior.