firefrost-gaming/skill-seekers-reference
3
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

docs: update changelog, readme, and docs for v3.5.0

Browse Source 
- Add CHANGELOG.md entry for v3.5.0 with all PR #336 changes
- Update README.md: version 3.5.0, agent-agnostic examples, marketplace
  pipeline, SPA discovery
- Update CLAUDE.md: AgentClient architecture, 40 MCP tools, new modules
- Update docs/: UML architecture, MCP reference (40 tools, new tool
  categories), enhancement modes (multi-provider/multi-agent), FAQ
- Update src/skill_seekers/mcp/README.md: accurate tool count and paths

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
yusyus
2026-04-02 04:57:32 +03:00
parent c6a6db01bf
commit 2a14309342
11 changed files with 167 additions and 47 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
CHANGELOG.md
View File

@@ -7,17 +7,55 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased] ## [Unreleased]
## [3.5.0] - 2026-04-01
**Theme:** Agent-agnostic architecture, marketplace pipeline, smart SPA discovery, dynamic routing refactor, and removal of artificial limits. 60+ files changed across the codebase (#336).
### Added ### Added
- **Agent-agnostic `AgentClient` abstraction** — all 5 enhancers now support Claude, Kimi, Codex, Copilot, OpenCode, and custom agents via a unified interface. Auto-detects agent from API keys instead of hardcoding (#336)
- **Kimi CLI integration** with stdin piping and output parsing (#336)
- **`MarketplacePublisher`** — publish skills to Claude Code plugin marketplace repos (#336)
- **`MarketplaceManager`** — register and manage marketplace repositories (#336)
- **`ConfigPublisher`** — push configs to registered config source repos (#336)
- **`push_config` MCP tool** for automated config publishing (#336)
- **Smart SPA discovery engine** — three-layer discovery: sitemap.xml, llms.txt, SPA nav rendering (#336)
- **`"browser": true` config support** for JavaScript SPA sites with browser renderer timeout defaults (60s, domcontentloaded) (#336)
- **Dynamic routing via `_build_argv()`** — replaced manual arg forwarding with dynamic forwarder, added 7 missing CLI flags (#336)
- **Kotlin language support for codebase analysis** — Full C3.x pipeline support: AST parsing (classes, objects, functions, data/sealed classes, extension functions, coroutines), dependency extraction, design pattern recognition (object declaration→Singleton, companion object→Factory, sealed class→Strategy), test example extraction (JUnit, Kotest, MockK, Spek), language detection patterns, config detection (build.gradle.kts), and extension maps across all analyzers (#287) - **Kotlin language support for codebase analysis** — Full C3.x pipeline support: AST parsing (classes, objects, functions, data/sealed classes, extension functions, coroutines), dependency extraction, design pattern recognition (object declaration→Singleton, companion object→Factory, sealed class→Strategy), test example extraction (JUnit, Kotest, MockK, Spek), language detection patterns, config detection (build.gradle.kts), and extension maps across all analyzers (#287)
- **Headless browser rendering** (`--browser` flag) — uses Playwright to render JavaScript SPA sites (React, Vue, etc.) that return empty HTML shells. Auto-installs Chromium on first use. Optional dep: `pip install "skill-seekers[browser]"` (#321) - **Headless browser rendering** (`--browser` flag) — uses Playwright to render JavaScript SPA sites (React, Vue, etc.) that return empty HTML shells. Auto-installs Chromium on first use. Optional dep: `pip install "skill-seekers[browser]"` (#321)
- **`skill-seekers doctor` command** — 8 diagnostic checks (Python version, package install, git, core/optional deps, API keys, MCP server, output dir) with pass/warn/fail status and `--verbose` flag (#316) - **`skill-seekers doctor` command** — 8 diagnostic checks (Python version, package install, git, core/optional deps, API keys, MCP server, output dir) with pass/warn/fail status and `--verbose` flag (#316)
- **Prompt injection check workflow** — bundled `prompt-injection-check` workflow scans scraped content for injection patterns (role assumption, instruction overrides, delimiter injection, hidden instructions). Added as first stage in `default` and `security-focus` workflows. Flags suspicious content without removing it (#324) - **Prompt injection check workflow** — bundled `prompt-injection-check` workflow scans scraped content for injection patterns (role assumption, instruction overrides, delimiter injection, hidden instructions). Added as first stage in `default` and `security-focus` workflows. Flags suspicious content without removing it (#324)
- **6 behavioral UML diagrams** — 3 sequence (create pipeline, GitHub+C3.x flow, MCP invocation), 2 activity (source detection, enhancement pipeline), 1 component (runtime dependencies with interface contracts) - **6 behavioral UML diagrams** — 3 sequence (create pipeline, GitHub+C3.x flow, MCP invocation), 2 activity (source detection, enhancement pipeline), 1 component (runtime dependencies with interface contracts)
- **134 new tests** — `test_agent_client.py`, `test_config_publisher.py`, `_build_argv` tests. Total: 3194 passed, 39 expected skips (#336)
### Changed
- **Renamed `claude-enhanced` merge mode to `ai-enhanced`** — backward compatibility alias kept (#336)
- **Removed 118+ hardcoded Claude references** across 60+ files (#336)
- **Refactored 5 enhancers** to use `AgentClient` abstraction (#336)
- **Removed 50-file GitHub API analysis limit** (#336)
- **Removed 100-file config extraction limit** (#336)
- **Fixed unified scraper default `max_pages`** from 100 to 500 (#336)
- **Centralized enhancement timeouts** to 45min default with unlimited support (#336)
### Fixed ### Fixed
- **`scraped_data` list-vs-dict bug** in conflict detection (#336)
- **`base_url` passthrough** to doc scraper subprocess (#336)
- **URL filtering** now uses base directory correctly (#336)
- **C3.x analysis data loss** (#336)
- **`--enhance-level` flag** not passed correctly (#336)
- **`guide_enhancer` method rename** — `_call_claude_api` renamed to `_call_ai` (#336)
- **11 pre-existing test failures** fixed (#336)
- **Per-file language detection** in GitHub scraper (#336)
- **GitHub language detection crashes with `TypeError`** when API response contains non-integer metadata keys (e.g., `"url"`) — now filters to integer values only (#322) - **GitHub language detection crashes with `TypeError`** when API response contains non-integer metadata keys (e.g., `"url"`) — now filters to integer values only (#322)
- **C3.x codebase analysis crashes with `TypeError`** — `_run_c3_analysis()` and `_analyze_c3x()` passed removed `enhance_with_ai`/`ai_mode` kwargs to `analyze_codebase()` instead of `enhance_level` (#323) - **C3.x codebase analysis crashes with `TypeError`** — `_run_c3_analysis()` and `_analyze_c3x()` passed removed `enhance_with_ai`/`ai_mode` kwargs to `analyze_codebase()` instead of `enhance_level` (#323)
### Security
- **Removed command injection** via cloned repo script execution (#336)
- **Replaced `git add -A`** with targeted staging in marketplace publisher (#336)
- **Clear auth tokens** from cached `.git/config` after clone (#336)
- **Use `defusedxml`** for sitemap XML parsing (XXE protection) (#336)
- **Path traversal validation** for config names (#336)
## [3.4.0] - 2026-03-21 ## [3.4.0] - 2026-03-21
### Added ### Added

16
CLAUDE.md
View File

@@ -133,13 +133,21 @@ Local codebase analysis features, all opt-out (`--skip-*` flags):
### MCP Server ### MCP Server
`src/skill_seekers/mcp/server_fastmcp.py` - 26+ tools via FastMCP. Transport: stdio (Claude Code) or HTTP (Cursor/Windsurf). Optional dependency: `pip install -e ".[mcp]"` `src/skill_seekers/mcp/server_fastmcp.py` - 40 tools via FastMCP. Transport: stdio (Claude Code) or HTTP (Cursor/Windsurf). Optional dependency: `pip install -e ".[mcp]"`
### Enhancement Modes Supporting modules:
- `marketplace_publisher.py` - Publish skills to plugin marketplace repositories
- `marketplace_manager.py` - Manage marketplace registry
- `config_publisher.py` - Push configs to registered config source repositories
- **API mode** (if `ANTHROPIC_API_KEY` set): Direct Claude API calls ### Enhancement Modes (via AgentClient)
- **LOCAL mode** (fallback): Uses Claude Code CLI (free with Max plan)
Enhancement now uses the `AgentClient` abstraction (`src/skill_seekers/cli/agent_client.py`) instead of direct Claude API calls:
- **API mode** (if API key set): Supports Anthropic, Moonshot/Kimi, Google Gemini, OpenAI
- **LOCAL mode** (fallback): Supports Claude Code, Kimi Code, Codex, Copilot, OpenCode, custom agents
- Control: `--enhance-level 0` (off) / `1` (SKILL.md only) / `2` (default, balanced) / `3` (full) - Control: `--enhance-level 0` (off) / `1` (SKILL.md only) / `2` (default, balanced) / `3` (full)
- Agent selection: `--agent claude|codex|copilot|opencode|kimi|custom`
## Key Implementation Details ## Key Implementation Details

40
README.md
View File

@@ -6,7 +6,7 @@
English | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Português](README.pt-BR.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [हिन्दी](README.hi.md) | [Русский](README.ru.md) English | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Português](README.pt-BR.md) | [Türkçe](README.tr.md) | [العربية](README.ar.md) | [हिन्दी](README.hi.md) | [Русский](README.ru.md)
[![Version](https://img.shields.io/badge/version-3.2.0-blue.svg)](https://github.com/yusufkaraaslan/Skill_Seekers/releases) [![Version](https://img.shields.io/badge/version-3.5.0-blue.svg)](https://github.com/yusufkaraaslan/Skill_Seekers/releases)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/) [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![MCP Integration](https://img.shields.io/badge/MCP-Integrated-blue.svg)](https://modelcontextprotocol.io) [![MCP Integration](https://img.shields.io/badge/MCP-Integrated-blue.svg)](https://modelcontextprotocol.io)
@@ -100,6 +100,13 @@ skill-seekers package output/django --target claude
**That's it!** You now have `output/django-claude.zip` ready to use. **That's it!** You now have `output/django-claude.zip` ready to use.
```bash
# Use a different AI agent for enhancement (default: claude)
skill-seekers create https://docs.django.com/ --agent kimi
skill-seekers create https://docs.django.com/ --agent codex
skill-seekers create https://docs.django.com/ --agent-cmd "my-custom-agent run"
```
### Other Sources (17 Supported) ### Other Sources (17 Supported)
```bash ```bash
@@ -224,6 +231,7 @@ Instead of spending days on manual preprocessing, Skill Seekers:
## Key Features ## Key Features
### 🌐 Documentation Scraping ### 🌐 Documentation Scraping
- ✅ **Smart SPA Discovery** - Three-layer discovery for JavaScript SPA sites (sitemap.xml → llms.txt → headless browser rendering)
- ✅ **llms.txt Support** - Automatically detects and uses LLM-ready documentation files (10x faster) - ✅ **llms.txt Support** - Automatically detects and uses LLM-ready documentation files (10x faster)
- ✅ **Universal Scraper** - Works with ANY documentation website - ✅ **Universal Scraper** - Works with ANY documentation website
- ✅ **Smart Categorization** - Automatically organizes content by topic - ✅ **Smart Categorization** - Automatically organizes content by topic
@@ -519,7 +527,7 @@ skill-seekers resume github_react_20260117_143022
### 🎯 Bootstrap Skill - Self-Hosting ### 🎯 Bootstrap Skill - Self-Hosting
Generate skill-seekers as a Claude Code skill to use within Claude: Generate skill-seekers as a skill to use within your AI agent (Claude Code, Kimi, Codex, etc.):
```bash ```bash
# Generate the skill # Generate the skill
@@ -636,6 +644,15 @@ stages:
- ✅ **Checkpoint/Resume** - Never lose progress on long scrapes - ✅ **Checkpoint/Resume** - Never lose progress on long scrapes
- ✅ **Caching System** - Scrape once, rebuild instantly - ✅ **Caching System** - Scrape once, rebuild instantly
### 🤖 Agent-Agnostic Skill Generation
- ✅ **Multi-Agent Support** - Generate skills for Claude, Kimi, Codex, Copilot, OpenCode, or any custom agent via `--agent` flag
- ✅ **Custom Agent Commands** - Use `--agent-cmd` to specify a custom agent CLI command for enhancement
- ✅ **Universal Flags** - `--agent` and `--agent-cmd` available on all commands (create, scrape, github, pdf, etc.)
### 📦 Marketplace Pipeline
- ✅ **Publish to Marketplace** - Publish skills to Claude Code plugin marketplace repos
- ✅ **End-to-End Pipeline** - From documentation source to published marketplace entry
### ✅ Quality Assurance ### ✅ Quality Assurance
- ✅ **Fully Tested** - 2,540+ tests with comprehensive coverage - ✅ **Fully Tested** - 2,540+ tests with comprehensive coverage
@@ -719,7 +736,7 @@ skill-seekers install --config react --dry-run
**Requirements:** **Requirements:**
- ANTHROPIC_API_KEY environment variable (for auto-upload) - ANTHROPIC_API_KEY environment variable (for auto-upload)
- Claude Code Max plan (for local AI enhancement) - Claude Code Max plan (for local AI enhancement), or use `--agent` to select a different AI agent
--- ---
@@ -756,6 +773,9 @@ skill-seekers scrape --url https://react.dev --name react
# With async mode (3x faster) # With async mode (3x faster)
skill-seekers scrape --config configs/godot.json --async --workers 8 skill-seekers scrape --config configs/godot.json --async --workers 8
# Use a specific AI agent for enhancement
skill-seekers scrape --config configs/react.json --agent kimi
``` ```
### PDF Extraction ### PDF Extraction
@@ -902,15 +922,15 @@ graph LR
C --> F[Organized References] C --> F[Organized References]
D --> F D --> F
F --> E F --> E
E --> G[Claude Skill .zip] E --> G[AI Skill .zip]
G --> H[Upload to Claude AI] G --> H[Upload to AI Platform]
``` ```
0. **Detect llms.txt** - Checks for llms-full.txt, llms.txt, llms-small.txt first 0. **Detect llms.txt** - Checks for llms-full.txt, llms.txt, llms-small.txt first (part of Smart SPA Discovery)
1. **Scrape**: Extracts all pages from documentation 1. **Scrape**: Extracts all pages from documentation
2. **Categorize**: Organizes content into topics (API, guides, tutorials, etc.) 2. **Categorize**: Organizes content into topics (API, guides, tutorials, etc.)
3. **Enhance**: AI analyzes docs and creates comprehensive SKILL.md with examples 3. **Enhance**: AI analyzes docs and creates comprehensive SKILL.md with examples (supports multiple agents via `--agent`)
4. **Package**: Bundles everything into a Claude-ready `.zip` file 4. **Package**: Bundles everything into a platform-ready `.zip` file
## Architecture ## Architecture
@@ -924,9 +944,9 @@ The system is organized into **8 core modules** and **5 utility modules** (~200
| **Scrapers** | 17 source-type extractors | `DocToSkillConverter`, `GitHubScraper`, `UnifiedScraper` | | **Scrapers** | 17 source-type extractors | `DocToSkillConverter`, `GitHubScraper`, `UnifiedScraper` |
| **Adaptors** | 20+ output platform formats | `SkillAdaptor` (ABC), `ClaudeAdaptor`, `LangChainAdaptor` | | **Adaptors** | 20+ output platform formats | `SkillAdaptor` (ABC), `ClaudeAdaptor`, `LangChainAdaptor` |
| **Analysis** | C3.x codebase analysis pipeline | `UnifiedCodebaseAnalyzer`, `PatternRecognizer`, 10 GoF detectors | | **Analysis** | C3.x codebase analysis pipeline | `UnifiedCodebaseAnalyzer`, `PatternRecognizer`, 10 GoF detectors |
| **Enhancement** | AI-powered skill improvement | `AIEnhancer`, `UnifiedEnhancer`, `WorkflowEngine` | | **Enhancement** | AI-powered skill improvement via `AgentClient` | `AgentClient`, `AIEnhancer`, `UnifiedEnhancer`, `WorkflowEngine` |
| **Packaging** | Package, upload, install skills | `PackageSkill`, `InstallAgent` | | **Packaging** | Package, upload, install skills | `PackageSkill`, `InstallAgent` |
| **MCP** | FastMCP server (34 tools) | `SkillSeekerMCPServer`, 8 tool modules | | **MCP** | FastMCP server (40 tools) | `SkillSeekerMCPServer`, 10 tool modules |
| **Sync** | Doc change detection | `ChangeDetector`, `SyncMonitor`, `Notifier` | | **Sync** | Doc change detection | `ChangeDetector`, `SyncMonitor`, `Notifier` |
Utility modules: **Parsers** (28 CLI parsers), **Storage** (S3/GCS/Azure), **Embedding** (multi-provider vectors), **Benchmark** (performance), **Utilities** (16 shared helpers). Utility modules: **Parsers** (28 CLI parsers), **Storage** (S3/GCS/Azure), **Embedding** (multi-provider vectors), **Benchmark** (performance), **Utilities** (16 shared helpers).

4
ROADMAP.md
View File

@@ -11,7 +11,7 @@ Transform Skill Seekers into the easiest way to create Claude AI skills from **a
**What Works:** **What Works:**
- ✅ **17 source types** — documentation, GitHub, PDF, video, Word, EPUB, Jupyter, local HTML, OpenAPI, AsciiDoc, PowerPoint, RSS/Atom, man pages, Confluence, Notion, Slack/Discord, local codebase - ✅ **17 source types** — documentation, GitHub, PDF, video, Word, EPUB, Jupyter, local HTML, OpenAPI, AsciiDoc, PowerPoint, RSS/Atom, man pages, Confluence, Notion, Slack/Discord, local codebase
- ✅ Unified multi-source scraping with generic merge for any source combination - ✅ Unified multi-source scraping with generic merge for any source combination
- ✅ 26+ MCP tools fully functional - ✅ 40 MCP tools fully functional
- ✅ Multi-platform support (16 platforms: Claude, Gemini, OpenAI, LangChain, LlamaIndex, Haystack, ChromaDB, FAISS, Weaviate, Qdrant, Cursor, Windsurf, Cline, Continue.dev, Pinecone, Markdown) - ✅ Multi-platform support (16 platforms: Claude, Gemini, OpenAI, LangChain, LlamaIndex, Haystack, ChromaDB, FAISS, Weaviate, Qdrant, Cursor, Windsurf, Cline, Continue.dev, Pinecone, Markdown)
- ✅ Auto-upload to all platforms - ✅ Auto-upload to all platforms
- ✅ 24 preset configs (including 7 unified configs) - ✅ 24 preset configs (including 7 unified configs)
@@ -364,7 +364,7 @@ Small standalone tools that add value
- ✅ 17 source types supported - ✅ 17 source types supported
- ✅ 24 preset configs (14 official + 10 test/examples) - ✅ 24 preset configs (14 official + 10 test/examples)
- ✅ 1,880+ tests (excellent coverage) - ✅ 1,880+ tests (excellent coverage)
- ✅ 26+ MCP tools - ✅ 40 MCP tools
- ✅ 4 platform adaptors (Claude, Gemini, OpenAI, Markdown) - ✅ 4 platform adaptors (Claude, Gemini, OpenAI, Markdown)
- ✅ C3.x codebase analysis suite complete - ✅ C3.x codebase analysis suite complete
- ✅ Multi-source synthesis with generic merge for any combination - ✅ Multi-source synthesis with generic merge for any combination

2
docs/ARCHITECTURE.md
View File

@@ -103,7 +103,7 @@ docs/
**Files:** **Files:**
- `CLI_REFERENCE.md` - All CLI commands (including 17 source-type subcommands) - `CLI_REFERENCE.md` - All CLI commands (including 17 source-type subcommands)
- `MCP_REFERENCE.md` - 26+ MCP tools - `MCP_REFERENCE.md` - 40 MCP tools
- `CONFIG_FORMAT.md` - JSON schema (covers all 17 source types) - `CONFIG_FORMAT.md` - JSON schema (covers all 17 source types)
- `ENVIRONMENT_VARIABLES.md` - All env vars (including Confluence, Notion, Slack tokens) - `ENVIRONMENT_VARIABLES.md` - All env vars (including Confluence, Notion, Slack tokens)

6
docs/FAQ.md
View File

@@ -460,9 +460,9 @@ skill-seekers upload output/react-claude.zip --target claude
AI enhancement transforms basic skills (2-3/10 quality) into production-ready skills (8-9/10 quality) using LLMs. AI enhancement transforms basic skills (2-3/10 quality) into production-ready skills (8-9/10 quality) using LLMs.
**Two Modes:** **Two Modes (via AgentClient):**
1. **API Mode:** Direct Claude API calls (fast, costs ~$0.15-0.30) 1. **API Mode:** Multi-provider AI API calls -- Anthropic, Moonshot/Kimi, Gemini, OpenAI (fast, costs ~$0.15-0.30)
2. **LOCAL Mode:** Uses Claude Code CLI (free with your Max plan) 2. **LOCAL Mode:** Any supported coding agent -- Claude Code, Kimi, Codex, Copilot, OpenCode, or custom (free with agent subscription)
**What it improves:** **What it improves:**
- Better organization and structure - Better organization and structure

10
docs/UML_ARCHITECTURE.md
View File

@@ -15,9 +15,9 @@ Skill Seekers converts documentation from 17 source types into production-ready
- **Scrapers** -- 17 source-type extractors (web, GitHub, PDF, Word, EPUB, video, etc.) - **Scrapers** -- 17 source-type extractors (web, GitHub, PDF, Word, EPUB, video, etc.)
- **Adaptors** -- Strategy+Factory pattern for 20+ output platforms (Claude, Gemini, OpenAI, RAG frameworks) - **Adaptors** -- Strategy+Factory pattern for 20+ output platforms (Claude, Gemini, OpenAI, RAG frameworks)
- **Analysis** -- C3.x codebase analysis pipeline (AST parsing, 10 GoF pattern detectors, guide builders) - **Analysis** -- C3.x codebase analysis pipeline (AST parsing, 10 GoF pattern detectors, guide builders)
- **Enhancement** -- AI-powered skill improvement (API mode + LOCAL mode, --enhance-level 0-3) - **Enhancement** -- AI-powered skill improvement via `AgentClient` (API mode: Anthropic/Kimi/Gemini/OpenAI + LOCAL mode: Claude Code/Kimi/Codex/Copilot/OpenCode/custom, --enhance-level 0-3)
- **Packaging** -- Package, upload, and install skills to AI agent directories - **Packaging** -- Package, upload, and install skills to AI agent directories
- **MCP** -- FastMCP server exposing 34 tools via stdio/HTTP transport - **MCP** -- FastMCP server exposing 40 tools via stdio/HTTP transport (includes marketplace and config publishing)
- **Sync** -- Documentation change detection and re-scraping triggers - **Sync** -- Documentation change detection and re-scraping triggers
**Utility Modules** (lower area): **Utility Modules** (lower area):
@@ -52,7 +52,7 @@ Entry point: `skill-seekers` CLI. `CLIDispatcher` maps subcommands to modules vi
### Enhancement ### Enhancement
![Enhancement](UML/exports/05_enhancement.png) ![Enhancement](UML/exports/05_enhancement.png)
Two enhancement hierarchies: `AIEnhancer` (API mode, Claude API calls) and `UnifiedEnhancer` (C3.x pipeline enhancers). Each has specialized subclasses for patterns, test examples, guides, and configs. `WorkflowEngine` orchestrates multi-stage `EnhancementWorkflow`. Two enhancement hierarchies: `AIEnhancer` (API mode, multi-provider via `AgentClient`) and `UnifiedEnhancer` (C3.x pipeline enhancers). Each has specialized subclasses for patterns, test examples, guides, and configs. `WorkflowEngine` orchestrates multi-stage `EnhancementWorkflow`. The `AgentClient` (`cli/agent_client.py`) centralizes all AI invocations, supporting API mode (Anthropic, Moonshot/Kimi, Gemini, OpenAI) and LOCAL mode (Claude Code, Kimi Code, Codex, Copilot, OpenCode, custom agents).
### Packaging ### Packaging
![Packaging](UML/exports/06_packaging.png) ![Packaging](UML/exports/06_packaging.png)
@@ -62,7 +62,7 @@ Two enhancement hierarchies: `AIEnhancer` (API mode, Claude API calls) and `Unif
### MCP Server ### MCP Server
![MCP Server](UML/exports/07_mcp_server.png) ![MCP Server](UML/exports/07_mcp_server.png)
`SkillSeekerMCPServer` (FastMCP) with 34 tools in 8 categories. Supporting classes: `SourceManager` (config CRUD), `AgentDetector` (environment detection), `GitConfigRepo` (community configs). `SkillSeekerMCPServer` (FastMCP) with 40 tools in 10 categories. Supporting classes: `SourceManager` (config CRUD), `AgentDetector` (environment detection), `GitConfigRepo` (community configs), `MarketplacePublisher` (publish skills to marketplace repos), `MarketplaceManager` (marketplace registry CRUD), `ConfigPublisher` (push configs to registered source repos).
### Sync ### Sync
![Sync](UML/exports/08_sync.png) ![Sync](UML/exports/08_sync.png)
@@ -132,7 +132,7 @@ MCP Client (Claude Code/Cursor) → FastMCPServer (stdio/HTTP) with two invocati
### Enhancement Pipeline ### Enhancement Pipeline
![Enhancement Pipeline](UML/exports/18_enhancement_activity.png) ![Enhancement Pipeline](UML/exports/18_enhancement_activity.png)
`--enhance-level` decision flow with precise internal variable mapping: Level 0 sets `ai_mode=none`, skips all AI. Level ≥ 1 selects `ai_mode=api` (if `ANTHROPIC_API_KEY` set) or `ai_mode=local` (Claude Code CLI), then SKILL.md enhancement happens post-build via `enhance_command`. Level ≥ 2 enables `enhance_config=True`, `enhance_architecture=True` inside `analyze_codebase()`. Level 3 adds `enhance_patterns=True`, `enhance_tests=True`. `--enhance-level` decision flow with precise internal variable mapping: Level 0 sets `ai_mode=none`, skips all AI. Level >= 1 selects `ai_mode=api` (if any supported API key set: Anthropic, Moonshot/Kimi, Gemini, OpenAI) or `ai_mode=local` (via `AgentClient` with configurable agent: Claude Code, Kimi, Codex, Copilot, OpenCode, or custom), then SKILL.md enhancement happens post-build via `enhance_command`. Level >= 2 enables `enhance_config=True`, `enhance_architecture=True` inside `analyze_codebase()`. Level 3 adds `enhance_patterns=True`, `enhance_tests=True`.
### Runtime Components ### Runtime Components
![Runtime Components](UML/exports/19_runtime_components.png) ![Runtime Components](UML/exports/19_runtime_components.png)

5
docs/features/ENHANCEMENT_MODES.md
View File

@@ -20,6 +20,7 @@ All enhancement modes now support **multiple local coding agents**:
| Agent | Display Name | Default | Notes | | Agent | Display Name | Default | Notes |
|-------|--------------|---------|-------| |-------|--------------|---------|-------|
| **claude** | Claude Code | ✅ Yes | Your Claude Code Max plan (no API costs) | | **claude** | Claude Code | ✅ Yes | Your Claude Code Max plan (no API costs) |
| **kimi** | Kimi Code CLI | No | Uses `kimi --print` with stdin |
| **codex** | OpenAI Codex CLI | No | Uses `codex exec --full-auto` | | **codex** | OpenAI Codex CLI | No | Uses `codex exec --full-auto` |
| **copilot** | GitHub Copilot CLI | No | Uses `gh copilot chat` | | **copilot** | GitHub Copilot CLI | No | Uses `gh copilot chat` |
| **opencode** | OpenCode CLI | No | Uses `opencode` command | | **opencode** | OpenCode CLI | No | Uses `opencode` command |
@@ -101,6 +102,10 @@ Agent names are normalized with smart alias support:
# All resolve to "copilot" # All resolve to "copilot"
--agent copilot --agent copilot
--agent copilot-cli --agent copilot-cli
# All resolve to "kimi"
--agent kimi
--agent kimi-code
``` ```
## Mode Comparison ## Mode Comparison

33
docs/reference/MCP_REFERENCE.md
View File

@@ -1,8 +1,8 @@
# MCP Reference - Skill Seekers # MCP Reference - Skill Seekers
> **Version:** 3.2.0 > **Version:** 3.4.0
> **Last Updated:** 2026-03-15 > **Last Updated:** 2026-04-01
> **Complete reference for 27 MCP tools** > **Complete reference for 40 MCP tools**
--- ---
@@ -14,9 +14,11 @@
- [Starting the Server](#starting-the-server) - [Starting the Server](#starting-the-server)
- [Tool Categories](#tool-categories) - [Tool Categories](#tool-categories)
- [Core Tools (9)](#core-tools) - [Core Tools (9)](#core-tools)
- [Extended Tools (9)](#extended-tools) - [Extended Tools (10)](#extended-tools)
- [Config Source Tools (5)](#config-source-tools) - [Config Source Tools (5)](#config-source-tools)
- [Config Splitting Tools (2)](#config-splitting-tools) - [Config Splitting Tools (2)](#config-splitting-tools)
- [Config Publishing Tools (1)](#config-publishing-tools)
- [Marketplace Tools (4)](#marketplace-tools)
- [Vector Database Tools (4)](#vector-database-tools) - [Vector Database Tools (4)](#vector-database-tools)
- [Workflow Tools (5)](#workflow-tools) - [Workflow Tools (5)](#workflow-tools)
- [Tool Reference](#tool-reference) - [Tool Reference](#tool-reference)
@@ -87,14 +89,14 @@ Advanced scraping and analysis tools:
|------|---------| |------|---------|
| `scrape_github` | GitHub repository analysis | | `scrape_github` | GitHub repository analysis |
| `scrape_pdf` | PDF extraction | | `scrape_pdf` | PDF extraction |
| `scrape_video` | Video transcript extraction |
| `scrape_codebase` | Local codebase analysis | | `scrape_codebase` | Local codebase analysis |
| `scrape_generic` | Generic scraper for 10 new source types | | `scrape_generic` | Generic scraper for 10 new source types |
| `unified_scrape` | Multi-source scraping | | `sync_config` | Sync config from remote source |
| `detect_patterns` | Pattern detection | | `detect_patterns` | Pattern detection |
| `extract_test_examples` | Extract usage examples from tests | | `extract_test_examples` | Extract usage examples from tests |
| `build_how_to_guides` | Generate how-to guides | | `build_how_to_guides` | Generate how-to guides |
| `extract_config_patterns` | Extract configuration patterns | | `extract_config_patterns` | Extract configuration patterns |
| `detect_conflicts` | Find doc/code discrepancies |
### Config Source Tools (5) ### Config Source Tools (5)
@@ -117,6 +119,25 @@ Handle large documentation:
| `split_config` | Split large config | | `split_config` | Split large config |
| `generate_router` | Generate router skill | | `generate_router` | Generate router skill |
### Config Publishing Tools (1)
Push configs to registered source repositories:
| Tool | Purpose |
|------|---------|
| `push_config` | Push validated config to a registered config source repo |
### Marketplace Tools (4)
Manage plugin marketplace repositories:
| Tool | Purpose |
|------|---------|
| `add_marketplace` | Register a marketplace repository |
| `list_marketplaces` | List registered marketplaces |
| `remove_marketplace` | Remove a marketplace |
| `publish_to_marketplace` | Publish skill to a marketplace repo |
### Vector Database Tools (4) ### Vector Database Tools (4)
Export to vector databases: Export to vector databases:

30
docs/user-guide/03-enhancement.md
View File

@@ -39,11 +39,15 @@ Choose how much enhancement to apply:
### API Mode (Default if key available) ### API Mode (Default if key available)
Uses Claude API for fast enhancement. Uses any supported AI provider API via `AgentClient`. Providers: Anthropic (Claude), Moonshot/Kimi, Google Gemini, OpenAI.
**Requirements:** **Requirements:**
```bash ```bash
export ANTHROPIC_API_KEY=sk-ant-... # Any one of these activates API mode:
export ANTHROPIC_API_KEY=sk-ant-... # Claude
export MOONSHOT_API_KEY=... # Kimi
export GOOGLE_API_KEY=... # Gemini
export OPENAI_API_KEY=... # OpenAI
``` ```
**Usage:** **Usage:**
@@ -67,27 +71,33 @@ skill-seekers enhance output/my-skill/ --agent api
### LOCAL Mode (Default if no key) ### LOCAL Mode (Default if no key)
Uses Claude Code (free with Max plan). Uses a local AI coding agent via `AgentClient`. Supports Claude Code, Kimi Code, Codex, Copilot, OpenCode, or custom agents.
**Requirements:** **Requirements:**
- Claude Code installed - One of the supported agents installed (Claude Code, Codex, Copilot, OpenCode, Kimi)
- Claude Code Max subscription
**Usage:** **Usage:**
```bash ```bash
# Auto-detects LOCAL mode (no API key) # Auto-detects LOCAL mode (no API key), defaults to Claude Code
skill-seekers create <source> skill-seekers create <source>
# Explicit # Use a different local agent
skill-seekers enhance output/my-skill/ --agent local skill-seekers enhance output/my-skill/ --agent codex
skill-seekers enhance output/my-skill/ --agent copilot
skill-seekers enhance output/my-skill/ --agent kimi
skill-seekers enhance output/my-skill/ --agent opencode
# Custom agent
skill-seekers enhance output/my-skill/ --agent custom --agent-cmd "my-agent {prompt_file}"
``` ```
**Pros:** **Pros:**
- Free (with Claude Code Max) - Free (with agent subscription)
- Better quality (full context) - Better quality (full context)
- Agent-agnostic -- works with any supported coding agent
**Cons:** **Cons:**
- Requires Claude Code - Requires a local coding agent
- Slightly slower (~60-120 sec) - Slightly slower (~60-120 sec)
--- ---

30
src/skill_seekers/mcp/README.md
View File

@@ -82,7 +82,7 @@ You should see a list of preset configurations (Godot, React, Vue, etc.).
## Available Tools ## Available Tools
The MCP server exposes 18 tools: The MCP server exposes 40 tools (see `docs/reference/MCP_REFERENCE.md` for the full list). Key tools include:
### 1. `generate_config` ### 1. `generate_config`
Create a new configuration file for any documentation website. Create a new configuration file for any documentation website.
@@ -419,9 +419,27 @@ Agent: ✅ 6 skills packaged:
``` ```
mcp/ mcp/
├── server.py # Main MCP server ├── server_fastmcp.py # Main MCP server (FastMCP, 40 tools)
├── requirements.txt # MCP dependencies ├── server.py # Server entry point
└── README.md # This file ├── server_legacy.py # Legacy server
├── source_manager.py # Config source CRUD
├── agent_detector.py # Environment/agent detection
├── git_repo.py # Community config git repos
├── marketplace_publisher.py # Publish skills to marketplace repos
├── marketplace_manager.py # Marketplace registry management
├── config_publisher.py # Push configs to source repos
├── tools/ # Tool implementations by category
│ ├── config_tools.py
│ ├── marketplace_tools.py
│ ├── packaging_tools.py
│ ├── scraping_tools.py
│ ├── source_tools.py
│ ├── splitting_tools.py
│ ├── sync_config_tools.py
│ ├── vector_db_tools.py
│ └── workflow_tools.py
├── requirements.txt # MCP dependencies
└── README.md # This file
``` ```
### How It Works ### How It Works
@@ -500,13 +518,13 @@ python3 -m pytest tests/test_mcp_server.py -v
2. Verify server can start: 2. Verify server can start:
```bash ```bash
python3 mcp/server.py python3 -m skill_seekers.mcp.server_fastmcp
# Should start without errors (Ctrl+C to exit) # Should start without errors (Ctrl+C to exit)
``` ```
3. Check dependencies: 3. Check dependencies:
```bash ```bash
pip3 install -r mcp/requirements.txt pip3 install -e ".[mcp]"
``` ```
4. Completely restart your AI coding agent (quit and reopen) 4. Completely restart your AI coding agent (quit and reopen)