<div align="center">
# 🔨 SkillForge
**Meta-Programming Framework for Claude Code**
Transform Claude Code from a generic AI assistant into an expert team member who knows YOUR stack, YOUR conventions, and YOUR patterns.
[]()
[]()
[]()
[]()
[]()
[](https://pypi.org/project/skillforge/)
[Features](#-features) • [Why SkillForge](#-why-skillforge) • [Installation](#-installation) • [Quick Start](#-quick-start) • [Documentation](#-documentation) • [Contributing](#-contributing)
</div>
---
## 📋 Table of Contents
- [What is SkillForge?](#-what-is-skillforge)
- [Why SkillForge?](#-why-skillforge)
- [Features](#-features)
- [How It Works](#-how-it-works)
- [Installation](#-installation)
- [Quick Start](#-quick-start)
- [Usage](#-usage)
- [Architecture](#-architecture)
- [Roadmap](#-roadmap)
- [Contributing](#-contributing)
- [FAQ](#-faq)
- [License](#-license)
---
## 🎯 What is SkillForge?
SkillForge is an intelligent meta-programming framework that extends Claude Code's native skill system. It automatically generates, orchestrates, and continuously improves personalized skills tailored to YOUR development workflow.
**In one sentence:** SkillForge turns Claude Code into an expert developer who codes exactly the way YOU do, using YOUR stack, YOUR conventions, and YOUR patterns.
### The Problem
Claude Code's native skills are powerful but generic:
- ❌ Don't know YOUR tech stack (Next.js? FastAPI? Supabase?)
- ❌ Don't know YOUR conventions (camelCase? Absolute imports? Feature-based structure?)
- ❌ Don't learn from YOUR patterns (Always use Zod? Prefer server actions?)
- ❌ No intelligent orchestration (Claude must guess which skills to load)
- ❌ Static and never improve over time
### The Solution
```
┌─────────────────────────────────────────────────────┐
│ SkillForge │
├─────────────────────────────────────────────────────┤
│ │
│ Generator → Creates personalized skills │
│ Orchestrator → Loads the right skills smartly │
│ Learner → Learns from your usage patterns │
│ Optimizer → Improves skills continuously │
│ │
└─────────────────────────────────────────────────────┘
↓
~/.claude/skills/
├── nextjs-fullstack/ ← YOUR Next.js patterns
├── supabase-integration/ ← YOUR auth setup
└── git-workflow/ ← YOUR commit style
```
---
## 💡 Why SkillForge?
### Without SkillForge
```
You: "Create a login component with Supabase auth"
Claude Code:
├─ Uses generic knowledge (possibly outdated)
├─ Doesn't know if you use App Router or Pages Router
├─ Doesn't know your UI library (Tailwind? Material UI?)
├─ Doesn't know your state management (Zustand? Redux?)
├─ Generates generic code
Result: OK code, but you need 15-30 minutes to:
├─ Fix naming conventions
├─ Adjust import paths
├─ Modify styling approach
├─ Adapt to your patterns
└─ 🕐 Time wasted: 15-30 minutes
```
### With SkillForge
```
You: "Create a login component with Supabase auth"
SkillForge (invisible, in milliseconds):
├─ Analyzes intent: "login component, Supabase, auth"
├─ Identifies skills: nextjs-fullstack + supabase-integration
├─ Loads YOUR personalized skills
└─ Claude receives perfect context
Claude Code generates:
├─ Next.js 15 App Router (you use this)
├─ Shadcn/ui components (your UI library)
├─ Zustand store (your state management)
├─ @/ import aliases (your convention)
├─ camelCase naming (your convention)
├─ Zod validation (learned pattern after 20+ uses)
├─ Error boundary wrapper (learned pattern)
└─ Feature-based structure (your preference)
Result: Production-ready code, 0 modifications needed ✅
🚀 Time saved: 100%
```
---
## ✨ Features
### 🎨 Smart Skill Generation
- **Interactive Wizard**: Answer questions about YOUR preferences (naming, imports, patterns)
- **Template System**: Pre-built templates for popular stacks (Next.js, Vue, React, FastAPI, etc.)
- **Documentation Fetching**: Auto-fetches latest docs via Context7 MCP
- **Convention Injection**: Every generated skill includes YOUR personal conventions
### 🧠 Intelligent Orchestration
- **Intent Analysis**: Understands what you're trying to do
- **Smart Loading**: Loads only relevant skills with token optimization
- **Progressive Disclosure**: Loads metadata → core → full content as needed
- **Dependency Management**: Automatically loads related skills
### 📊 Pattern Learning
- **Usage Tracking**: Tracks every skill usage and outcome
- **Pattern Detection**: Identifies YOUR recurring patterns (confidence-based)
- **Auto-Application**: Updates skills when patterns reach 80%+ confidence
- **Cross-Project Learning**: Learns from ALL your projects simultaneously
### ⚡ Continuous Optimization
- **Token Reduction**: Compresses verbose content without losing meaning
- **Redundancy Detection**: Identifies overlapping skills and suggests merges
- **Documentation Updates**: Auto-updates with latest library versions
- **Unused Skill Detection**: Suggests removal of rarely-used skills
---
## 🏗️ How It Works
### Architecture Overview
```
┌──────────────────────────────────────────────────────────┐
│ User Profile │
│ (YOUR preferences, global) │
│ ~/.claude/skills/skillforge/data/user_profile.json │
│ │
│ - Naming conventions (camelCase, PascalCase) │
│ - Import style (absolute with @/) │
│ - Preferred libraries (Zustand, Zod, React Query) │
│ - Code patterns (feature-based structure) │
│ - Workflow (conventional commits) │
└──────────────────────────────────────────────────────────┘
↓
Injected into every skill
↓
┌──────────────────────────────────────────────────────────┐
│ Generated Skills │
│ (Tech-specific + YOUR preferences) │
│ ~/.claude/skills/ │
│ │
│ nextjs-fullstack/ │
│ ├─ SKILL.md ← Next.js patterns + YOUR prefs │
│ ├─ templates/ ← Code templates │
│ └─ docs/ ← Reference docs │
│ │
│ supabase-integration/ │
│ └─ SKILL.md ← Supabase setup + YOUR prefs │
└──────────────────────────────────────────────────────────┘
↓
Used at runtime per project
↓
┌──────────────────────────────────────────────────────────┐
│ Runtime (Per Project) │
│ │
│ Project A: Next.js 15 + Supabase │
│ ├─ Loads: nextjs-fullstack + supabase-integration │
│ └─ Applies: YOUR conventions to THIS project stack │
│ │
│ Project B: Vue.js + Firebase │
│ ├─ Loads: vue-spa + firebase-integration │
│ └─ Applies: YOUR conventions to THIS project stack │
└──────────────────────────────────────────────────────────┘
```
### The Four Core Components
#### 1. Generator
Creates personalized skills from templates + latest documentation + YOUR preferences.
```python
User answers wizard questions
↓
Fetch latest docs (Context7)
↓
Process template with YOUR preferences
↓
Generate SKILL.md (2000+ lines)
```
#### 2. Orchestrator
Intelligently selects and loads the right skills for each request.
```python
Analyze user request
↓
Identify relevant skills
↓
Calculate token budget
↓
Progressive loading (metadata → core → full)
↓
Claude executes with perfect context
```
#### 3. Learner
Detects patterns in your usage and updates skills automatically.
```python
Track every usage
↓
After 10+ uses, detect patterns
↓
If confidence ≥ 80%, apply pattern
↓
Update skills automatically
↓
Notify user of learned pattern
```
#### 4. Optimizer
Continuously improves skills for performance and quality.
```python
Analyze all skills weekly
↓
Find optimization opportunities:
├─ Token reduction
├─ Redundancy removal
├─ Documentation updates
└─ Unused skills
↓
Apply optimizations (with user approval)
```
---
## 📦 Installation
### Prerequisites
- Python 3.11 or higher
- [Claude Code](https://docs.claude.com/en/docs/claude-code) installed
- pipx (recommended) or pip
### Install SkillForge
```bash
# Install globally using pipx (recommended)
pipx install skillforge
# Or using pip
pip install skillforge
```
### Initialize
```bash
# Initialize SkillForge in Claude Code
skillforge install
```
This creates the SkillForge directory structure in `~/.claude/skills/skillforge/`.
---
## 🚀 Quick Start
### 1. Run the Setup Wizard
Open Claude Code in your most representative project:
```bash
cd ~/projects/my-main-project
claude
```
In Claude Code, run the wizard:
```
> /sf:wizard
```
The wizard will:
1. ✅ Ask about YOUR personal preferences (naming, imports, patterns)
2. ✅ Detect your current project's tech stack (if applicable)
3. ✅ Fetch latest documentation for your technologies
4. ✅ Generate personalized skills in `~/.claude/skills/`
**Example wizard session:**
```
╔════════════════════════════════════════════════╗
║ 🧙 SkillForge Setup Wizard ║
║ Building YOUR personal development profile ║
╚════════════════════════════════════════════════╝
🔍 Auto-detecting from current directory...
/Users/you/projects/my-nextjs-app
✅ Detected:
├─ Next.js 15.0.0
├─ TypeScript 5.3
├─ Tailwind CSS
└─ Supabase
Use these as defaults? [Y/n] Y
Great! Let me ask a few more questions about YOUR preferences...
1️⃣ YOUR naming convention for variables?
[1] camelCase
[2] snake_case
> 1
2️⃣ YOUR import style?
[1] Absolute imports with alias (@/...)
[2] Relative imports (../../...)
> 1
3️⃣ YOUR preferred state management?
[1] Zustand
[2] Redux Toolkit
[3] Context API
> 1
... (8-10 more questions) ...
╔════════════════════════════════════════════════╗
║ ⚙️ Generating Skills... ║
╚════════════════════════════════════════════════╝
[1/3] 📦 Fetching Next.js documentation...
└─ ✅ Documentation fetched (Context7)
[2/3] 🔨 Generating nextjs-fullstack skill...
├─ Processing template
├─ Injecting YOUR preferences
├─ Creating SKILL.md (2341 lines)
└─ ✅ Skill generated
[3/3] 🔨 Generating supabase-integration skill...
└─ ✅ Skill generated
✅ Setup Complete!
Skills installed:
~/.claude/skills/
├─ nextjs-fullstack/
├─ supabase-integration/
└─ git-workflow/
Your skills will improve as you use them!
```
### 2. Use Claude Code Normally
SkillForge works invisibly in the background:
```
You: "Create a login component with Supabase auth"
[SkillForge automatically loads your personalized skills]
Claude Code: [generates perfect code using YOUR conventions]
```
### 3. Generate Additional Skills
When you work on projects with different stacks:
```
> /sf:generate vue-spa
> /sf:generate firebase-integration
> /sf:generate python-fastapi
```
---
## 📖 Usage
### Available Commands
#### Core Commands
```bash
# Run the setup wizard (first time or update)
> /sf:wizard
# Generate a specific skill
> /sf:generate <skill-name>
# Generate skill from current project
> /sf:generate --from-current
# List all installed skills
> /sf:list
# View SkillForge status
> /sf:status
```
#### Analysis & Optimization
```bash
# Analyze skills and usage patterns
> /sf:analyze
# Optimize existing skills
> /sf:optimize
# Update skills with latest documentation
> /sf:update <skill-name>
> /sf:update --all
# Check for available updates
> /sf:update --check
```
#### Debug & Introspection
```bash
# Debug orchestration decisions
> /sf:introspect --orchestration
# Debug pattern learning
> /sf:introspect --learning
```
### Skill Templates
SkillForge includes templates for popular stacks:
**Frontend:**
- `nextjs-fullstack` - Next.js App Router full-stack
- `nextjs-pages` - Next.js Pages Router
- `react-vite` - React + Vite SPA
- `vue-spa` - Vue.js 3 + Vite
- `svelte-kit` - SvelteKit
**Backend:**
- `python-fastapi` - FastAPI backend
- `python-django` - Django
- `node-express` - Express.js
**Integration:**
- `supabase-integration` - Supabase (auth, db, storage)
- `firebase-integration` - Firebase
- `postgresql-integration` - PostgreSQL
- `mongodb-integration` - MongoDB
**Workflow:**
- `git-workflow` - Git conventions & commit style
- `testing-vitest` - Vitest testing
- `testing-jest` - Jest testing
---
## 🔧 Configuration
### User Profile Structure
Your preferences are stored in `~/.claude/skills/skillforge/data/user_profile.json`:
```json
{
"version": "1.0",
"preferences": {
"naming": {
"variables": "camelCase",
"components": "PascalCase",
"constants": "UPPER_SNAKE_CASE"
},
"imports": {
"style": "absolute",
"alias": "@/"
},
"technologies": {
"state_management": "Zustand",
"validation": "Zod",
"testing": "Vitest"
},
"patterns": {
"folder_structure": "feature-based",
"component_style": "functional",
"async_handling": "async/await"
},
"workflow": {
"git_commits": "conventional"
}
}
}
```
### Manual Editing
You can manually edit your profile:
```bash
# Edit profile
code ~/.claude/skills/skillforge/data/user_profile.json
# Regenerate skills with new preferences
> /sf:wizard --update
```
---
## 🏛️ Architecture
### Directory Structure
```
~/.claude/skills/skillforge/
│
├── SKILL.md # Entry point (meta-skill)
│
├── core/ # Behavioral files
│ ├── SKILLFORGE.md # Core configuration
│ ├── ORCHESTRATION.md # Orchestration logic
│ ├── GENERATOR.md # Generation system
│ ├── PATTERNS.md # Pattern learning
│ └── MCP_INTEGRATION.md # MCP integrations
│
├── generators/ # Python generators
│ ├── wizard_engine.py # Interactive wizard
│ ├── skill_generator.py # Skill generator
│ └── doc_fetcher.py # Context7 integration
│
├── analyzers/ # Intelligence
│ ├── intent_analyzer.py # Analyze requests
│ ├── skill_discovery.py # Find relevant skills
│ ├── pattern_detector.py # Detect patterns
│ └── skill_optimizer.py # Optimize skills
│
├── templates/ # Skill templates
│ ├── tech-stack/
│ │ ├── nextjs-fullstack.template
│ │ ├── react-spa.template
│ │ └── python-api.template
│ └── workflow/
│ └── git-workflow.template
│
└── data/ # Persistent data
├── user_profile.json # Your preferences
├── usage_analytics.json # Usage stats
└── learned_patterns.json # Learned patterns
```
### Integration with Claude Code
SkillForge extends Claude Code's native skill system:
```
Claude Code loads skills from ~/.claude/skills/
When you make a request:
1. SkillForge analyzes intent
2. Identifies relevant skills
3. Loads them with token optimization
4. Claude receives perfect context
5. SkillForge tracks usage for learning
```
### MCP Integration (Context7)
SkillForge uses [Context7](https://github.com/context-labs/context7) MCP server to fetch up-to-date documentation:
```python
# Fetch latest Next.js docs
docs = context7_get_library_docs(
library_id="/vercel/next.js",
topic="App Router",
tokens=2000
)
# Extract and use in skill generation
best_practices = extract_best_practices(docs)
code_examples = extract_code_examples(docs)
```
---
## 🗺️ Roadmap
**Current Status**: v1.0.0 Production Release 🚀
### ✅ Phase 1-10: Complete (100%)
**Foundation & Core Systems**
- [x] Core architecture design
- [x] Complete briefing documentation
- [x] Generator implementation (WizardEngine, SkillGenerator, TemplateProcessor, DocFetcher)
- [x] Orchestrator implementation (IntentAnalyzer, SkillDiscovery)
- [x] Learner implementation (UsageTracker, PatternDetector, LearningPipeline)
- [x] Optimizer implementation (SkillOptimizer)
**User Interface & Commands**
- [x] Slash commands system (10 commands: /sf:wizard, /sf:generate, /sf:analyze, etc.)
- [x] Visual output system (VERBOSE, COMPACT, SILENT modes)
- [x] Beautiful installation experience
**Quality & Testing**
- [x] Comprehensive test suite (unit, integration, e2e)
- [x] Test coverage implementation
- [x] Performance optimization
**Documentation & Release**
- [x] Complete user documentation
- [x] API documentation
- [x] README and guides
- [x] Package published to PyPI
- [x] Installation scripts
- [x] Production-ready v1.0.0
### 🔮 Future Enhancements (Post v1.0)
- [ ] Additional framework templates (Vue, Angular, FastAPI, Django)
- [ ] Web UI for skill management
- [ ] Skill marketplace for sharing and collaboration
- [ ] Advanced analytics dashboard
- [ ] Multi-project skill sharing
- [ ] Team collaboration features
- [ ] Import/export profiles
- [ ] CI/CD integration hooks
- [ ] IDE extensions (VSCode, JetBrains)
---
## 🤝 Contributing
SkillForge is in **production** (v1.0.0) and we welcome contributions!
### Ways to Contribute
- 🐛 **Report bugs**: [Open an issue](https://github.com/yourusername/skillforge/issues)
- 💡 **Suggest features**: [Start a discussion](https://github.com/yourusername/skillforge/discussions)
- 📝 **Improve docs**: Submit documentation PRs
- 🔨 **Add templates**: Contribute skill templates for new stacks
- 🧪 **Test**: Try SkillForge and provide feedback
### Development Setup
```bash
# Clone repository
git clone https://github.com/yourusername/skillforge.git
cd skillforge
# Create virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -e ".[dev]"
# Run tests
pytest
# Run linter
ruff check .
```
### Contribution Guidelines
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit changes (`git commit -m 'feat: add amazing feature'`)
4. Push to branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
Please follow [Conventional Commits](https://www.conventionalcommits.org/) for commit messages.
---
## ❓ FAQ
### General Questions
**Q: Is SkillForge free?**
A: Yes, SkillForge is open-source and free to use under the MIT license.
**Q: Does SkillForge require Claude Code?**
A: Yes, SkillForge is specifically designed as an extension for Claude Code's native skill system.
**Q: Does SkillForge work with other AI coding assistants?**
A: Not currently. SkillForge is built specifically for Claude Code's skill architecture.
**Q: Is my data private?**
A: Yes. All your preferences, patterns, and skills are stored locally in `~/.claude/skills/`. Nothing is sent to external servers except when fetching public documentation via Context7.
### Usage Questions
**Q: Do I need to run the wizard for each project?**
A: No! Run the wizard once to set up YOUR preferences. Skills are global and reusable across all projects.
**Q: What if my project uses a different stack?**
A: Simply generate additional skills: `/sf:generate vue-spa` or `/sf:generate python-fastapi`. Your personal preferences are applied to every skill.
**Q: Can I share skills with my team?**
A: Yes! You can export your profile and skills, and team members can import them. Team collaboration features are planned for v1.1.
**Q: How much disk space does SkillForge use?**
A: Approximately 50-100MB depending on how many skills you generate.
**Q: Does SkillForge slow down Claude Code?**
A: No. The orchestration happens in milliseconds, and intelligent token optimization ensures optimal performance.
### Technical Questions
**Q: How does pattern learning work?**
A: SkillForge tracks your usage across all projects. When a pattern appears consistently (80%+ confidence), it's automatically applied to your skills.
**Q: Can I disable pattern learning?**
A: Yes, you can configure this in your profile or use `/sf:introspect --learning` to review before application.
**Q: How often are skills updated?**
A: Documentation updates can be run manually (`/sf:update --all`) or scheduled weekly via the optimizer.
**Q: Can I customize skill templates?**
A: Yes! Templates are stored in `~/.claude/skills/skillforge/templates/` and can be edited or extended.
---
## 📄 License
MIT License - see [LICENSE](LICENSE) file for details.
---
## 🙏 Acknowledgments
- **Anthropic** for Claude Code and the native skills system
- **Context Labs** for Context7 MCP server
- **Community contributors** who help improve SkillForge
---
## 🔗 Links
- **Documentation**: See [docs/](docs/) folder
- [Quick Start Guide](docs/QUICKSTART.md)
- [Architecture Overview](docs/ARCHITECTURE.md)
- [Commands Reference](docs/COMMANDS.md)
- [API Documentation](docs/API.md)
- [FAQ](docs/FAQ.md)
- [Troubleshooting](docs/TROUBLESHOOTING.md)
- **GitHub Repository**: https://github.com/omarpiosedev/SkillForge
- **Issues**: https://github.com/omarpiosedev/SkillForge/issues
---
<div align="center">
**Built with ❤️ by developers, for developers**
If SkillForge helps you, please ⭐ star the repo!
[Report Bug](https://github.com/yourusername/skillforge/issues) · [Request Feature](https://github.com/yourusername/skillforge/issues) · [Join Discord](https://discord.gg/skillforge)
</div>
Raw data
{
"_id": null,
"home_page": "https://github.com/omarpioselli/SkillForge",
"name": "skillforge",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "claude-code, skills, meta-programming, ai-development, code-generation",
"author": "Omar Pioselli",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/ba/31/de91bf2477924a1b566635419b76be530b76eefe3c2a4f7dafd42e85530f/skillforge-1.0.6.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n\n# \ud83d\udd28 SkillForge\n\n**Meta-Programming Framework for Claude Code**\n\nTransform Claude Code from a generic AI assistant into an expert team member who knows YOUR stack, YOUR conventions, and YOUR patterns.\n\n[]()\n[]()\n[]()\n[]()\n[]()\n[](https://pypi.org/project/skillforge/)\n\n[Features](#-features) \u2022 [Why SkillForge](#-why-skillforge) \u2022 [Installation](#-installation) \u2022 [Quick Start](#-quick-start) \u2022 [Documentation](#-documentation) \u2022 [Contributing](#-contributing)\n\n</div>\n\n---\n\n## \ud83d\udccb Table of Contents\n\n- [What is SkillForge?](#-what-is-skillforge)\n- [Why SkillForge?](#-why-skillforge)\n- [Features](#-features)\n- [How It Works](#-how-it-works)\n- [Installation](#-installation)\n- [Quick Start](#-quick-start)\n- [Usage](#-usage)\n- [Architecture](#-architecture)\n- [Roadmap](#-roadmap)\n- [Contributing](#-contributing)\n- [FAQ](#-faq)\n- [License](#-license)\n\n---\n\n## \ud83c\udfaf What is SkillForge?\n\nSkillForge is an intelligent meta-programming framework that extends Claude Code's native skill system. It automatically generates, orchestrates, and continuously improves personalized skills tailored to YOUR development workflow.\n\n**In one sentence:** SkillForge turns Claude Code into an expert developer who codes exactly the way YOU do, using YOUR stack, YOUR conventions, and YOUR patterns.\n\n### The Problem\n\nClaude Code's native skills are powerful but generic:\n- \u274c Don't know YOUR tech stack (Next.js? FastAPI? Supabase?)\n- \u274c Don't know YOUR conventions (camelCase? Absolute imports? Feature-based structure?)\n- \u274c Don't learn from YOUR patterns (Always use Zod? Prefer server actions?)\n- \u274c No intelligent orchestration (Claude must guess which skills to load)\n- \u274c Static and never improve over time\n\n### The Solution\n\n```\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 SkillForge \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 \u2502\n\u2502 Generator \u2192 Creates personalized skills \u2502\n\u2502 Orchestrator \u2192 Loads the right skills smartly \u2502\n\u2502 Learner \u2192 Learns from your usage patterns \u2502\n\u2502 Optimizer \u2192 Improves skills continuously \u2502\n\u2502 \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2193\n ~/.claude/skills/\n \u251c\u2500\u2500 nextjs-fullstack/ \u2190 YOUR Next.js patterns\n \u251c\u2500\u2500 supabase-integration/ \u2190 YOUR auth setup\n \u2514\u2500\u2500 git-workflow/ \u2190 YOUR commit style\n```\n\n---\n\n## \ud83d\udca1 Why SkillForge?\n\n### Without SkillForge\n\n```\nYou: \"Create a login component with Supabase auth\"\n\nClaude Code:\n\u251c\u2500 Uses generic knowledge (possibly outdated)\n\u251c\u2500 Doesn't know if you use App Router or Pages Router\n\u251c\u2500 Doesn't know your UI library (Tailwind? Material UI?)\n\u251c\u2500 Doesn't know your state management (Zustand? Redux?)\n\u251c\u2500 Generates generic code\n\nResult: OK code, but you need 15-30 minutes to:\n\u251c\u2500 Fix naming conventions\n\u251c\u2500 Adjust import paths\n\u251c\u2500 Modify styling approach\n\u251c\u2500 Adapt to your patterns\n\u2514\u2500 \ud83d\udd50 Time wasted: 15-30 minutes\n```\n\n### With SkillForge\n\n```\nYou: \"Create a login component with Supabase auth\"\n\nSkillForge (invisible, in milliseconds):\n\u251c\u2500 Analyzes intent: \"login component, Supabase, auth\"\n\u251c\u2500 Identifies skills: nextjs-fullstack + supabase-integration\n\u251c\u2500 Loads YOUR personalized skills\n\u2514\u2500 Claude receives perfect context\n\nClaude Code generates:\n\u251c\u2500 Next.js 15 App Router (you use this)\n\u251c\u2500 Shadcn/ui components (your UI library)\n\u251c\u2500 Zustand store (your state management)\n\u251c\u2500 @/ import aliases (your convention)\n\u251c\u2500 camelCase naming (your convention)\n\u251c\u2500 Zod validation (learned pattern after 20+ uses)\n\u251c\u2500 Error boundary wrapper (learned pattern)\n\u2514\u2500 Feature-based structure (your preference)\n\nResult: Production-ready code, 0 modifications needed \u2705\n\ud83d\ude80 Time saved: 100%\n```\n\n---\n\n## \u2728 Features\n\n### \ud83c\udfa8 Smart Skill Generation\n\n- **Interactive Wizard**: Answer questions about YOUR preferences (naming, imports, patterns)\n- **Template System**: Pre-built templates for popular stacks (Next.js, Vue, React, FastAPI, etc.)\n- **Documentation Fetching**: Auto-fetches latest docs via Context7 MCP\n- **Convention Injection**: Every generated skill includes YOUR personal conventions\n\n### \ud83e\udde0 Intelligent Orchestration\n\n- **Intent Analysis**: Understands what you're trying to do\n- **Smart Loading**: Loads only relevant skills with token optimization\n- **Progressive Disclosure**: Loads metadata \u2192 core \u2192 full content as needed\n- **Dependency Management**: Automatically loads related skills\n\n### \ud83d\udcca Pattern Learning\n\n- **Usage Tracking**: Tracks every skill usage and outcome\n- **Pattern Detection**: Identifies YOUR recurring patterns (confidence-based)\n- **Auto-Application**: Updates skills when patterns reach 80%+ confidence\n- **Cross-Project Learning**: Learns from ALL your projects simultaneously\n\n### \u26a1 Continuous Optimization\n\n- **Token Reduction**: Compresses verbose content without losing meaning\n- **Redundancy Detection**: Identifies overlapping skills and suggests merges\n- **Documentation Updates**: Auto-updates with latest library versions\n- **Unused Skill Detection**: Suggests removal of rarely-used skills\n\n---\n\n## \ud83c\udfd7\ufe0f How It Works\n\n### Architecture Overview\n\n```\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 User Profile \u2502\n\u2502 (YOUR preferences, global) \u2502\n\u2502 ~/.claude/skills/skillforge/data/user_profile.json \u2502\n\u2502 \u2502\n\u2502 - Naming conventions (camelCase, PascalCase) \u2502\n\u2502 - Import style (absolute with @/) \u2502\n\u2502 - Preferred libraries (Zustand, Zod, React Query) \u2502\n\u2502 - Code patterns (feature-based structure) \u2502\n\u2502 - Workflow (conventional commits) \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2193\n Injected into every skill\n \u2193\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 Generated Skills \u2502\n\u2502 (Tech-specific + YOUR preferences) \u2502\n\u2502 ~/.claude/skills/ \u2502\n\u2502 \u2502\n\u2502 nextjs-fullstack/ \u2502\n\u2502 \u251c\u2500 SKILL.md \u2190 Next.js patterns + YOUR prefs \u2502\n\u2502 \u251c\u2500 templates/ \u2190 Code templates \u2502\n\u2502 \u2514\u2500 docs/ \u2190 Reference docs \u2502\n\u2502 \u2502\n\u2502 supabase-integration/ \u2502\n\u2502 \u2514\u2500 SKILL.md \u2190 Supabase setup + YOUR prefs \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2193\n Used at runtime per project\n \u2193\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 Runtime (Per Project) \u2502\n\u2502 \u2502\n\u2502 Project A: Next.js 15 + Supabase \u2502\n\u2502 \u251c\u2500 Loads: nextjs-fullstack + supabase-integration \u2502\n\u2502 \u2514\u2500 Applies: YOUR conventions to THIS project stack \u2502\n\u2502 \u2502\n\u2502 Project B: Vue.js + Firebase \u2502\n\u2502 \u251c\u2500 Loads: vue-spa + firebase-integration \u2502\n\u2502 \u2514\u2500 Applies: YOUR conventions to THIS project stack \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n### The Four Core Components\n\n#### 1. Generator\nCreates personalized skills from templates + latest documentation + YOUR preferences.\n\n```python\nUser answers wizard questions\n \u2193\nFetch latest docs (Context7)\n \u2193\nProcess template with YOUR preferences\n \u2193\nGenerate SKILL.md (2000+ lines)\n```\n\n#### 2. Orchestrator\nIntelligently selects and loads the right skills for each request.\n\n```python\nAnalyze user request\n \u2193\nIdentify relevant skills\n \u2193\nCalculate token budget\n \u2193\nProgressive loading (metadata \u2192 core \u2192 full)\n \u2193\nClaude executes with perfect context\n```\n\n#### 3. Learner\nDetects patterns in your usage and updates skills automatically.\n\n```python\nTrack every usage\n \u2193\nAfter 10+ uses, detect patterns\n \u2193\nIf confidence \u2265 80%, apply pattern\n \u2193\nUpdate skills automatically\n \u2193\nNotify user of learned pattern\n```\n\n#### 4. Optimizer\nContinuously improves skills for performance and quality.\n\n```python\nAnalyze all skills weekly\n \u2193\nFind optimization opportunities:\n\u251c\u2500 Token reduction\n\u251c\u2500 Redundancy removal\n\u251c\u2500 Documentation updates\n\u2514\u2500 Unused skills\n \u2193\nApply optimizations (with user approval)\n```\n\n---\n\n## \ud83d\udce6 Installation\n\n### Prerequisites\n\n- Python 3.11 or higher\n- [Claude Code](https://docs.claude.com/en/docs/claude-code) installed\n- pipx (recommended) or pip\n\n### Install SkillForge\n\n```bash\n# Install globally using pipx (recommended)\npipx install skillforge\n\n# Or using pip\npip install skillforge\n```\n\n### Initialize\n\n```bash\n# Initialize SkillForge in Claude Code\nskillforge install\n```\n\nThis creates the SkillForge directory structure in `~/.claude/skills/skillforge/`.\n\n---\n\n## \ud83d\ude80 Quick Start\n\n### 1. Run the Setup Wizard\n\nOpen Claude Code in your most representative project:\n\n```bash\ncd ~/projects/my-main-project\nclaude\n```\n\nIn Claude Code, run the wizard:\n\n```\n> /sf:wizard\n```\n\nThe wizard will:\n1. \u2705 Ask about YOUR personal preferences (naming, imports, patterns)\n2. \u2705 Detect your current project's tech stack (if applicable)\n3. \u2705 Fetch latest documentation for your technologies\n4. \u2705 Generate personalized skills in `~/.claude/skills/`\n\n**Example wizard session:**\n\n```\n\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557\n\u2551 \ud83e\uddd9 SkillForge Setup Wizard \u2551\n\u2551 Building YOUR personal development profile \u2551\n\u255a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255d\n\n\ud83d\udd0d Auto-detecting from current directory...\n /Users/you/projects/my-nextjs-app\n\n\u2705 Detected:\n \u251c\u2500 Next.js 15.0.0\n \u251c\u2500 TypeScript 5.3\n \u251c\u2500 Tailwind CSS\n \u2514\u2500 Supabase\n\nUse these as defaults? [Y/n] Y\n\nGreat! Let me ask a few more questions about YOUR preferences...\n\n1\ufe0f\u20e3 YOUR naming convention for variables?\n [1] camelCase\n [2] snake_case\n> 1\n\n2\ufe0f\u20e3 YOUR import style?\n [1] Absolute imports with alias (@/...)\n [2] Relative imports (../../...)\n> 1\n\n3\ufe0f\u20e3 YOUR preferred state management?\n [1] Zustand\n [2] Redux Toolkit\n [3] Context API\n> 1\n\n... (8-10 more questions) ...\n\n\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557\n\u2551 \u2699\ufe0f Generating Skills... \u2551\n\u255a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255d\n\n[1/3] \ud83d\udce6 Fetching Next.js documentation...\n \u2514\u2500 \u2705 Documentation fetched (Context7)\n\n[2/3] \ud83d\udd28 Generating nextjs-fullstack skill...\n \u251c\u2500 Processing template\n \u251c\u2500 Injecting YOUR preferences\n \u251c\u2500 Creating SKILL.md (2341 lines)\n \u2514\u2500 \u2705 Skill generated\n\n[3/3] \ud83d\udd28 Generating supabase-integration skill...\n \u2514\u2500 \u2705 Skill generated\n\n\u2705 Setup Complete!\n\nSkills installed:\n ~/.claude/skills/\n \u251c\u2500 nextjs-fullstack/\n \u251c\u2500 supabase-integration/\n \u2514\u2500 git-workflow/\n\nYour skills will improve as you use them!\n```\n\n### 2. Use Claude Code Normally\n\nSkillForge works invisibly in the background:\n\n```\nYou: \"Create a login component with Supabase auth\"\n\n[SkillForge automatically loads your personalized skills]\n\nClaude Code: [generates perfect code using YOUR conventions]\n```\n\n### 3. Generate Additional Skills\n\nWhen you work on projects with different stacks:\n\n```\n> /sf:generate vue-spa\n> /sf:generate firebase-integration\n> /sf:generate python-fastapi\n```\n\n---\n\n## \ud83d\udcd6 Usage\n\n### Available Commands\n\n#### Core Commands\n\n```bash\n# Run the setup wizard (first time or update)\n> /sf:wizard\n\n# Generate a specific skill\n> /sf:generate <skill-name>\n\n# Generate skill from current project\n> /sf:generate --from-current\n\n# List all installed skills\n> /sf:list\n\n# View SkillForge status\n> /sf:status\n```\n\n#### Analysis & Optimization\n\n```bash\n# Analyze skills and usage patterns\n> /sf:analyze\n\n# Optimize existing skills\n> /sf:optimize\n\n# Update skills with latest documentation\n> /sf:update <skill-name>\n> /sf:update --all\n\n# Check for available updates\n> /sf:update --check\n```\n\n#### Debug & Introspection\n\n```bash\n# Debug orchestration decisions\n> /sf:introspect --orchestration\n\n# Debug pattern learning\n> /sf:introspect --learning\n```\n\n### Skill Templates\n\nSkillForge includes templates for popular stacks:\n\n**Frontend:**\n- `nextjs-fullstack` - Next.js App Router full-stack\n- `nextjs-pages` - Next.js Pages Router\n- `react-vite` - React + Vite SPA\n- `vue-spa` - Vue.js 3 + Vite\n- `svelte-kit` - SvelteKit\n\n**Backend:**\n- `python-fastapi` - FastAPI backend\n- `python-django` - Django\n- `node-express` - Express.js\n\n**Integration:**\n- `supabase-integration` - Supabase (auth, db, storage)\n- `firebase-integration` - Firebase\n- `postgresql-integration` - PostgreSQL\n- `mongodb-integration` - MongoDB\n\n**Workflow:**\n- `git-workflow` - Git conventions & commit style\n- `testing-vitest` - Vitest testing\n- `testing-jest` - Jest testing\n\n---\n\n## \ud83d\udd27 Configuration\n\n### User Profile Structure\n\nYour preferences are stored in `~/.claude/skills/skillforge/data/user_profile.json`:\n\n```json\n{\n \"version\": \"1.0\",\n \"preferences\": {\n \"naming\": {\n \"variables\": \"camelCase\",\n \"components\": \"PascalCase\",\n \"constants\": \"UPPER_SNAKE_CASE\"\n },\n \"imports\": {\n \"style\": \"absolute\",\n \"alias\": \"@/\"\n },\n \"technologies\": {\n \"state_management\": \"Zustand\",\n \"validation\": \"Zod\",\n \"testing\": \"Vitest\"\n },\n \"patterns\": {\n \"folder_structure\": \"feature-based\",\n \"component_style\": \"functional\",\n \"async_handling\": \"async/await\"\n },\n \"workflow\": {\n \"git_commits\": \"conventional\"\n }\n }\n}\n```\n\n### Manual Editing\n\nYou can manually edit your profile:\n\n```bash\n# Edit profile\ncode ~/.claude/skills/skillforge/data/user_profile.json\n\n# Regenerate skills with new preferences\n> /sf:wizard --update\n```\n\n---\n\n## \ud83c\udfdb\ufe0f Architecture\n\n### Directory Structure\n\n```\n~/.claude/skills/skillforge/\n\u2502\n\u251c\u2500\u2500 SKILL.md # Entry point (meta-skill)\n\u2502\n\u251c\u2500\u2500 core/ # Behavioral files\n\u2502 \u251c\u2500\u2500 SKILLFORGE.md # Core configuration\n\u2502 \u251c\u2500\u2500 ORCHESTRATION.md # Orchestration logic\n\u2502 \u251c\u2500\u2500 GENERATOR.md # Generation system\n\u2502 \u251c\u2500\u2500 PATTERNS.md # Pattern learning\n\u2502 \u2514\u2500\u2500 MCP_INTEGRATION.md # MCP integrations\n\u2502\n\u251c\u2500\u2500 generators/ # Python generators\n\u2502 \u251c\u2500\u2500 wizard_engine.py # Interactive wizard\n\u2502 \u251c\u2500\u2500 skill_generator.py # Skill generator\n\u2502 \u2514\u2500\u2500 doc_fetcher.py # Context7 integration\n\u2502\n\u251c\u2500\u2500 analyzers/ # Intelligence\n\u2502 \u251c\u2500\u2500 intent_analyzer.py # Analyze requests\n\u2502 \u251c\u2500\u2500 skill_discovery.py # Find relevant skills\n\u2502 \u251c\u2500\u2500 pattern_detector.py # Detect patterns\n\u2502 \u2514\u2500\u2500 skill_optimizer.py # Optimize skills\n\u2502\n\u251c\u2500\u2500 templates/ # Skill templates\n\u2502 \u251c\u2500\u2500 tech-stack/\n\u2502 \u2502 \u251c\u2500\u2500 nextjs-fullstack.template\n\u2502 \u2502 \u251c\u2500\u2500 react-spa.template\n\u2502 \u2502 \u2514\u2500\u2500 python-api.template\n\u2502 \u2514\u2500\u2500 workflow/\n\u2502 \u2514\u2500\u2500 git-workflow.template\n\u2502\n\u2514\u2500\u2500 data/ # Persistent data\n \u251c\u2500\u2500 user_profile.json # Your preferences\n \u251c\u2500\u2500 usage_analytics.json # Usage stats\n \u2514\u2500\u2500 learned_patterns.json # Learned patterns\n```\n\n### Integration with Claude Code\n\nSkillForge extends Claude Code's native skill system:\n\n```\nClaude Code loads skills from ~/.claude/skills/\n\nWhen you make a request:\n1. SkillForge analyzes intent\n2. Identifies relevant skills\n3. Loads them with token optimization\n4. Claude receives perfect context\n5. SkillForge tracks usage for learning\n```\n\n### MCP Integration (Context7)\n\nSkillForge uses [Context7](https://github.com/context-labs/context7) MCP server to fetch up-to-date documentation:\n\n```python\n# Fetch latest Next.js docs\ndocs = context7_get_library_docs(\n library_id=\"/vercel/next.js\",\n topic=\"App Router\",\n tokens=2000\n)\n\n# Extract and use in skill generation\nbest_practices = extract_best_practices(docs)\ncode_examples = extract_code_examples(docs)\n```\n\n---\n\n## \ud83d\uddfa\ufe0f Roadmap\n\n**Current Status**: v1.0.0 Production Release \ud83d\ude80\n\n### \u2705 Phase 1-10: Complete (100%)\n\n**Foundation & Core Systems**\n- [x] Core architecture design\n- [x] Complete briefing documentation\n- [x] Generator implementation (WizardEngine, SkillGenerator, TemplateProcessor, DocFetcher)\n- [x] Orchestrator implementation (IntentAnalyzer, SkillDiscovery)\n- [x] Learner implementation (UsageTracker, PatternDetector, LearningPipeline)\n- [x] Optimizer implementation (SkillOptimizer)\n\n**User Interface & Commands**\n- [x] Slash commands system (10 commands: /sf:wizard, /sf:generate, /sf:analyze, etc.)\n- [x] Visual output system (VERBOSE, COMPACT, SILENT modes)\n- [x] Beautiful installation experience\n\n**Quality & Testing**\n- [x] Comprehensive test suite (unit, integration, e2e)\n- [x] Test coverage implementation\n- [x] Performance optimization\n\n**Documentation & Release**\n- [x] Complete user documentation\n- [x] API documentation\n- [x] README and guides\n- [x] Package published to PyPI\n- [x] Installation scripts\n- [x] Production-ready v1.0.0\n\n### \ud83d\udd2e Future Enhancements (Post v1.0)\n- [ ] Additional framework templates (Vue, Angular, FastAPI, Django)\n- [ ] Web UI for skill management\n- [ ] Skill marketplace for sharing and collaboration\n- [ ] Advanced analytics dashboard\n- [ ] Multi-project skill sharing\n- [ ] Team collaboration features\n- [ ] Import/export profiles\n- [ ] CI/CD integration hooks\n- [ ] IDE extensions (VSCode, JetBrains)\n\n---\n\n## \ud83e\udd1d Contributing\n\nSkillForge is in **production** (v1.0.0) and we welcome contributions!\n\n### Ways to Contribute\n\n- \ud83d\udc1b **Report bugs**: [Open an issue](https://github.com/yourusername/skillforge/issues)\n- \ud83d\udca1 **Suggest features**: [Start a discussion](https://github.com/yourusername/skillforge/discussions)\n- \ud83d\udcdd **Improve docs**: Submit documentation PRs\n- \ud83d\udd28 **Add templates**: Contribute skill templates for new stacks\n- \ud83e\uddea **Test**: Try SkillForge and provide feedback\n\n### Development Setup\n\n```bash\n# Clone repository\ngit clone https://github.com/yourusername/skillforge.git\ncd skillforge\n\n# Create virtual environment\npython -m venv venv\nsource venv/bin/activate # On Windows: venv\\Scripts\\activate\n\n# Install dependencies\npip install -e \".[dev]\"\n\n# Run tests\npytest\n\n# Run linter\nruff check .\n```\n\n### Contribution Guidelines\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit changes (`git commit -m 'feat: add amazing feature'`)\n4. Push to branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\nPlease follow [Conventional Commits](https://www.conventionalcommits.org/) for commit messages.\n\n---\n\n## \u2753 FAQ\n\n### General Questions\n\n**Q: Is SkillForge free?** \nA: Yes, SkillForge is open-source and free to use under the MIT license.\n\n**Q: Does SkillForge require Claude Code?** \nA: Yes, SkillForge is specifically designed as an extension for Claude Code's native skill system.\n\n**Q: Does SkillForge work with other AI coding assistants?** \nA: Not currently. SkillForge is built specifically for Claude Code's skill architecture.\n\n**Q: Is my data private?** \nA: Yes. All your preferences, patterns, and skills are stored locally in `~/.claude/skills/`. Nothing is sent to external servers except when fetching public documentation via Context7.\n\n### Usage Questions\n\n**Q: Do I need to run the wizard for each project?** \nA: No! Run the wizard once to set up YOUR preferences. Skills are global and reusable across all projects.\n\n**Q: What if my project uses a different stack?** \nA: Simply generate additional skills: `/sf:generate vue-spa` or `/sf:generate python-fastapi`. Your personal preferences are applied to every skill.\n\n**Q: Can I share skills with my team?** \nA: Yes! You can export your profile and skills, and team members can import them. Team collaboration features are planned for v1.1.\n\n**Q: How much disk space does SkillForge use?** \nA: Approximately 50-100MB depending on how many skills you generate.\n\n**Q: Does SkillForge slow down Claude Code?** \nA: No. The orchestration happens in milliseconds, and intelligent token optimization ensures optimal performance.\n\n### Technical Questions\n\n**Q: How does pattern learning work?** \nA: SkillForge tracks your usage across all projects. When a pattern appears consistently (80%+ confidence), it's automatically applied to your skills.\n\n**Q: Can I disable pattern learning?** \nA: Yes, you can configure this in your profile or use `/sf:introspect --learning` to review before application.\n\n**Q: How often are skills updated?** \nA: Documentation updates can be run manually (`/sf:update --all`) or scheduled weekly via the optimizer.\n\n**Q: Can I customize skill templates?** \nA: Yes! Templates are stored in `~/.claude/skills/skillforge/templates/` and can be edited or extended.\n\n---\n\n## \ud83d\udcc4 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n---\n\n## \ud83d\ude4f Acknowledgments\n\n- **Anthropic** for Claude Code and the native skills system\n- **Context Labs** for Context7 MCP server\n- **Community contributors** who help improve SkillForge\n\n---\n\n## \ud83d\udd17 Links\n\n- **Documentation**: See [docs/](docs/) folder\n - [Quick Start Guide](docs/QUICKSTART.md)\n - [Architecture Overview](docs/ARCHITECTURE.md)\n - [Commands Reference](docs/COMMANDS.md)\n - [API Documentation](docs/API.md)\n - [FAQ](docs/FAQ.md)\n - [Troubleshooting](docs/TROUBLESHOOTING.md)\n- **GitHub Repository**: https://github.com/omarpiosedev/SkillForge\n- **Issues**: https://github.com/omarpiosedev/SkillForge/issues\n\n---\n\n<div align=\"center\">\n\n**Built with \u2764\ufe0f by developers, for developers**\n\nIf SkillForge helps you, please \u2b50 star the repo!\n\n[Report Bug](https://github.com/yourusername/skillforge/issues) \u00b7 [Request Feature](https://github.com/yourusername/skillforge/issues) \u00b7 [Join Discord](https://discord.gg/skillforge)\n\n</div>\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Meta-programming framework for Claude Code skills",
"version": "1.0.6",
"project_urls": {
"Documentation": "https://github.com/omarpioselli/SkillForge/blob/main/docs/",
"Homepage": "https://github.com/omarpioselli/SkillForge",
"Issues": "https://github.com/omarpioselli/SkillForge/issues",
"Repository": "https://github.com/omarpioselli/SkillForge"
},
"split_keywords": [
"claude-code",
" skills",
" meta-programming",
" ai-development",
" code-generation"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b5217a808998f147692db9516a4167a8a18a5dbfdcb58bc5261edb82fe400009",
"md5": "de398ab65a199d76ae87bfd791f7b77c",
"sha256": "eda4999ce1396125fff222500de2b45814f79ba5909b852cbfeab709637bdba8"
},
"downloads": -1,
"filename": "skillforge-1.0.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "de398ab65a199d76ae87bfd791f7b77c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 250569,
"upload_time": "2025-10-24T14:21:08",
"upload_time_iso_8601": "2025-10-24T14:21:08.079165Z",
"url": "https://files.pythonhosted.org/packages/b5/21/7a808998f147692db9516a4167a8a18a5dbfdcb58bc5261edb82fe400009/skillforge-1.0.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ba31de91bf2477924a1b566635419b76be530b76eefe3c2a4f7dafd42e85530f",
"md5": "a2030e9b4d82e7b0f1eb8ac50e98bf6f",
"sha256": "45baf522b089c2afb56e5711ebf5c68cbace596d9af0e710aa93e10aa70a4364"
},
"downloads": -1,
"filename": "skillforge-1.0.6.tar.gz",
"has_sig": false,
"md5_digest": "a2030e9b4d82e7b0f1eb8ac50e98bf6f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 422016,
"upload_time": "2025-10-24T14:21:09",
"upload_time_iso_8601": "2025-10-24T14:21:09.945253Z",
"url": "https://files.pythonhosted.org/packages/ba/31/de91bf2477924a1b566635419b76be530b76eefe3c2a4f7dafd42e85530f/skillforge-1.0.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-24 14:21:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "omarpioselli",
"github_project": "SkillForge",
"github_not_found": true,
"lcname": "skillforge"
}
JSON
