Files
skill-seekers-reference/docs
yusyus e32f2fd977 docs: Add comprehensive skill architecture guide for layering and splitting
Addresses #199 - Developer guidance for multi-skill systems

**What's New:**

Added SKILL_ARCHITECTURE.md covering:
- Router/dispatcher pattern for complex applications
- When and how to split skills (500-line guideline)
- Manual skill architecture (not just auto-generated)
- Best practices (single responsibility, routing keywords)
- Complete examples (travel planner, e-commerce, code assistant)
- Implementation guide (step-by-step)
- Troubleshooting common issues

**Key Patterns:**

1. **Router Pattern:**
   - Master skill analyzes query
   - Routes to appropriate sub-skill(s)
   - Only loads relevant context

2. **Example Architectures:**
   - Travel planner → flight_booking + hotel + itinerary
   - E-commerce → catalog + cart + checkout + orders
   - Code assistant → debugging + refactoring + docs + testing

3. **Guidelines:**
   - Keep each skill under 500 lines
   - Use single responsibility principle
   - Define clear routing keywords
   - Document multi-skill coordination

**Based on Existing Implementation:**

Adapts our proven router pattern from LARGE_DOCUMENTATION.md
and generate_router.py, now documented for manual use cases.

**Impact:**

Enables developers to build enterprise-level multi-skill systems
while maintaining optimal Claude performance and context efficiency.

Closes #199
2025-12-28 18:37:43 +03:00
..
2025-10-23 21:43:05 +03:00