Exercise: Custom Skill and Automation Workflow

git clone https://github.com/charmbracelet/gum.git
cd gum

# macOS
brew install gum

# Debian/Ubuntu
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://repo.charm.sh/apt/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/charm.gpg
echo "deb [signed-by=/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/ * *" | sudo tee /etc/apt/sources.list.d/charm.list
sudo apt update && sudo apt install gum

# Windows (scoop)
scoop install charm-gum

gum --version

go version

mkdir -p .claude/skills/release-prep

---
name: release-prep
description: Prepares a release by running tests, generating changelog, and creating version tags. Use when preparing a new release or when asked to create a release.
argument-hint: [version-type]
disable-model-invocation: true
allowed-tools: Bash, Read, Edit
---

## Objective

Guide the release preparation process with proper validation and documentation.

## Steps

1. **Validate environment**
   - Verify working directory is clean (no uncommitted changes)
   - Confirm on the main branch
   - Ensure all tests pass

2. **Determine version bump**
   - If version type provided as argument, use it
   - Otherwise, analyze commits since last tag to suggest type
   - Version types: patch (bug fixes), minor (new features), major (breaking changes)

3. **Generate changelog**
   - List commits since last tag
   - Group by type (feat, fix, docs, etc.)
   - Format as markdown

4. **Create release**
   - Update version in relevant files
   - Create git tag
   - Provide summary of changes

## Conventions

- Follow semantic versioning (MAJOR.MINOR.PATCH)
- Tag format: v1.2.3
- Changelog entries should be concise and user-focused
- Do not push to remote—leave that decision to the developer

claude

/release-prep

/release-prep patch

mkdir -p .claude/hooks

#!/bin/bash
set -e

# Skip in CI environments
if [ -n "$CI" ]; then
    exit 0
fi

# Get the files being edited
FILE="$1"

# Only check Go files
if [[ ! "$FILE" =~ \.go$ ]]; then
    exit 0
fi

# Check if gofmt would make changes
if ! gofmt -l "$FILE" | grep -q .; then
    exit 0
fi

# Formatting needed - output to stderr for Claude to see
echo "File needs formatting: $FILE" >&2
echo "Run: gofmt -w $FILE" >&2
exit 2

chmod +x .claude/hooks/pre-commit-check.sh

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/pre-commit-check.sh \"$CLAUDE_FILE_PATH\""
          }
        ]
      }
    ]
  }
}

claude

Add a comment to gum.go with inconsistent spacing

#!/bin/bash
set -e

# Styled header using gum
gum style \
    --border double \
    --padding "1" \
    --foreground 212 \
    "Parallel Agent Workflow Setup"

# Get current branch
BASE_BRANCH=$(git branch --show-current)
echo "Base branch: $BASE_BRANCH"

# Define tasks
TASKS=(
    "docs:Update documentation"
    "tests:Add test coverage"
    "refactor:Code cleanup"
)

# Let user select tasks
echo ""
SELECTED=$(printf '%s\n' "${TASKS[@]}" | gum choose --no-limit --header "Select tasks to run in parallel:")

if [ -z "$SELECTED" ]; then
    gum log --level warn "No tasks selected"
    exit 0
fi

# Create worktree directory
WORKTREE_BASE="../gum-worktrees"
mkdir -p "$WORKTREE_BASE"

# Create worktrees for selected tasks
echo ""
gum style --foreground 10 "Creating worktrees..."

echo "$SELECTED" | while IFS=: read -r task_id task_desc; do
    BRANCH_NAME="agent-$task_id"
    WORKTREE_PATH="$WORKTREE_BASE/$BRANCH_NAME"

    # Check if worktree already exists
    if [ -d "$WORKTREE_PATH" ]; then
        gum log --level warn "Worktree exists: $BRANCH_NAME (skipping)"
        continue
    fi

    gum spin --spinner dot --title "Creating: $BRANCH_NAME" -- \
        git worktree add -b "$BRANCH_NAME" "$WORKTREE_PATH" "$BASE_BRANCH" 2>/dev/null

    gum log --level info "Created: $BRANCH_NAME → $WORKTREE_PATH"
done

# Show status
echo ""
gum style --foreground 212 "Worktree Status:"
git worktree list

# Instructions
echo ""
gum style \
    --border rounded \
    --padding "1" \
    "To start agents, open a new terminal for each worktree and run 'claude'"

chmod +x scripts/setup-parallel.sh

