Workflow Kit

q-skills

A collection of project-agnostic Claude Code plugins for structured development workflows.

Plugins

workflow-kit

Project-agnostic Claude Code plugins for the full feature lifecycle: structured planning, verified implementation, and PR review.

Skills included:

Skill	Command	Description
feature-plan	/workflow-kit:feature-plan	Create structured implementation plans with phases, tasks, and acceptance criteria
implement-plan	/workflow-kit:implement-plan	Execute a plan end-to-end with dependency-graph parallel phases, two-tier verification, an opus escalation rescue, and a post-plan review + auto-fix

Composable Skills

workflow-kit skills delegate to project-local skills that you supply. These must exist in your project's .claude/skills/ before running implement-plan or feature-plan:

Skill	Required	Contract
/verify	Required	Run quality gates; return pass or fail with raw output verbatim on failure
/create-worktree	Required	Create an isolated git worktree and branch; return its path
/clean-architecture	Required	Load layer rules and naming conventions into context
/research	Optional	Look up latest API docs for a given surface; return findings as text. Skipped gracefully if absent.

See examples/android/ for a working reference implementation targeting Kotlin, Gradle KTS, Jetpack Compose, Hilt, and Clean Architecture. Copy and adapt those skills as a starting point for your own project.

dev-toolkit

Standalone dev utilities that work independently of any planning pipeline.

Skills included:

Skill	Command	Description
pr-review	/dev-toolkit:pr-review	Project-aware GitHub PR review with focused, numbered findings
skill-sharpener	/dev-toolkit:skill-sharpener	Analyze session transcripts to find and fix skill friction
notify-me	/dev-toolkit:notify-me	Send macOS system notifications during long-running tasks (macOS only)

Installation

1. Clone the repo:

git clone https://github.com/Alton09/q-skills.git ~/Workspace/q-skills

1. Add the local directory as a marketplace and install each plugin:

claude plugin marketplace add /path/to/q-skills
claude plugin install workflow-kit
claude plugin install dev-toolkit

1. Reload plugins in Claude Code:

/reload-plugins

Run /doctor to confirm no errors.

Updating

# Check your exact plugin identifier
claude plugins list

# Update using the name shown (e.g. workflow-kit@q-skills)
claude plugins update workflow-kit@<marketplace-name>
claude plugins update dev-toolkit@<marketplace-name>

Restart Claude Code after updating to apply changes.

Usage

After installation, skills are available as slash commands:

/workflow-kit:feature-plan      # Plan a feature
/workflow-kit:implement-plan    # Execute a plan
/dev-toolkit:pr-review          # Review a GitHub PR
/dev-toolkit:skill-sharpener    # Improve skills from session data
/dev-toolkit:notify-me          # Send macOS notification

Project Structure

q-skills/
  .claude-plugin/
    marketplace.json          # Marketplace registry (lists both plugins)
  plugins/
    workflow-kit/
      .claude-plugin/
        plugin.json           # Plugin manifest (v1.1.0)
      skills/
        feature-plan/         # Feature planning skill
        implement-plan/       # Plan execution skill (with built-in opus escalation rescue)
    dev-toolkit/
      .claude-plugin/
        plugin.json           # Plugin manifest (v1.0.0)
      skills/
        pr-review/            # GitHub PR review skill
        skill-sharpener/      # Skill improvement skill
        notify-me/            # macOS notification skill

License

See LICENSE for details.