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

2
docs/ARCHITECTURE.md
View File

@@ -103,7 +103,7 @@ docs/
**Files:**
- `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)
- `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.
**Two Modes:**
1. **API Mode:** Direct Claude API calls (fast, costs ~$0.15-0.30)
2. **LOCAL Mode:** Uses Claude Code CLI (free with your Max plan)
**Two Modes (via AgentClient):**
1. **API Mode:** Multi-provider AI API calls -- Anthropic, Moonshot/Kimi, Gemini, OpenAI (fast, costs ~$0.15-0.30)
2. **LOCAL Mode:** Any supported coding agent -- Claude Code, Kimi, Codex, Copilot, OpenCode, or custom (free with agent subscription)
**What it improves:**
- 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.)
- **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)
- **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
- **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
**Utility Modules** (lower area):
@@ -52,7 +52,7 @@ Entry point: `skill-seekers` CLI. `CLIDispatcher` maps subcommands to modules vi
### Enhancement
![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](UML/exports/06_packaging.png)
@@ -62,7 +62,7 @@ Two enhancement hierarchies: `AIEnhancer` (API mode, Claude API calls) and `Unif
### MCP Server
![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](UML/exports/08_sync.png)
@@ -132,7 +132,7 @@ MCP Client (Claude Code/Cursor) → FastMCPServer (stdio/HTTP) with two invocati
### Enhancement Pipeline
![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](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 |
|-------|--------------|---------|-------|
| **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` |
| **copilot** | GitHub Copilot CLI | No | Uses `gh copilot chat` |
| **opencode** | OpenCode CLI | No | Uses `opencode` command |
@@ -101,6 +102,10 @@ Agent names are normalized with smart alias support:
# All resolve to "copilot"
--agent copilot
--agent copilot-cli
# All resolve to "kimi"
--agent kimi
--agent kimi-code
```
## Mode Comparison

33
docs/reference/MCP_REFERENCE.md
View File

@@ -1,8 +1,8 @@
# MCP Reference - Skill Seekers
> **Version:** 3.2.0
> **Last Updated:** 2026-03-15
> **Complete reference for 27 MCP tools**
> **Version:** 3.4.0
> **Last Updated:** 2026-04-01
> **Complete reference for 40 MCP tools**
---
@@ -14,9 +14,11 @@
- [Starting the Server](#starting-the-server)
- [Tool Categories](#tool-categories)
- [Core Tools (9)](#core-tools)
- [Extended Tools (9)](#extended-tools)
- [Extended Tools (10)](#extended-tools)
- [Config Source Tools (5)](#config-source-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)
- [Workflow Tools (5)](#workflow-tools)
- [Tool Reference](#tool-reference)
@@ -87,14 +89,14 @@ Advanced scraping and analysis tools:
|------|---------|
| `scrape_github` | GitHub repository analysis |
| `scrape_pdf` | PDF extraction |
| `scrape_video` | Video transcript extraction |
| `scrape_codebase` | Local codebase analysis |
| `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 |
| `extract_test_examples` | Extract usage examples from tests |
| `build_how_to_guides` | Generate how-to guides |
| `extract_config_patterns` | Extract configuration patterns |
| `detect_conflicts` | Find doc/code discrepancies |
### Config Source Tools (5)
@@ -117,6 +119,25 @@ Handle large documentation:
| `split_config` | Split large config |
| `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)
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)
Uses Claude API for fast enhancement.
Uses any supported AI provider API via `AgentClient`. Providers: Anthropic (Claude), Moonshot/Kimi, Google Gemini, OpenAI.
**Requirements:**
```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:**
@@ -67,27 +71,33 @@ skill-seekers enhance output/my-skill/ --agent api
### 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:**
- Claude Code installed
- Claude Code Max subscription
- One of the supported agents installed (Claude Code, Codex, Copilot, OpenCode, Kimi)
**Usage:**
```bash
# Auto-detects LOCAL mode (no API key)
# Auto-detects LOCAL mode (no API key), defaults to Claude Code
skill-seekers create <source>
# Explicit
skill-seekers enhance output/my-skill/ --agent local
# Use a different local agent
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:**
- Free (with Claude Code Max)
- Free (with agent subscription)
- Better quality (full context)
- Agent-agnostic -- works with any supported coding agent
**Cons:**
- Requires Claude Code
- Requires a local coding agent
- Slightly slower (~60-120 sec)
---