Setup and Usage Guide for Claude Sub-Agent Commands

Setup and Usage Guide for Claude Sub-Agent Commands

This guide explains how to install and use these powerful sub-agent commands with Claude.

Prerequisites

undefined

Installation

1. Locate Your Claude Commands Directory

The Claude commands directory is located at:

undefined

2. Create the Commands Directory (if it doesn't exist)

# macOS/Linux
mkdir -p ~/.claude/commands

# Windows (PowerShell)
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\commands"

3. Copy Command Files

Option A: Direct Download (Recommended)

# macOS/Linux
cd ~/.claude/commands
curl -O https://raw.githubusercontent.com/derek-opdee/subagent-example-script/main/sub-agent-tech-debt-finder-fixer.md
curl -O https://raw.githubusercontent.com/derek-opdee/subagent-example-script/main/sub-agent-architecture-reviewer.md
curl -O https://raw.githubusercontent.com/derek-opdee/subagent-example-script/main/sub-agent-test-generator.md
curl -O https://raw.githubusercontent.com/derek-opdee/subagent-example-script/main/sub-agent-performance-optimizer.md
curl -O https://raw.githubusercontent.com/derek-opdee/subagent-example-script/main/sub-agent-migration-assistant.md
curl -O https://raw.githubusercontent.com/derek-opdee/subagent-example-script/main/sub-agent-refactor.md
curl -O https://raw.githubusercontent.com/derek-opdee/subagent-example-script/main/sub-agent-new-feature.md

Option B: Clone and Copy

# Clone the repository
git clone https://github.com/derek-opdee/subagent-example-script.git
cd subagent-example-script

# Copy to Claude commands directory (macOS/Linux)
cp *.md ~/.claude/commands/

# Copy to Claude commands directory (Windows PowerShell)
Copy-Item *.md "$env:USERPROFILE\.claude\commands\"

Option C: Manual Copy

undefined

4. Verify Installation

# List installed commands (macOS/Linux)
ls -la ~/.claude/commands/

# List installed commands (Windows PowerShell)
Get-ChildItem "$env:USERPROFILE\.claude\commands"

You should see:

undefined

Usage

Once installed, you can use these commands in any Claude conversation by typing the command name or its aliases.

1. Tech Debt Finder & Fixer

Find and fix technical debt in your codebase:

# Full command
sub-agent-tech-debt-finder-fixer src/

# Using alias
@tech-debt-finder-fixer src/

# Shortest alias
@satdff src/ --dry-run

# Examples
@tech-debt-finder-fixer --auto-fix safe --fix-order quick-wins
@satdff src/components