feat: Merge PR #249 - Bootstrap skill with fixes and MCP optionality
Merged PR #249 from @MiaoDX with enhancements: Bootstrap Feature: - Self-bootstrap: Generate skill-seekers as Claude Code skill - Robust frontmatter detection (dynamic line finding) - SKILL.md validation (YAML + Markdown structure) - Comprehensive error handling (uv check, permission checks) - 6 E2E tests with venv isolation MCP Optionality (User Feature): - MCP removed from core dependencies - Optional install: pip install skill-seekers[mcp] - Lazy loading with helpful error messages - Interactive setup wizard on first run - Backward compatible Bug Fixes: - Fixed codebase_scraper.py AttributeError (line 1193) - Fixed test_bootstrap_skill_e2e.py Path vs str issue - Updated test version expectations to 2.7.0 - Added httpx to core (required for async scraping) - Added anthropic to core (required for AI enhancement) Testing: - 6 new bootstrap E2E tests (all passing) - 1207/1217 tests passing (99.2% pass rate) - All bootstrap and enhancement tests pass - Remaining failures are pre-existing test infrastructure issues Documentation: - Updated CHANGELOG.md with v2.7.0 notes - Updated README.md with bootstrap and installation options - Added setup wizard guide Files Modified (9): - CHANGELOG.md, README.md - Documentation updates - pyproject.toml - MCP optional, httpx/anthropic core, markers, entry points - scripts/bootstrap_skill.sh - Dynamic frontmatter, validation, error handling - src/skill_seekers/cli/install_skill.py - Lazy MCP loading - tests/test_cli_paths.py - Version 2.7.0 - uv.lock - Dependency updates New Files (2): - src/skill_seekers/cli/setup_wizard.py - Interactive installation guide (95 lines) - tests/test_bootstrap_skill_e2e.py - E2E bootstrap tests (169 lines) Credits: @MiaoDX for PR #249 Co-Authored-By: MiaoDX <MiaoDX@hotmail.com> Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
78
README.md
78
README.md
@@ -220,6 +220,37 @@ skill-seekers resume github_react_20260117_143022
|
||||
|
||||
**See complete documentation**: [Configuration Guide](docs/guides/CONFIGURATION.md) (coming soon)
|
||||
|
||||
### 🎯 Bootstrap Skill - Self-Hosting (**NEW - v2.7.0**)
|
||||
|
||||
Generate skill-seekers as a Claude Code skill to use within Claude:
|
||||
|
||||
```bash
|
||||
# Generate the skill
|
||||
./scripts/bootstrap_skill.sh
|
||||
|
||||
# Install to Claude Code
|
||||
cp -r output/skill-seekers ~/.claude/skills/
|
||||
|
||||
# Verify
|
||||
ls ~/.claude/skills/skill-seekers/SKILL.md
|
||||
```
|
||||
|
||||
**What you get:**
|
||||
- ✅ **Complete skill documentation** - All CLI commands and usage patterns
|
||||
- ✅ **CLI command reference** - Every tool and its options documented
|
||||
- ✅ **Quick start examples** - Common workflows and best practices
|
||||
- ✅ **Auto-generated API docs** - Code analysis, patterns, and examples
|
||||
- ✅ **Robust validation** - YAML frontmatter and required fields checked
|
||||
- ✅ **One-command bootstrap** - Combines manual header with auto-generated analysis
|
||||
|
||||
**How it works:**
|
||||
1. Runs codebase analysis on skill-seekers itself (dogfooding!)
|
||||
2. Combines handcrafted header (prerequisites, commands) with auto-generated content
|
||||
3. Validates SKILL.md structure (frontmatter, required fields)
|
||||
4. Outputs ready-to-use skill directory
|
||||
|
||||
**Result:** Use skill-seekers to create skills, from within Claude Code!
|
||||
|
||||
### 🔐 Private Config Repositories (**NEW - v2.2.0**)
|
||||
- ✅ **Git-Based Config Sources** - Fetch configs from private/team git repositories
|
||||
- ✅ **Multi-Source Management** - Register unlimited GitHub, GitLab, Bitbucket repos
|
||||
@@ -297,6 +328,53 @@ skill-seekers-codebase tests/ --build-how-to-guides --ai-mode none
|
||||
pip install skill-seekers
|
||||
```
|
||||
|
||||
### Installation Options
|
||||
|
||||
Choose your installation profile based on which features you need:
|
||||
|
||||
```bash
|
||||
# 1️⃣ CLI Only (Skill Generation)
|
||||
pip install skill-seekers
|
||||
|
||||
# Features:
|
||||
# • Scrape documentation websites
|
||||
# • Analyze GitHub repositories
|
||||
# • Extract from PDFs
|
||||
# • Package skills for all platforms
|
||||
|
||||
# 2️⃣ MCP Integration (Claude Code, Cursor, Windsurf)
|
||||
pip install skill-seekers[mcp]
|
||||
|
||||
# Features:
|
||||
# • Everything from CLI Only
|
||||
# • MCP server for Claude Code
|
||||
# • One-command skill installation
|
||||
# • HTTP/stdio transport modes
|
||||
|
||||
# 3️⃣ Multi-LLM Support (Gemini, OpenAI)
|
||||
pip install skill-seekers[all-llms]
|
||||
|
||||
# Features:
|
||||
# • Everything from CLI Only
|
||||
# • Google Gemini support
|
||||
# • OpenAI ChatGPT support
|
||||
# • Enhanced AI features
|
||||
|
||||
# 4️⃣ Everything
|
||||
pip install skill-seekers[all]
|
||||
|
||||
# Features:
|
||||
# • All features enabled
|
||||
# • Maximum flexibility
|
||||
```
|
||||
|
||||
**Need help choosing?** Run the setup wizard:
|
||||
```bash
|
||||
skill-seekers-setup
|
||||
```
|
||||
|
||||
The wizard shows all options with detailed feature lists and guides you through configuration.
|
||||
|
||||
Get started in seconds. No cloning, no setup - just install and run. See installation options below.
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user