Skill seekers doc to skill

适配自第三方工具 Skill Seekers（CLI 名 skill-seekers）。源 SKILL.md 仅为占位骨架，实质能力来自上游仓库，本条已补全真实命令与流程。

何时使用

适用：

• 某框架/SDK/产品有成体系的在线文档、GitHub 仓库、PDF 手册或教学视频，你想一次性把它变成可被 Agent 检索的技能（SKILL.md + 分类 references）。
• 需要把同一份知识打包上传到 Claude，或安装进 Cursor/Windsurf 等编码 Agent。
• 想用预设配置或 AI 扫描，对一个代码仓库自动识别框架并生成技能。

不该用（负边界）：

• 你只想手写一条短小、精炼、强观点的技能——直接写，本工具产出的是文档化大块知识，不是精炼操作手册。
• 源没有结构化文档（散落聊天记录、零散截图），抓取价值低。
• 需要逐字翻译/合规改写版权文档——本工具只做结构化抽取，不解决授权问题。

步骤

1. 安装（Python 3.10+）：

   pip install skill-seekers          # 基础
   pip install skill-seekers[all]     # 全功能（含视频/多 LLM）
   skill-seekers-setup                # 可选：交互式初始化
   skill-seekers doctor               # 自检环境
   

2. 抓取生成（按源类型四选一/多）：

   skill-seekers create https://docs.react.dev/ --name react   # 文档网站
   skill-seekers create facebook/react --include-issues        # GitHub 仓库
   skill-seekers create --pdf manual.pdf --name myskill --ocr  # PDF（扫描件加 --ocr）
   skill-seekers create --video-url <youtube> --name tut       # 视频
   skill-seekers scan ./my-app --out ./configs/ --enhance      # AI 扫描仓库识别框架
   

3. 增强（可选但推荐，补示例/工作流）：

   skill-seekers enhance output/react/
   skill-seekers enhance output/react/ --workflow security-focus
   

4. 打包为目标平台（默认 Claude）：

   skill-seekers package output/react/ --target claude
   # 其他：--target gemini|openai|langchain|llama-index|markdown
   skill-seekers package output/react/ --chunk-for-rag --chunk-tokens 512  # RAG 切块
   

5. 上传 / 安装：

   export ANTHROPIC_API_KEY=sk-ant-...
   skill-seekers upload output/react.zip          # API 自动上传
   # 或手动：访问 https://claude.ai/skills 选择 zip
   skill-seekers install-agent output/react/ --agent cursor   # 装进编码 Agent
   

指令

• 一键全流程（取配置→抓取→增强→打包→上传）：

  skill-seekers install --config react
  skill-seekers install --config django --no-upload
  skill-seekers install --config react --dry-run   # 先空跑看计划
  

• 生命周期/续跑（大型抓取必备）：

  skill-seekers create <src> --resume     # 断点续抓
  skill-seekers create <src> --fresh       # 忽略缓存重抓
  skill-seekers create <src> --skip-scrape # 复用已抓数据只重建
  skill-seekers create <src> --preset quick|comprehensive
  skill-seekers resume --list              # 查看可续跑会话
  

• 质量/维护：skill-seekers quality output/react/、skill-seekers update output/react/、skill-seekers enhance-status output/react/ --watch。
• 提速：--async --workers 8（约快 2–3 倍）。

示例

把 Django 文档做成技能并装进 Windsurf，不上传 Claude：

skill-seekers create https://docs.django.com/ --name django --async --workers 8
skill-seekers enhance output/django/
skill-seekers package output/django/ --target claude
skill-seekers install-agent output/django/ --agent windsurf

产出结构：

output/
├── django_data/        # 原始抓取（pages/*.json + summary.json）
└── django/
    ├── SKILL.md        # 已增强，含示例
    ├── references/     # 分类文档（index.md, getting_started.md, ...）
    ├── scripts/        # 留空，供你补充
    └── assets/         # 留空

打包后：output/django-claude.zip。

注意事项

• 凭证：上传 Claude 需 ANTHROPIC_API_KEY；抓 GitHub 强烈建议设 GITHUB_TOKEN——匿名仅 60 次/小时，认证后 5000 次/小时。其他平台对应 GOOGLE_API_KEY / OPENAI_API_KEY；自建端点用 ANTHROPIC_BASE_URL。
• SPA 文档走三层发现（sitemap → llms.txt → 无头渲染），动态站点也能抓但更慢。
• 视频需 pip install skill-seekers[video]；扫描版 PDF 必须加 --ocr。
• 配置/工作流/设置分别在 ./configs/、~/.config/skill-seekers/workflows/、~/.config/skill-seekers/config.json。
• 生成的 SKILL.md 是「文档化」而非「精炼操作化」：自动产物偏全、偏长，入库前建议人工删冗、补强观点边界，再纳入本大典。
• 大型站点先 --dry-run 估算规模，必要时 --preset quick 试跑。

互见

• 手写精炼技能、定义本大典 SCHEMA：见仓库 ROADMAP 与「技能编写规范」。
• 把成品技能纳入飞书侧封装：见 lark-skill-maker。

---

采编自 sickn33/antigravity-awesome-skills（MIT），上游工具 Skill Seekers（yusufkaraaslan/Skill_Seekers）。