Get Listed on the Registry

The Agent Skills Registry automatically discovers and indexes npm packages that ship Agent Skills. There's no manual submission process — publish skills in your package and the registry picks them up.

How discovery works#

The registry periodically searches npm for packages with the tanstack-intent keyword. When it finds one, it downloads the tarball, extracts every skills/**/SKILL.md file, and indexes the contents. Each new version you publish gets indexed automatically.

Ship skills in 4 steps#

1. Create a skill batch#

For repository-wide maintenance, enable the maintainer workflow once:

Register agreed skills with maintainer add, then ask your coding agent to author the developer tasks they cover. The installed instructions load the focused authoring procedure, maintain the shared planning record, and run source-aware review before handoff.

For a one-off authoring session, tell the agent to run:

Give the agent a developer task or concrete code/docs change. The focused procedure creates or updates the relevant guidance and validates it for review; full-library discovery remains available when explicitly requested. Skills use the owning package's skills/ directory or its existing custom root. Record the repository distribution choice during setup: select public skills or use maintainer setup --distribution none for the package-only workflow. See the maintainer quick start.

2. Synchronize metadata#

This adds the tanstack-intent keyword and registered skill directories to existing files allowlists. It preserves npm’s default contents when no allowlist exists. It also synchronizes selected repository exports. Review the diff and inspect the packed archive through the library’s release checks.

3. Review and check#

Save the report under .intent/, assess the pending items, and annotate completed outcomes with their reasons and actual evidence. Record the report with intent maintainer review --record <report.json>, then run intent maintainer check. This checks skill structure, registration, generated files, and pending reviews together. See the source-review reference for report fields and recording.

4. Publish#

Publish through your library's normal release process.

For repository exports, complete the distribution acceptance checks and follow the release and update contract. Publishing an npm version alone does not update plugin versions or consumer installations.

The registry discovers your package on its next sync cycle. Your skills, version history, and download stats appear on the registry automatically.

A passing structural check alone does not establish that the consumer can complete the task. Include that task evidence in the library's release review.

Keeping skills current#

Use maintainer review and stale as separate checks as the library changes. setup optionally installs their CI workflow:

Uses Git changes and recorded content fingerprints to identify skills, planning records, and unmapped source areas that need semantic review. Record completed outcomes with their evidence in .intent/review-state.json; missing evidence remains pending.

Reports conservative package and release signals: version drift, missing stored source SHAs, artifact warnings, and package coverage. It does not compare source diffs. Flagged text reports include the focused authoring command so your agent can investigate the evidence and return a reviewable update or an explained no-op.

Copies the generated CI workflow into your repository. Pull requests validate skills and check recorded source reviews when maintainer guidance or review state exists. Release and manual runs use recorded review state when available, with conservative stale signals as the fallback.

Requesting a library#

If you use a library that doesn't ship skills yet, the best path is to open an issue on that library's repo pointing them here. The maintainer is the right person to author and own skills for their tool — they know the intent behind the API better than anyone.

You can also point them to the Agent Skills spec and the TanStack Intent overview for context.