f66718122a
**Planning Structure:** - TODO.md - Sprint planning and current tasks - ROADMAP.md - Long-term vision and milestones - .github/ISSUE_TEMPLATE/ - Issue templates for features and MCP tools **TODO.md:** - 5 phases: Core (done), Enhancement, Advanced, Docs, Integrations - Current sprint tasks clearly defined - Progress tracking with checkboxes **ROADMAP.md:** - Vision and milestones - v1.0 (done), v1.1 (in progress), v1.2-3.0 (planned) - Feature ideas categorized by priority - Metrics and goals - Release schedule **Issue Templates:** - feature_request.md - General features - mcp_tool.md - New MCP tools specifically Next: Fix tests, test MCP with Claude Code, document setup 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
190 lines
4.5 KiB
Markdown
190 lines
4.5 KiB
Markdown
# Skill Seeker Development Roadmap
|
|
|
|
## Vision
|
|
Transform Skill Seeker into the easiest way to create Claude AI skills from any documentation website, with both CLI and MCP interfaces.
|
|
|
|
---
|
|
|
|
## 🎯 Milestones
|
|
|
|
### ✅ v1.0 - Core CLI Tool (COMPLETED)
|
|
- [x] Documentation scraping with BFS
|
|
- [x] Smart categorization
|
|
- [x] Language detection
|
|
- [x] Pattern extraction
|
|
- [x] 6 preset configurations
|
|
- [x] Comprehensive test suite (71 tests)
|
|
|
|
### 🚧 v1.1 - MCP Integration (IN PROGRESS)
|
|
**Goal:** Enable Claude Code to generate skills directly
|
|
**Timeline:** Week of Oct 19-26
|
|
|
|
**Tasks:**
|
|
- [x] Monorepo refactor (cli/ and mcp/)
|
|
- [x] MCP server skeleton with 6 tools
|
|
- [x] Basic tool implementations
|
|
- [ ] Fix remaining test failures
|
|
- [ ] Test with actual Claude Code
|
|
- [ ] MCP documentation and examples
|
|
- [ ] Release announcement
|
|
|
|
**Deliverables:**
|
|
- Working MCP server
|
|
- Setup guide for Claude Code
|
|
- Example workflows
|
|
|
|
---
|
|
|
|
### 📋 v1.2 - Enhanced MCP Features (PLANNED)
|
|
**Goal:** Make MCP tools more powerful and user-friendly
|
|
**Timeline:** Nov 2025
|
|
|
|
**Features:**
|
|
- Interactive config wizard via MCP
|
|
- Real-time progress updates
|
|
- Auto-detect documentation patterns
|
|
- Parallel terminal enhancement support
|
|
- Batch operations
|
|
|
|
**Use Cases:**
|
|
- "Auto-configure for Next.js docs"
|
|
- "Generate configs for: React, Vue, Svelte"
|
|
- "Show progress while scraping"
|
|
|
|
---
|
|
|
|
### 📋 v2.0 - Intelligence Layer (PLANNED)
|
|
**Goal:** Smart defaults and auto-configuration
|
|
**Timeline:** Dec 2025
|
|
|
|
**Features:**
|
|
- **Auto-detection:**
|
|
- Automatically find best selectors
|
|
- Detect documentation framework (Docusaurus, GitBook, etc.)
|
|
- Suggest optimal rate_limit and max_pages
|
|
|
|
- **Quality Metrics:**
|
|
- Analyze generated SKILL.md quality
|
|
- Suggest improvements
|
|
- Validate code examples
|
|
|
|
- **Templates:**
|
|
- Pre-built configs for popular frameworks
|
|
- Community config sharing
|
|
- One-click generation for common docs
|
|
|
|
**Example:**
|
|
```
|
|
User: "Create skill from https://tailwindcss.com/docs"
|
|
Tool: Auto-detects Tailwind, uses template, generates in 30 seconds
|
|
```
|
|
|
|
---
|
|
|
|
### 💭 v3.0 - Platform Features (IDEAS)
|
|
**Goal:** Build ecosystem around skill generation
|
|
|
|
**Possible Features:**
|
|
- Web UI for config generation
|
|
- GitHub Actions integration
|
|
- Skill marketplace
|
|
- Analytics dashboard
|
|
- API for programmatic access
|
|
|
|
---
|
|
|
|
## 🎨 Feature Ideas
|
|
|
|
### High Priority
|
|
1. **Selector Auto-Detection** - Analyze page, suggest selectors
|
|
2. **Progress Streaming** - Real-time updates during scraping
|
|
3. **Config Validation UI** - Visual feedback on config quality
|
|
4. **Batch Processing** - Handle multiple sites at once
|
|
|
|
### Medium Priority
|
|
5. **Skill Quality Score** - Rate generated skills
|
|
6. **Enhanced SKILL.md** - Better templates, more examples
|
|
7. **Documentation Framework Detection** - Auto-detect Docusaurus, VuePress, etc.
|
|
8. **Custom Categories AI** - Use AI to suggest categories
|
|
|
|
### Low Priority
|
|
9. **Web Dashboard** - Browser-based interface
|
|
10. **Skill Analytics** - Track usage, quality metrics
|
|
11. **Community Configs** - Share and discover configs
|
|
12. **Plugin System** - Extend with custom scrapers
|
|
|
|
---
|
|
|
|
## 🔬 Research Areas
|
|
|
|
### MCP Enhancements
|
|
- [ ] Investigate MCP progress/streaming APIs
|
|
- [ ] Test MCP with large documentation sites
|
|
- [ ] Explore MCP caching strategies
|
|
|
|
### AI Integration
|
|
- [ ] Use Claude to auto-generate categories
|
|
- [ ] AI-powered selector detection
|
|
- [ ] Quality analysis with LLMs
|
|
|
|
### Performance
|
|
- [ ] Parallel scraping
|
|
- [ ] Incremental updates
|
|
- [ ] Smart caching
|
|
|
|
---
|
|
|
|
## 📊 Metrics & Goals
|
|
|
|
### Current State (Oct 2025)
|
|
- ✅ 7 preset configs
|
|
- ✅ 71 tests (95.8% passing)
|
|
- ✅ 6 MCP tools
|
|
- ✅ ~2500 lines of code
|
|
|
|
### Goals for v1.1
|
|
- 🎯 100% test pass rate
|
|
- 🎯 5+ users testing MCP
|
|
- 🎯 10+ documentation sites tested
|
|
- 🎯 <5 minute setup time
|
|
|
|
### Goals for v2.0
|
|
- 🎯 50+ preset configs
|
|
- 🎯 Auto-detection for 80%+ of sites
|
|
- 🎯 <1 minute skill generation
|
|
- 🎯 Community contributions
|
|
|
|
---
|
|
|
|
## 🤝 Contributing
|
|
|
|
See [CONTRIBUTING.md](CONTRIBUTING.md) for:
|
|
- How to add new MCP tools
|
|
- Testing guidelines
|
|
- Code style
|
|
- PR process
|
|
|
|
---
|
|
|
|
## 📅 Release Schedule
|
|
|
|
| Version | Target Date | Focus |
|
|
|---------|-------------|-------|
|
|
| v1.0 | Oct 15, 2025 | Core CLI ✅ |
|
|
| v1.1 | Oct 26, 2025 | MCP Integration 🚧 |
|
|
| v1.2 | Nov 2025 | Enhanced MCP 📋 |
|
|
| v2.0 | Dec 2025 | Intelligence 💭 |
|
|
| v3.0 | Q1 2026 | Platform 💭 |
|
|
|
|
---
|
|
|
|
## 🔗 Related Projects
|
|
|
|
- [Model Context Protocol](https://modelcontextprotocol.io/)
|
|
- [Claude Code](https://claude.ai/code)
|
|
- Documentation frameworks we support
|
|
|
|
---
|
|
|
|
**Last Updated:** October 19, 2025
|