Skill Seekers

Skill Seekers

English | 简体中文 | 日本語 | 한국어 | Español | Français | Deutsch | Português | Türkçe | العربية | हिन्दी | Русский

🧠 AI 系统的数据层。 Skill Seekers 可将文档网站、GitHub 仓库、PDF、视频、笔记本、Wiki 等——18 种来源类型——转换为结构化知识资产，为 AI Skills（Claude、Gemini、OpenAI）、RAG 管道（LangChain、LlamaIndex、Pinecone）和 AI 编码助手（Cursor、Windsurf、Cline）提供支持。一次准备，即可导出到 22 个目标。

💛 赞助商

青铜赞助商

_{赞助商 — 青铜级}

成为赞助商 · GitHub Sponsors

🚀 快速开始

# 1. Install
pip install skill-seekers

# 2. Create a skill from any source
skill-seekers create https://docs.djangoproject.com/

# Optional: preview how a source will be detected without creating anything
skill-seekers detect https://docs.djangoproject.com/ --json

# 3. Package it for your AI platform
skill-seekers package output/django --target claude

现在你有了 output/django-claude.zip，可以直接使用。

# Pick a different AI agent for enhancement (default: claude)
skill-seekers create https://docs.djangoproject.com/ --agent kimi
skill-seekers create https://docs.djangoproject.com/ --agent-cmd "my-custom-agent run"

🛰️ AI 驱动的项目扫描

将项目路径传给 scan，AI Agent 会读取其清单文件、README、Dockerfile/CI 和抽样源代码导入项，然后为检测到的每种框架生成一个配置，并为你自己的代码生成一个 <project>-codebase.json：

skill-seekers scan ./my-react-app --out ./configs/scanned/
# → react.json, vite.json, tailwind.json, jest.json, my-react-app-codebase.json

skill-seekers create ./configs/scanned/react.json

如果某项检测结果没有现成的预设，AI 会生成新的配置；退出时，你可以选择将其发布到社区注册表。

全部 18 种来源类型

skill-seekers create facebook/react            # GitHub repository
skill-seekers create ./my-project              # Local codebase
skill-seekers create manual.pdf                # PDF
skill-seekers create report.docx               # Word
skill-seekers create book.epub                 # EPUB
skill-seekers create notebook.ipynb            # Jupyter
skill-seekers create openapi.yaml              # OpenAPI/Swagger
skill-seekers create presentation.pptx         # PowerPoint
skill-seekers create guide.adoc                # AsciiDoc
skill-seekers create page.html                 # Local HTML (or a whole dir)
skill-seekers create feed.rss                  # RSS/Atom
skill-seekers create curl.1                    # Man page

# Video (YouTube, Vimeo, or local — needs skill-seekers[video])
skill-seekers create --video-url https://www.youtube.com/watch?v=... --name mytutorial
skill-seekers create --setup                   # auto-install GPU-aware visual deps

skill-seekers create --space-key TEAM --name wiki               # Confluence
skill-seekers create --database-id ... --name docs              # Notion
skill-seekers create --chat-export-path ./slack-export --name team-chat  # Slack/Discord

每种来源类型及其选项，请参阅抓取指南。

📦 安装

pip install skill-seekers              # Core: scraping, GitHub, PDF, packaging
pip install skill-seekers[all-llms]    # + every LLM platform
pip install skill-seekers[mcp]         # + MCP server
pip install skill-seekers[all]         # Everything

不确定需要什么？ 运行向导：skill-seekers-setup

前置条件： Python 3.10+、Git。初次使用？→ 可靠快速入门 🎯

📚 文档

完整文档索引： docs/README.md

🎯 你将获得

导出目标（22）

skill-seekers package output/react --target claude      # → Claude Skill (ZIP + YAML)
skill-seekers package output/react --target langchain   # → LangChain Documents
skill-seekers package output/react --target llama-index # → LlamaIndex TextNodes
skill-seekers package output/react --target ibm-bob     # → IBM Bob skill directory

大模型平台（12）： claude · gemini · openai · minimax · opencode · kimi · deepseek · qwen · openrouter · together · fireworks · markdown RAG 和向量（8）： langchain · llama-index · haystack · chroma · faiss · weaviate · qdrant · pinecone 其他（2）： atlas · ibm-bob

各平台支持详情请参阅功能矩阵。

为什么重要

