tanstack/cli

query-docs-library-metadata

Retrieve machine-readable context with tanstack libraries, tanstack doc, tanstack search-docs, tanstack create --list-add-ons --json, and --addon-details for agent-safe discovery and preflight validation.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/tanstack/cli --skill query-docs-library-metadata

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Query Docs And Library Metadata

Use this skill to collect authoritative context before code generation or integration selection.

Setup

bash
npx @tanstack/cli libraries --json

Core Patterns

Resolve valid library ids before doc fetch

bash
npx @tanstack/cli libraries --json

Fetch a specific docs page with explicit version

bash
# Syntax: tanstack doc <library-id> <path> [--docs-version <version>]
npx @tanstack/cli doc router framework/react/guide/routing
npx @tanstack/cli doc router framework/react/guide/routing --docs-version latest

Search docs for implementation targets

bash
npx @tanstack/cli search-docs "server functions" --library start --json

Common Mistakes

HIGH Use invalid library id/version/path for doc fetch

Wrong:

bash
# Wrong: --library and --version are not flags on doc; path must not include /docs/ prefix
npx @tanstack/cli doc --library router --version latest --path /docs/framework/react/guide/routing

Correct:

bash
# Step 1: resolve a valid library id
npx @tanstack/cli libraries --json
# Step 2: fetch using positional args — library id then doc path (no /docs/ prefix)
npx @tanstack/cli doc router framework/react/guide/routing

doc takes <library> and <path> as positional arguments (not flags), and the path must not include a leading /docs/ segment. Use --docs-version (not --version) to pin a specific version.

Source: packages/cli/src/cli.ts:746

MEDIUM Rely on deprecated create alias for discovery

Wrong:

bash
npx create-tsrouter-app --list-add-ons

Correct:

bash
npx @tanstack/cli create --list-add-ons --json

Legacy alias workflows can produce confusing outputs that do not match current CLI discovery behavior. Fixed in newer versions, but agents trained on older examples may still generate this pattern.

Source: https://github.com/TanStack/cli/issues/93

HIGH Tension: Single-command convenience vs integration precision

This domain's patterns conflict with create-app-scaffold and choose-ecosystem-integrations. Skipping discovery to run one-shot scaffold commands tends to lock in plausible defaults that miss architecture constraints.

See also: create-app-scaffold/SKILL.md § Common Mistakes

References

按任务相关推荐

来自同一仓库

更多 Skills

全部 Skills