learned-skills-index

• [Overview](#overview)
• [Key Features](#key-features)
• [Architecture](#architecture)
• [Core Orchestration Layer](#core-orchestration-layer)
• [Core API Reference](#core-api-reference)
• [Installation](#installation)
• [Quick Start](#quick-start)
• [Agent System](#agent-system)
• [Command System](#command-system)
• [Loop Orchestration](#loop-orchestration)
• [MCP Integrations](#mcp-integrations)
• [Skills System](#skills-system)
• [Quality System](#quality-system)
• [Quality Gates](#quality-gates)
• [Metrics System](#metrics-system)
• [Type System](#type-system)
• [Configuration](#configuration)
• [Directory Structure](#directory-structure)
• [Creating Custom Agents](#creating-custom-agents)
• [Contributing](#contributing)

---

SuperClaude is a meta-prompt framework that enhances Claude Code with:

• 35 Specialized Agents: 16 core + 12 composable traits + 7 domain extensions (tiered architecture)
• 30 Active Skills: 8 agent personas + 19 command workflows + 3 utility skills (plus 106 deprecated)
• 14 Structured Commands: analyze, implement, test, design, document, and more
• 6 Framework Modes: normal, brainstorming, introspection, task_management, token_efficiency, orchestration
• MCP Integration: PAL (11 tools), Rube (500+ apps via Composio, including web search)
• Quality Gates: KISS validator, Purity validator, and iterative quality loop
• Core Orchestration: ~3,200 lines Python for loop management, PAL integration, and skill learning
• Signal-Based Architecture: Structured communication between components
• Metrics System: Callback-based operational metrics with Prometheus/StatsD integration

---

Config-First Hybrid Architecture

SuperClaude v7.0.0 is a config-first hybrid framework:

• Markdown Agent Personas: Each agent is a self-contained markdown file with YAML frontmatter
• YAML Configuration: 6 configuration files for agents, commands, quality, models, MCP, and framework settings
• Python Orchestration: Loop orchestrator, quality assessment, PAL integration, and skill learning
• Portable: Works with any Claude Code instance
• Extensible: Add agents by creating markdown files

Why Config-First Hybrid?

| Benefit | Description |

|---------|-------------|

| Simplicity | Core interface is markdown/YAML files |

| Portability | Works with any Claude Code instance |

| Extensibility | Add agents by creating markdown files |

| Maintainability | Prompts are easy to refine and version |

| Version Control | Easy to diff and review prompt changes |

| Advanced Workflows | Python orchestration for quality gates and loop control |

| Safety | Hard limits on iterations, termination detection |

Tiered Agent Arc