Mastering Claude Code Skills: Installing and Using the Superpowers Plugin

What are Skills?

Agent Skills are a standardized format for encapsulating procedural knowledge. Each Skill is a folder that must contain a SKILL.md file defining metadata and core commands, and may optionally include scripts (e.g., Python or Bash), reference documents, and templates.

pdf-skill/
├── SKILL.md            # Skill metadata and core commands (required)
├── forms.md           # Form‑filling guide (optional)
├── reference.md       # Detailed API reference (optional)
└── scripts/
    └── extract_fields.py

When executing a task, Claude Code scans all available Skills, automatically selects the appropriate ones, loads any associated resources, and follows the steps defined in SKILL.md, producing more stable and predictable results.

Claude Code Plugin Installation

View Installed Plugins

Use the /plugin command to list plugins currently installed on the local machine.

Add a Plugin Marketplace

Run: /plugin marketplace add anthropics/claude-code Refresh the session with /reload-plugins so the new marketplace is discovered.

Additional marketplaces can be added, for example:

/plugin marketplace add obra/superpowers-marketplace

Remove a Plugin Marketplace

To remove a marketplace, run:

/plugin marketplace remove claude-plugins-official

Install a Plugin

After a marketplace is added, discover plugins in the "Discover" tab and install, e.g., the superpowers plugin:

/plugin install superpowers@superpowers-marketplace

Refresh the session with /reload-plugins to load the new Skills.

Recommended Plugin: Superpowers

Superpowers is an open‑source Skills repository (GitHub URL: https://github.com/obra/superpowers) with a collection of composable Skills and starter prompts that help AI agents perform systematic software development.

Core Workflows Provided by Superpowers

brainstorming : Initiates a design interview, asks clarifying questions, and saves the design document.

using‑git‑worktrees : After design approval, creates an isolated worktree on a new branch, runs project initialization, and verifies a clean test baseline.

writing‑plans : Breaks the work into 2–5 minute tasks, each with precise file paths, code snippets, and verification steps.

subagent‑driven‑development (or executing‑plans ): Assigns a fresh sub‑agent to each task, performs a two‑stage review (spec compliance then code quality), or executes tasks in batches with manual checkpoints.

test‑driven‑development : Enforces the RED‑GREEN‑REFACTOR cycle; any code written before a failing test is deleted.

requesting‑code‑review : Triggers a review between tasks, reporting issues by severity; severe issues block further progress.

finishing‑a‑development‑branch : After tasks complete, validates test results, offers merge/PR/retain/discard options, and cleans up the worktree.

Superpowers Installation

Register the marketplace and install the plugin:

/plugin marketplace add obra/superpowers-marketplace

Verify the marketplace is listed (image omitted for brevity).

/plugin install superpowers@superpowers-marketplace

Skills Practice Example: Adding a Login Feature

Prompt to Claude Code:

我想在现有的项目中新增一个登录功能，请采访我并完善这个登录功能

Claude Code triggers the superpowers:brainstorming Skill and asks a series of targeted questions:

问题 1：您希望登录功能支持哪些认证方式？
问题 2：关于密码安全，您希望使用哪种加密方式？（当前项目使用的是简单的 MD5，安全性较低）
问题 3：关于登录后的 Token 管理，您需要哪些功能？
问题 4：关于验证码，登录时是否需要图形验证码？
问题 5：关于权限控制，您需要哪些功能？
问题 6：关于登录接口的请求/响应格式，您倾向于？
问题 7：关于会话超时，您希望 Token 有效期是多久？
问题 8：除了登录功能，您还需要以下哪些配套功能？（可多选）

Claude Code then proposes two redesign options; the simple option is chosen, resulting in a design document, an implementation plan, and execution using superpowers:writing-plans and superpowers:subagent-driven-development.

The implementation plan is presented as a list of short tasks. Two execution modes are offered:

Sub‑agent driven (recommended): a fresh sub‑agent handles each task with staged reviews.

Inline execution: tasks are executed in batch within the current session using the executing-plans skill, with manual checkpoints.

The sub‑agent driven mode is selected.

Execution proceeds with superpowers:subagent-driven-development, performing task‑level code generation, verification, and review as defined by the Skill.

Summary

Agent Skills provide a modular way to extend Claude Code with reusable procedural knowledge. The Superpowers repository supplies a comprehensive set of Skills that automate requirement gathering, planning, test‑driven development, code review, and branch finalization. By installing the Superpowers marketplace and invoking its Skills, developers can drive an end‑to‑end development lifecycle with minimal manual scripting.