Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 5 additions & 4 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
@@ -1,15 +1,16 @@
{
"name": "superpowers-dev",
"description": "Development marketplace for Superpowers core skills library",
"$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
"name": "bestpractice-dev",
"description": "Development marketplace for Best Practice core skills library",
"owner": {
"name": "Jesse Vincent",
"email": "jesse@fsck.com"
},
"plugins": [
{
"name": "superpowers",
"name": "bestpractice",
"description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
"version": "3.2.2",
"version": "3.2.3",
"source": "./",
"author": {
"name": "Jesse Vincent",
Expand Down
7 changes: 3 additions & 4 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,13 +1,12 @@
{
"name": "superpowers",
"name": "bestpractice",
"description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
"version": "3.2.3",
"author": {
"name": "Jesse Vincent",
"email": "jesse@fsck.com"
},
"homepage": "https://github.com/obra/superpowers",
"repository": "https://github.com/obra/superpowers",
"license": "MIT",
"homepage": "https://github.com/titofebus/ccbp",
"repository": "https://github.com/titofebus/ccbp",
"keywords": ["skills", "tdd", "debugging", "collaboration", "best-practices", "workflows"]
}
21 changes: 0 additions & 21 deletions LICENSE

This file was deleted.

67 changes: 44 additions & 23 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,44 +1,57 @@
# Superpowers
# Best Practice

Give Claude Code superpowers with a comprehensive skills library of proven techniques, patterns, and workflows.
Give Claude Code best practice with a comprehensive skills library of proven techniques, patterns, and workflows.

## What You Get

- **Testing Skills** - TDD, async testing, anti-patterns
- **Debugging Skills** - Systematic debugging, root cause tracing, verification
- **Refactoring Skills** - Complexity reduction, code quality improvements
- **Collaboration Skills** - Brainstorming, planning, code review, parallel agents
- **Development Skills** - Git worktrees, finishing branches, subagent workflows
- **Meta Skills** - Creating, testing, and sharing skills

Plus:
- **Slash Commands** - `/superpowers:brainstorm`, `/superpowers:write-plan`, `/superpowers:execute-plan`
- **Slash Commands** - `/bestpractice:brainstorm`, `/bestpractice:write-plan`, `/bestpractice:execute-plan`
- **Automatic Integration** - Skills activate automatically when relevant
- **Consistent Workflows** - Systematic approaches to common engineering tasks

## Learn More

Read the introduction: [Superpowers for Claude Code](https://blog.fsck.com/2025/10/09/superpowers/)
Read the introduction: [Best Practice for Claude Code](https://blog.fsck.com/2025/10/09/bestpractice/)

## Installation

### Via Plugin Marketplace (Recommended)
### From GitHub

```bash
# In Claude Code
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
/plugin marketplace add titofebus/ccbp
/plugin install bestpractice@ccbp
```

### From Local Directory

If you've cloned this repository locally:

```bash
# In Claude Code
/plugin marketplace add /path/to/ccbp
/plugin install bestpractice@ccbp
```

### Verify Installation

After installing, restart Claude Code, then verify:

```bash
# Check that commands appear
/help

# Should see:
# /superpowers:brainstorm - Interactive design refinement
# /superpowers:write-plan - Create implementation plan
# /superpowers:execute-plan - Execute plan in batches
# You should see:
# /bestpractice:brainstorm - Interactive design refinement
# /bestpractice:write-plan - Create implementation plan
# /bestpractice:execute-plan - Execute plan in batches
```

## Quick Start
Expand All @@ -47,24 +60,25 @@ Read the introduction: [Superpowers for Claude Code](https://blog.fsck.com/2025/

**Brainstorm a design:**
```
/superpowers:brainstorm
/bestpractice:brainstorm
```

**Create an implementation plan:**
```
/superpowers:write-plan
/bestpractice:write-plan
```

**Execute the plan:**
```
/superpowers:execute-plan
/bestpractice:execute-plan
```

### Automatic Skill Activation

Skills activate automatically when relevant. For example:
- `test-driven-development` activates when implementing features
- `systematic-debugging` activates when debugging issues
- `reducing-complexity` activates when refactoring functions with high cyclomatic complexity
- `verification-before-completion` activates before claiming work is done

## What's Inside
Expand All @@ -82,6 +96,9 @@ Skills activate automatically when relevant. For example:
- **verification-before-completion** - Ensure it's actually fixed
- **defense-in-depth** - Multiple validation layers

**Refactoring** (`skills/`)
- **reducing-complexity** - Systematic refactoring to reduce cyclomatic complexity ≤ 10

**Collaboration** (`skills/collaboration/`)
- **brainstorming** - Socratic design refinement
- **writing-plans** - Detailed implementation plans
Expand All @@ -97,7 +114,7 @@ Skills activate automatically when relevant. For example:
- **writing-skills** - Create new skills following best practices
- **sharing-skills** - Contribute skills back via branch and PR
- **testing-skills-with-subagents** - Validate skill quality
- **using-superpowers** - Introduction to the skills system
- **using-bestpractice** - Introduction to the skills system

### Commands

Expand All @@ -109,7 +126,7 @@ All commands are thin wrappers that activate the corresponding skill:

## How It Works

1. **SessionStart Hook** - Loads the `using-superpowers` skill at session start
1. **SessionStart Hook** - Loads the `using-bestpractice` skill at session start
2. **Skills System** - Uses Claude Code's first-party skills system
3. **Automatic Discovery** - Claude finds and uses relevant skills for your task
4. **Mandatory Workflows** - When a skill exists for your task, using it becomes required
Expand All @@ -136,17 +153,21 @@ See `skills/meta/writing-skills/SKILL.md` for the complete guide.

## Updating

Skills update automatically when you update the plugin:
To update the plugin:

```bash
/plugin update superpowers
```
# Uninstall the old version
/plugin uninstall bestpractice

## License
# Pull the latest changes from git
git pull

MIT License - see LICENSE file for details
# Reinstall
/plugin marketplace update ccbp
/plugin install bestpractice@ccbp
```

## Support

- **Issues**: https://github.com/obra/superpowers/issues
- **Marketplace**: https://github.com/obra/superpowers-marketplace
- **Issues**: https://github.com/titofebus/ccbp/issues
- **Repository**: https://github.com/titofebus/ccbp
Loading