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>
4.5 KiB
4.5 KiB
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)
- Documentation scraping with BFS
- Smart categorization
- Language detection
- Pattern extraction
- 6 preset configurations
- 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:
- Monorepo refactor (cli/ and mcp/)
- MCP server skeleton with 6 tools
- 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
- Selector Auto-Detection - Analyze page, suggest selectors
- Progress Streaming - Real-time updates during scraping
- Config Validation UI - Visual feedback on config quality
- Batch Processing - Handle multiple sites at once
Medium Priority
- Skill Quality Score - Rate generated skills
- Enhanced SKILL.md - Better templates, more examples
- Documentation Framework Detection - Auto-detect Docusaurus, VuePress, etc.
- Custom Categories AI - Use AI to suggest categories
Low Priority
- Web Dashboard - Browser-based interface
- Skill Analytics - Track usage, quality metrics
- Community Configs - Share and discover configs
- 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 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
- Claude Code
- Documentation frameworks we support
Last Updated: October 19, 2025