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#

• Validates <package>#<skill> before scanning
• Scans project-local packages by default
• Includes global packages only when --global or --global-only is passed
• Refuses before scanning when the target package is not permitted by package.json#intent.skills
• Refuses before scanning when the target package or skill matches intent.exclude
• 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
• 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

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:

{
  "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#

• 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.
• 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?
• 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.

Related#

• intent list
• intent install
• Trust model
• Configuration