# SuperClaude — Workflow Framework for Claude Code

> Adds 16+ slash commands, 9 cognitive personas, and a smart flag system to Claude Code in one pipx install.

## Install

Save the content below to `.claude/skills/` or append to your `CLAUDE.md`:

# SuperClaude — Workflow Framework for Claude Code

## Quick Use
```bash
pipx install SuperClaude
SuperClaude install
# or upgrade later
SuperClaude install --update
```

## Introduction
SuperClaude is a configuration framework that bolts a complete development workflow onto Claude Code. One install drops 16+ slash commands, 9 cognitive personas, an MCP server bundle, and a smart-flag system into your `~/.claude/` directory — turning a stock Claude Code setup into a structured, opinionated dev environment in under a minute.

## What SuperClaude Does
- Installs a curated set of slash commands like `/build`, `/troubleshoot`, `/improve`, `/document`, `/explain`, and `/test`.
- Provides 9 swappable personas (architect, frontend, backend, security, mentor, refactorer, and more) that change how Claude approaches your task.
- Adds a flag system (`--think`, `--plan`, `--uc`) so commands can be tuned without rewriting them.
- Wires up MCP servers that the framework expects — sequential thinking, context, search — out of the box.
- Ships with an updater so you can pull new commands and personas as the project iterates.

## Architecture Overview
SuperClaude is a Python CLI distributed via pipx. The `install` command writes Markdown command definitions, persona files, and a `CLAUDE.md` profile into `~/.claude/`. Commands and personas are plain text, so Claude Code reads them natively — there is no runtime daemon. Updates use a 3-way merge against your existing `~/.claude/` so local edits survive.

## Self-Hosting & Configuration
- Single dependency: a working `claude` CLI. The framework itself adds no servers.
- `SuperClaude install` is idempotent — re-run it to refresh commands without nuking your customizations.
- Edit any installed command or persona in place; updates use a 3-way merge.
- Full uninstall: `SuperClaude uninstall` removes only the files it placed.
- All command and persona definitions are open Markdown — fork and re-publish your own flavor easily.

## Key Features
- One-command install of an entire opinionated workflow.
- Cognitive personas — same model, dramatically different behaviors.
- 16+ workflow slash commands tuned for real engineering tasks, not toys.
- Flags layer that composes orthogonally with commands.
- Active community: the command library and persona pack are versioned and updated.

## Comparison with Similar Tools
- **Claude Code defaults** — clean slate, no personas, no opinionated commands. SuperClaude fills that gap.
- **Aider** — opinionated CLI in its own right; SuperClaude lives inside Claude Code instead of replacing it.
- **AutoGen / CrewAI** — multi-agent frameworks; SuperClaude is a single-agent productivity layer.
- **Cursor Rules** — IDE-specific equivalent of personas; SuperClaude works at the CLI and skill layer.
- **Vanilla `~/.claude/` tweaks** — same surface, but SuperClaude curates and versions the content.

## FAQ
**Q:** Will SuperClaude overwrite my existing slash commands?
A: Only on conflicts. The installer warns and prompts for merges; clean directories install silently.

**Q:** Do I need a separate API key?
A: No — it runs entirely through your existing Claude Code auth.

**Q:** Can I use only some of the personas?
A: Yes. Each persona is a separate file in `~/.claude/personas/` — delete or edit any of them.

**Q:** Is this affiliated with Anthropic?
A: No. It is a community framework built on top of Claude Code public extension surface.

## Sources
- https://github.com/SuperClaude-Org/SuperClaude_Framework
- https://superclaude.dev


---
Source: https://tokrepo.com/en/workflows/superclaude-workflow-framework-claude-code-42067371
Author: Skill Factory