Quick Start for Consumers

Get started using Intent to set up skill-to-task mappings for your agent.

1. Run install

The install command guides your agent through the setup process:

npx @tanstack/intent@latest install

npx @tanstack/intent@latest install

This prints a skill that instructs your AI agent to:

1. Check for existing intent-skills mappings in your config files (AGENTS.md, CLAUDE.md, .cursorrules, etc.)
2. Run npx @tanstack/intent@latest list to discover available skills from installed packages
3. Scan your repository structure to understand your project
4. Propose relevant skill-to-task mappings based on your codebase patterns
5. Ask if you want a target other than AGENTS.md
6. Write or update an intent-skills block in your agent config

If an intent-skills block already exists, the agent updates that file in place. If no block exists, AGENTS.md is the default target.

Your agent will create mappings like:

<!-- intent-skills:start -->
# Skill mappings — when working in these areas, load the linked skill file into context.
skills:
  - task: "implementing data fetching with TanStack Query"
    load: "node_modules/@tanstack/react-query/skills/core/SKILL.md"
  - task: "setting up routing with TanStack Router"
    load: "node_modules/@tanstack/react-router/skills/core/SKILL.md"
<!-- intent-skills:end -->

<!-- intent-skills:start -->
# Skill mappings — when working in these areas, load the linked skill file into context.
skills:
  - task: "implementing data fetching with TanStack Query"
    load: "node_modules/@tanstack/react-query/skills/core/SKILL.md"
  - task: "setting up routing with TanStack Router"
    load: "node_modules/@tanstack/react-router/skills/core/SKILL.md"
<!-- intent-skills:end -->

2. Use skills in your workflow

When your agent works on a task that matches a mapping, it automatically loads the corresponding SKILL.md into context to guide implementation.

3. Keep skills up-to-date

Skills version with library releases. When you update a library:

npm update @tanstack/react-query

npm update @tanstack/react-query

The new version brings updated skills automatically — you don't need to do anything. The skills are shipped with the library, so you always get the version that matches your installed code. If a package is installed both locally and globally, Intent prefers the local version.

If you need to see what skills have changed, run:

npx @tanstack/intent@latest list

npx @tanstack/intent@latest list

Or use --json for machine-readable output:

npx @tanstack/intent@latest list --json

npx @tanstack/intent@latest list --json

You can also check if any skills reference outdated source documentation:

npx @tanstack/intent@latest stale

npx @tanstack/intent@latest stale

4. Submit feedback (optional)

After using a skill, you can submit feedback to help maintainers improve it:

npx @tanstack/intent@latest meta feedback-collection

npx @tanstack/intent@latest meta feedback-collection

This prints a skill that guides your agent to collect structured feedback about gaps, errors, and improvements.