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:
yusyus
2026-01-17 19:51:11 +03:00
parent 6d4ef0f13b
commit 38e8969ae7
9 changed files with 553 additions and 22 deletions

View File

@@ -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.
---