Skip to content

Added SKILL.md for agents to use this library#229

Open
asgvard wants to merge 3 commits intomainfrom
dmytro/agentic-skill
Open

Added SKILL.md for agents to use this library#229
asgvard wants to merge 3 commits intomainfrom
dmytro/agentic-skill

Conversation

@asgvard
Copy link
Copy Markdown
Collaborator

@asgvard asgvard commented Apr 27, 2026

The main ideas behind this skill:

  • Doc-linked, not doc-duplicated. Top of the file has a single root URL plus a curated map of which doc page answers which question (concepts, boundaries, key mapping, recipes, etc.).
  • Links to the latest repo docs folder, not the website, as it is meant for agents, and it's easier to read docs from repo than from website.
  • Mental model first. Explicitly names the two component types/shapes (leaf vs container) and the two non-negotiables: attach ref, wrap container children in FocusContext.Provider. Quite a few bugs in this lib are linked to one of those.
  • Patterns-first. Kept the most useful idioms (button, container, modal-with-trap, programmatic focus, conditional focusability) and added a short onArrowPress blocking note since that's a frequent need not obvious from a hook signature alone.
  • Params table + return values for useFocusable, plus a top-level API import block — enough to write code without opening docs, with a pointer to docs/api-reference/ when signatures matter.
  • Debugging section maps each common symptom to the most likely cause, instead of listing tools generically.
  • Frontmatter uses the name + description as a standard for agentic skills.
  • Top level note in README.md on how to install the skill via npx skills

No changesets, purely docs update.

@asgvard asgvard requested a review from a team as a code owner April 27, 2026 09:02
@asgvard asgvard self-assigned this Apr 27, 2026
@asgvard asgvard added the documentation Improvements or additions to documentation label Apr 27, 2026
@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented Apr 27, 2026

⚠️ No Changeset found

Latest commit: 5abb82b

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant