Equip Claude with a comprehensive skills library of proven techniques, patterns, and tools.

This builds on the great work provided at superpowers, extending with support for multiple skills sources

💡 For developers and contributors, see DEVELOPMENT.md for architecture details, testing workflows, and contribution guidelines.

📚 For project insights and design decisions, see LEARNINGS.md for lessons learned and implementation notes.

• Testing Skills - TDD, async testing, anti-patterns
• Debugging Skills - Systematic debugging, root cause tracing, verification
• Collaboration Skills - Brainstorming, planning, code review, parallel agents
• Meta Skills - Creating, testing, and contributing skills

Plus:

• Slash Commands - /brainstorm, /create-adr, /write-plan, /execute-plan
• Skills Search - Grep-powered discovery of relevant skills
• Gap Tracking - Failed searches logged for skill creation

Read the introduction: Superpowers for Claude Code

In general, using WSL or Docker is a good move for Windows users. However this can work in Windows if:

• Git for Windows is installed
• Your environment variable PATH includes the directory containing Git bash (e.g. C:\Program Files\Git\bin)
• Your PATH variable is higher than C:\Windows\System32 so that bash doesn't default to loading WSL terminal

Run the following (note at time of writing the slash command doesn't work in the vs code extension):

claude /plugin

• Select "add marketplace"
• Enter https://github.com/tmoxon/uni
• Agree to set it up
• Follow instructions to install uni
• Restart extensions

The plugin automatically handles skills repository setup on first run.

To avoid having to allow claude to read skills files every time, you can use the /add-dir command in claude to add the install directory.

This is likely C:\Users\Your-User.claude\plugins\uni

# Check that commands appear
/help

# Should see:
# /brainstorm - Interactive design refinement
# /write-plan - Create implementation plan
# /execute-plan - Execute plan in batches

Find skills before starting any task:

${UNI_SKILLS}/skills/using-skills/find-skills              # All skills with descriptions
${UNI_SKILLS}/skills/using-skills/find-skills test         # Filter by pattern
${UNI_SKILLS}/skills/using-skills/find-skills 'TDD|debug'  # Regex pattern

Brainstorm a design:

/brainstorm

Create an implementation plan:

/write-plan

Execute the plan:

/execute-plan

Claude Code can work directly with GitHub issues during brainstorming sessions. Simply provide the repository URL and issue number:

Example:

/brainstorm
I want to work on https://github.com/tmoxon/uni issue #45

Claude will fetch the issue details and use them as context for:

• Understanding feature requests with full discussion
• Addressing bug reports with reproduction steps
• Planning work that's already documented

This works with any public GitHub repository. For private repositories, use the GitHub CLI to authenticate:

gh auth login

The GitHub CLI (gh) is included in the Uni Docker container.

The claude.md file helps Claude understand your project conventions and setup.

Location: Place in your project root

Purpose: Documents project-specific context:

• Framework and language choices (React, Next.js, TypeScript, etc.)
• Coding conventions and patterns
• Build and test procedures
• Project structure and file organization

Format: Human-readable Markdown documentation with optional executable actions (JSON) for patches and dependencies.

Skills automatically read claude.md before generating code, ensuring consistency with your project's existing patterns and conventions.

Testing (skills/testing/)

• test-driven-development - RED-GREEN-REFACTOR cycle
• condition-based-waiting - Async test patterns
• testing-anti-patterns - Common pitfalls to avoid

Debugging (skills/debugging/)

• systematic-debugging - 4-phase root cause process
• root-cause-tracing - Find the real problem
• verification-before-completion - Ensure it's actually fixed
• defense-in-depth - Multiple validation layers

Collaboration (skills/collaboration/)

• brainstorming - Socratic design refinement
• writing-plans - Detailed implementation plans
• executing-plans - Batch execution with checkpoints
• dispatching-parallel-agents - Concurrent subagent workflows
• remembering-conversations - Search past work
• using-git-worktrees - Parallel development branches
• requesting-code-review - Pre-review checklist
• receiving-code-review - Responding to feedback

Meta (skills/meta/)

• writing-skills - TDD for documentation, create new skills
• sharing-skills - Contribute skills back via branch and PR
• testing-skills-with-subagents - Validate skill quality
• pulling-updates-from-skills-repository - Sync with upstream
• gardening-skills-wiki - Maintain and improve skills

• brainstorm.md - Interactive design refinement using Socratic method
• write-plan.md - Create detailed implementation plans
• execute-plan.md - Execute plans in batches with review checkpoints

• find-skills - Unified skill discovery with descriptions
• skill-run - Generic runner for any skill script
• search-conversations - Semantic search of past Claude sessions (in remembering-conversations skill)

Using tools:

${UNI_SKILLS}/skills/using-skills/find-skills              # Show all skills
${UNI_SKILLS}/skills/using-skills/find-skills pattern      # Search skills
${UNI_SKILLS}/skills/using-skills/skill-run <path> [args]  # Run any skill script

If the plugin reports a permissions error executing the shell script, you can explicitly set permissions on the .sh files:

chmod +x ~/.claude/plugins/cache/uni/hooks/session-start.sh
chmod +x ~/.claude/plugins/cache/uni/lib/initialize-skills.sh

Then reload VS Code. If that still doesn't work, try running session-start.sh directly to debug.

There appear to be bugs in handling plugins through the marketplace connections. If you run into problems and can't uninstall it, then:

1. Delete the folder ~/.config/uni
2. Delete the folder ~/.claude/plugins/cache/uni
3. Update the file ~/.claude/settings.json to remove uni
4. Restart vs code / claude

If you see an error similar to 'Unexpected token '', "{..." is not valid JSON'

1. Reinstall your Claude Code extension

MIT License - see LICENSE file for details