• ⚡ 快 99% — 数天的手动数据准备缩短至 15–45 分钟
• 🎯 真正优质的技能 — 超过 500 行的 SKILL.md 文件，包含示例、模式和指南
• 📊 适用于 RAG 的分块 — 智能分块可保留代码块和上下文
• 🔄 多来源 — 将文档、GitHub、PDF 和视频合并为一个知识资产
• 🌐 一次准备，适用于所有目标 — 无需重新抓取，即可导出到 22 个目标
• ✅ 经过实战检验 — 超过 3,900 项测试、68 个工作流预设，可用于生产环境

✨ 核心功能

skill-seekers create ./my-project --preset quick          # 1–2 min, surface level
skill-seekers create ./my-project --preset standard       # balanced (default)
skill-seekers create ./my-project --preset comprehensive  # deep, exhaustive

🔌 MCP 集成（40 个工具）

Skill Seekers 为 Claude Code、Cursor、Windsurf、VS Code + Cline 和 IntelliJ IDEA 提供 MCP 服务。

# stdio mode (Claude Code, VS Code + Cline)
python -m skill_seekers.mcp.server_fastmcp

# HTTP mode (Cursor, Windsurf, IntelliJ)
python -m skill_seekers.mcp.server_fastmcp --transport http --port 8765

然后直接向你的助手提出请求：“打包并上传 React 技能。”

→ MCP 设置 · MCP 参考 · HTTP 传输

🤖 安装到 AI Agent

技能会自动安装到 19 个 AI 编码 Agent：

skill-seekers install-agent output/react/ --agent cursor
skill-seekers install-agent output/react/ --agent all      # every detected agent
skill-seekers install-agent output/react/ --agent cursor --dry-run

上传到 Claude

export ANTHROPIC_API_KEY=sk-ant-...
skill-seekers package output/react/ --upload   # package + upload
skill-seekers upload output/react.zip          # upload an existing zip

没有 API 密钥？打包后，前往 claude.ai/skills 手动上传 output/react.zip。

→ 上传指南

⚙️ 工作原理

graph LR
    A[Documentation Website] --> B[Skill Seekers]
    B --> C[Scraper]
    B --> D[AI Enhancement]
    B --> E[Packager]
    C --> F[Organized References]
    D --> F
    F --> E
    E --> G[AI Skill .zip]
    G --> H[Upload to AI Platform]

1. 抓取 — 提取每个页面（先检查 llms.txt）
2. 分类 — 将内容整理为不同主题（API、指南、教程等）
3. 增强 — AI 编写包含示例的全面 SKILL.md
4. 打包 — 打包为适用于平台的构件
5. 上传 — 将其发送到你的 AI 平台（可选）

架构

8 个核心模块 + 5 个实用工具模块（约 200 个类）：

→ UML 架构 · API 参考 · 技能架构

🆕 v3.9.0 新增内容

• 为格式错误的标记提供 HTML 解析器回退方案（#96）— 严重格式错误的页面不再被抓取为空；格式正确的页面与原始字节完全一致。
• 瞬时故障重试 — 文档抓取器（#97）和 MCP fetch_config（#92）现在会在连接短暂中断和 5xx 错误时进行退避重试；遇到 4xx 错误仍会快速失败。
• Whisper 转录回退方案（#420）— 没有字幕的本地视频现在终于可以生成真实转录文本。
• MiniMax 图像 OCR + 由注册表驱动的多模态提供方（#423）— 提供方声明其传输协议和图像能力；中国发行的密钥可以连接到正确的端点。
• 精简 Token 的 GitHub 问题默认设置（#169）— GitHub 技能默认不再打包完整的已关闭问题历史记录。
• 通过环境变量为所有三个服务配置 CORS（#422、#424）— 不再使用带凭据的通配符来源。

完整历史记录：CHANGELOG.md

📈 性能

🐛 故障排除

skill-seekers doctor          # diagnose installation & environment
skill-seekers doctor --json   # machine-readable diagnostics for CI and agents
skill-seekers sync-config     # detect config drift

常见问题及解决方法：故障排除指南 · TROUBLESHOOTING.md

🤝 参与贡献

欢迎贡献——请参阅 CONTRIBUTING.md。

• 📋 开发路线图与任务 — 选择任意任务
• 💬 讨论 — 提问和分享想法
• 🐛 问题 — 错误和功能请求

📝 许可证

MIT — 请参阅 LICENSE。

🔒 安全

🌐 生态系统

Skill Seekers 是一个多仓库项目：

想要参与贡献？ 网站和配置仓库是新贡献者的绝佳起点！