./scripts/setup-parallel.sh

git worktree list

cd ../gum-worktrees/agent-docs  # or agent-tests, agent-refactor
claude

Review the README.md and suggest improvements for the installation section.
Make the changes if appropriate.

Find functions in the filter package that lack test coverage.
Suggest which functions would benefit most from tests.

#!/bin/bash

gum style --border double --foreground 212 "Worktree Status"
echo ""

for wt in $(git worktree list --porcelain | grep "^worktree " | cut -d' ' -f2); do
    # Skip main worktree
    if [ "$wt" = "$(pwd)" ]; then
        continue
    fi

    BRANCH=$(git -C "$wt" branch --show-current 2>/dev/null)
    CHANGES=$(git -C "$wt" status --short 2>/dev/null | wc -l | tr -d ' ')
    AHEAD=$(git -C "$wt" rev-list main.."$BRANCH" --count 2>/dev/null || echo "0")

    if [ "$CHANGES" -gt 0 ]; then
        gum style --foreground 214 "● $BRANCH: $CHANGES uncommitted, $AHEAD commits ahead"
    else
        gum style --foreground 10 "○ $BRANCH: clean, $AHEAD commits ahead"
    fi
done

chmod +x scripts/worktree-status.sh
./scripts/worktree-status.sh

---
name: parallel-tasks
description: Orchestrates parallel agent tasks using git worktrees. Use when multiple independent tasks need to run simultaneously.
argument-hint: [task-list-file]
disable-model-invocation: true
allowed-tools: Bash, Read
---

## Objective

Set up and monitor parallel agent execution across git worktrees.

## Prerequisites

- Git worktrees created via scripts/setup-parallel.sh
- Each worktree on its own feature branch
- Base branch (main) is clean

## Workflow

1. **Status check**
   - Run scripts/worktree-status.sh
   - Report which worktrees have changes

2. **Task assignment guidance**
   - List available worktrees
   - Suggest task distribution based on branch names
   - Provide commands to start agents in each worktree

3. **Integration preparation**
   - When tasks complete, list branches ready for merge
   - Check for conflicts between branches
   - Suggest merge order based on dependencies

## Notes

- Each worktree has isolated context (200K tokens)
- Agents do not share conversation history
- Use files for state that must persist across agents
- Monitor with scripts/worktree-status.sh

/parallel-tasks

# Remove worktrees
git worktree remove ../gum-worktrees/agent-docs --force
git worktree remove ../gum-worktrees/agent-tests --force
git worktree remove ../gum-worktrees/agent-refactor --force

# Remove branches if desired
git branch -D agent-docs agent-tests agent-refactor

git worktree list

## Environment Detection

Check for CI environment variables:
- If $CI is set, use non-interactive mode
- Skip confirmation prompts in CI
- Use provided arguments instead of interactive selection

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/confirm-dangerous.sh"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
# scripts/aggregate-results.sh

OUTPUT="parallel-summary.md"
echo "# Parallel Task Results" > "$OUTPUT"
echo "" >> "$OUTPUT"

for wt in $(git worktree list --porcelain | grep "^worktree " | cut -d' ' -f2); do
    BRANCH=$(git -C "$wt" branch --show-current 2>/dev/null)
    if [ -z "$BRANCH" ] || [ "$BRANCH" = "main" ]; then
        continue
    fi

    echo "## $BRANCH" >> "$OUTPUT"
    git -C "$wt" log main.."$BRANCH" --pretty=format:"- %s" >> "$OUTPUT"
    echo "" >> "$OUTPUT"
done

cat "$OUTPUT"

---
name: full-release
description: Complete release workflow including parallel tasks and release prep
disable-model-invocation: true
---

## Workflow

1. Invoke /parallel-tasks to set up worktrees for:
   - Documentation updates
   - Test additions
   - Changelog preparation

2. Monitor until all tasks complete

3. Aggregate results from worktrees

4. Invoke /release-prep with the determined version type

5. Generate release summary

#!/bin/bash
# .claude/hooks/log-metrics.sh

LOG_FILE=".claude/metrics.jsonl"
TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
TOOL="$CLAUDE_TOOL_NAME"
DURATION="$CLAUDE_DURATION_MS"

echo "{\"timestamp\":\"$TIMESTAMP\",\"tool\":\"$TOOL\",\"duration_ms\":$DURATION}" >> "$LOG_FILE"
exit 0