# Skill Jangler Development Roadmap

## Vision
Transform Skill Jangler 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
