intent load

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

shell

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:

shell

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": []
}

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.