Overview

@tanstack/intent is a CLI for shipping and consuming Agent Skills as package artifacts.

Skills are markdown documents that teach AI coding agents how to use your library correctly. Intent versions them with your releases, ships them inside npm packages, discovers them from local and accessible global node_modules, and helps agents load them automatically when working on matching tasks.

Intent provides tooling for two workflows:

For consumers:

• Discover skills from installed dependencies
• Generate task-to-skill mappings for your agent config
• Keep skills synchronized with library versions

For maintainers (library teams):

• Scaffold skills through AI-assisted domain discovery
• Validate SKILL.md format and packaging
• Ship skills in the same release pipeline as code
• Track staleness when source docs change

npx @tanstack/intent@latest list

Scans local node_modules and any accessible global node_modules for intent-enabled packages, preferring local packages when both exist.

npx @tanstack/intent@latest install

Prints instructions for your agent to create intent-skills mappings in your config files (AGENTS.md, CLAUDE.md, .cursorrules, etc.). Existing mappings are updated in place; otherwise AGENTS.md is the default target.

npx @tanstack/intent@latest scaffold

Guides your agent through domain discovery, tree generation, and skill authoring with interactive maintainer interviews.

npx @tanstack/intent@latest validate

Enforces SKILL.md format rules and packaging requirements before publish.

npx @tanstack/intent@latest stale

Detects when skills reference outdated source documentation or library versions.