toolkit

Toolkit Command

Help the user understand what tools are available and which ones to use right now.

Instructions

Step 1: Analyze Current Context

Quickly assess where the user is and what they might be working on:

# What repo are we in?
basename $(git rev-parse --show-toplevel 2>/dev/null) 2>/dev/null || echo "Not in a git repo"

# What changed recently?
git diff --name-only HEAD 2>/dev/null | head -10
git status --short 2>/dev/null | head -10

# What kind of project is this?
ls *.py pyproject.toml requirements*.txt config.yaml .env.example .mcp.json 2>/dev/null

Step 2: Discover Available Capabilities

Dynamically scan the workspace to find what's actually installed — never use a hardcoded list.

Find skills:

# List all skills and their descriptions
for skill_dir in skills/*/; do
  skill_file="$skill_dir/SKILL.md"
  if [ -f "$skill_file" ]; then
    name=$(basename "$skill_dir")
    desc=$(grep -A1 "^description:" "$skill_file" | tail -1 | sed 's/^[[:space:]]*//' | cut -c1-70)
    printf "  %-25s %s\n" "$name" "$desc"
  fi
done

Find commands:

# List all commands and their descriptions
for cmd_dir in commands/*/; do
  cmd_file="$cmd_dir/command.md"
  if [ -f "$cmd_file" ]; then
    name=$(basename "$cmd_dir")
    desc=$(grep "^description:" "$cmd_file" | head -1 | sed 's/description:[[:space:]]*"//;s/"$//' | cut -c1-60)
    printf "  /%-24s %s\n" "$name" "$desc"
  fi
done

Step 3: Present Capabilities

Present a clear overview organized by how they're used, populated from the scan results above:

WORKSPACE TOOLKIT
=================

SKILLS (activate automatically — you don't need to do anything):
────────────────────────────────────────────────────────────────
  [name]                  [description from SKILL.md]
  ...

COMMANDS (type these to trigger):
─────────────────────────────────
  /[name]              [description from command.md]
  ...

AGENTS (I spawn these automatically for parallel/specialized work):
──────────────────────────────────────────────────────────────────
  Explore            Fast codebase search across many files
  Plan               Design implementation strategies
  general-purpose    Complex multi-step research tasks