intent load

intent load loads a compact skill identity from the current install and prints the matching SKILL.md content.

npx @tanstack/intent@latest load <package>#<skill> [--path] [--json] [--debug] [--global] [--global-only]

npx @tanstack/intent@latest load <package>#<skill> [--path] [--json] [--debug] [--global] [--global-only]

Options

--path: print the resolved skill path instead of the file content
--json: print structured JSON with metadata and content
--debug: print resolution debug details to stderr
--global: load from project packages first, then global packages
--global-only: load from global packages only

What you get

Resolution

Validates <package>#<skill> before scanning
Scans project-local packages by default
Includes global packages only when --global or --global-only is passed
Checks the target package name against package.json#intent.skills before resolution, then enforces its source kind after resolution
Refuses before scanning when the target package or skill matches intent.exclude

Selection

Prefers local packages when --global is used and the same package exists locally and globally
Accepts an unambiguous short skill name when a package-prefixed skill exists

Output

Prints raw SKILL.md content by default
Prints the scanner-reported path when --path is passed
Prints debug details to stderr when --debug is passed

A successful load proves that Intent resolved the selected skill under current policy and returned its content. It does not prove that the skill was relevant to the task, reached an agent's active context, or was followed correctly. See Lifecycle boundaries.

The package can be scoped or unscoped. The skill can include slash-separated sub-skill names.

Examples:

npx @tanstack/intent@latest load @tanstack/query#fetching
npx @tanstack/intent@latest load @tanstack/query#core/fetching
npx @tanstack/intent@latest load @tanstack/router-core#auth-and-guards
npx @tanstack/intent@latest load some-lib#core --path

npx @tanstack/intent@latest load @tanstack/query#fetching
npx @tanstack/intent@latest load @tanstack/query#core/fetching
npx @tanstack/intent@latest load @tanstack/router-core#auth-and-guards
npx @tanstack/intent@latest load some-lib#core --path

JSON output

--json prints:

json

{
  "package": "@tanstack/query",
  "skill": "fetching",
  "path": "node_modules/@tanstack/query/skills/fetching/SKILL.md",
  "packageRoot": "node_modules/@tanstack/query",
  "source": "local",
  "version": "5.0.0",
  "content": "---\nname: fetching\n---\n\n...",
  "warnings": []
}

{
  "package": "@tanstack/query",
  "skill": "fetching",
  "path": "node_modules/@tanstack/query/skills/fetching/SKILL.md",
  "packageRoot": "node_modules/@tanstack/query",
  "source": "local",
  "version": "5.0.0",
  "content": "---\nname: fetching\n---\n\n...",
  "warnings": []
}

Common errors

Invalid skill identity

Missing separator: Invalid skill use "@tanstack/query": expected <package>#<skill>.
Empty package: Invalid skill use "#core": package is required.
Empty skill: Invalid skill use "@tanstack/query#": skill is required.

Resolution failures

Missing package: Cannot resolve skill use "...": package "..." was not found.
Missing skill: Cannot resolve skill use "...": skill "..." was not found in package "...".
Skill suggestion: Did you mean @tanstack/router-core#router-core/auth-and-guards?

Policy refusals

Unlisted package: Cannot load skill use "...": package "..." is not listed in intent.skills.
Excluded package: Cannot load skill use "...": package "..." is excluded by Intent configuration.
Excluded skill: Cannot load skill use "...": skill "..." is excluded by Intent configuration.