@slamb2k/mad-skills 2.0.6

package/skills/rig/instructions.md

@@ -0,0 +1,162 @@
+# Rig Instructions
+
+Idempotently bootstrap repositories with standard development infrastructure.
+Prompts and report schemas are in `references/`. Configuration procedures are
+in `references/configuration-steps.md`.
+
+**Key principle:** Prompt user before making changes. Report findings first,
+get approval, then act.
+
+---
+
+## Pre-flight
+
+Before starting, check all dependencies in this table:
+
+| Dependency | Type | Check | Required | Resolution | Detail |
+|-----------|------|-------|----------|------------|--------|
+| git | cli | `git --version` | yes | stop | Install from https://git-scm.com |
+| lefthook | npm | `npx lefthook --help` | yes | install | `npm install -g lefthook` |
+| gh | cli | `gh --version` | yes | url | https://cli.github.com |
+
+For each row, in order:
+1. Run the Check command (for cli/npm) or test file existence (for agent/skill)
+2. If found: continue silently
+3. If missing: apply Resolution strategy
+   - **stop**: notify user with Detail, halt execution
+   - **url**: notify user with Detail (install link), halt execution
+   - **install**: notify user, run the command in Detail, continue if successful
+   - **ask**: notify user, offer to run command in Detail, continue either way (or halt if required)
+   - **fallback**: notify user with Detail, continue with degraded behavior
+4. After all checks: summarize what's available and what's degraded
+
+---
+
+## Phase 1: System Requirements Check
+
+Launch **Bash subagent** (haiku — simple checks):
+
+```
+Task(
+  subagent_type: "Bash",
+  model: "haiku",
+  description: "Check system requirements",
+  prompt: <read from references/phase-prompts.md#phase-1>
+)
+```
+
+Parse SYSTEM_REPORT. If any requirement fails, use **AskUserQuestion**:
+
+Options for missing git config:
+- "I'll configure it manually"
+- "Configure for me with: [email] / [name]"
+
+**Stop if user chooses manual. Configure if values provided.**
+
+---
+
+## Phase 2: Repository Analysis
+
+Launch **Bash subagent** (haiku):
+
+```
+Task(
+  subagent_type: "Bash",
+  model: "haiku",
+  description: "Analyze repository",
+  prompt: <read from references/phase-prompts.md#phase-2>
+)
+```
+
+Parse REPO_REPORT.
+
+---
+
+## Phase 3: Present Findings & Get Approval
+
+Present analysis to user with **AskUserQuestion**:
+
+```
+Repository Analysis Complete
+
+Current State:
+  Git initialized: {status}
+  Branch: {branch}
+  Lefthook: {status}
+  Commit template: {status}
+  PR template: {status}
+  CI workflow: {status}
+  {if azdo and unregistered_pipelines:}
+  Azure Pipelines: {N} YAML file(s) found, {M} not yet registered
+
+Detected Stack:
+  Type: {project_type}
+  Components: {detected_components}
+  Available scripts: {available_scripts}
+
+Proposed Changes:
+  {numbered list of what will be added/configured}
+  {if azdo and unregistered_pipelines: "Register Azure Pipelines: {list of YAML paths}"}
+```
+
+Options:
+- "Yes, configure everything"
+- "Let me choose what to configure"
+- "Cancel"
+
+If "Let me choose", present individual options as multi-select.
+
+---
+
+## Phase 4: Execute Configuration
+
+For each approved item, follow the procedures in
+`references/configuration-steps.md`.
+
+---
+
+## Phase 5: Verification
+
+Launch **Bash subagent** (haiku):
+
+```
+Task(
+  subagent_type: "Bash",
+  model: "haiku",
+  description: "Verify configuration",
+  prompt: <read from references/phase-prompts.md#phase-5>
+)
+```
+
+Parse VERIFY_REPORT.
+
+---
+
+## Phase 6: Final Report
+
+Present summary using the template in `references/report-template.md`.
+
+---
+
+## Idempotency Rules
+
+- **Skip** items already correctly configured
+- **Update** items that exist but are outdated (prompt user first)
+- **Add** items that are missing
+- **Never delete** user's existing configuration without explicit approval
+- **Merge** rather than replace when possible (e.g., add missing hooks)
+
+---
+
+## Error Handling
+
+If any step fails:
+1. Report the specific failure
+2. Offer to skip and continue, or abort
+3. Include troubleshooting suggestions
+
+Common issues:
+- No package manager -> suggest installing npm/bun
+- Permission denied -> check file permissions
+- Lefthook install fails -> try global install
+- Git not initialized -> offer to initialize

package/skills/rig/references/configuration-steps.md

@@ -0,0 +1,124 @@
+# Rig Configuration Steps
+
+Procedural reference for Phase 4 — execute each approved item.
+
+---
+
+## 4a: Git Init (if needed)
+
+```bash
+git init
+git checkout -b main
+```
+
+## 4b: Install Lefthook (if needed)
+
+Detect package manager and install:
+
+```bash
+# Node projects
+npm install --save-dev lefthook || bun add -d lefthook || yarn add -D lefthook || pnpm add -D lefthook
+
+# Or global install
+npm install -g lefthook
+```
+
+## 4c: Configure Lefthook
+
+Read template from: `~/.claude/skills/rig/assets/lefthook.yml`
+
+Customize based on detected scripts:
+- If `lint` script exists -> use `npm run lint`
+- If `format:check` script exists -> use `npm run format:check`
+- If `typecheck` or `type-check` exists -> use that
+- If `test` or `test:unit` exists -> use for pre-push
+
+Write customized `lefthook.yml` to repo root.
+
+Run: `lefthook install`
+
+## 4d: Commit Template
+
+Read template from: `~/.claude/skills/rig/assets/gitmessage`
+
+Write to `.gitmessage` in repo root.
+
+Configure git: `git config commit.template .gitmessage`
+
+## 4e: PR Template
+
+Read template from: `~/.claude/skills/rig/assets/pull_request_template.md`
+
+Detect platform from remote URL (same pattern as ship skill):
+```bash
+REMOTE_URL=$(git remote get-url origin 2>/dev/null)
+if echo "$REMOTE_URL" | grep -qiE 'dev\.azure\.com|visualstudio\.com'; then
+  PLATFORM="azdo"
+else
+  PLATFORM="github"
+fi
+```
+
+**If PLATFORM == github:**
+  Create `.github/` directory if needed.
+  Write to `.github/pull_request_template.md`
+
+**If PLATFORM == azdo:**
+  Create `.azuredevops/` directory if needed.
+  Write to `.azuredevops/pull_request_template.md`
+  (Azure DevOps also supports root-level `pull_request_template.md`)
+
+## 4f: CI Workflow
+
+Customize based on project:
+- Set correct package manager (npm/bun/yarn/pnpm)
+- Add build steps for detected components
+- Configure test jobs appropriately
+
+**If PLATFORM == github:**
+  Read template from: `~/.claude/skills/rig/assets/ci.yml`
+  Create `.github/workflows/` directory if needed.
+  Write customized workflow to `.github/workflows/ci.yml`
+
+**If PLATFORM == azdo:**
+  Read template from: `~/.claude/skills/rig/assets/azure-pipelines.yml`
+  Write customized pipeline to `azure-pipelines.yml` (repo root)
+
+## 4g: Register Azure Pipelines (azdo only, if approved)
+
+For each unregistered pipeline YAML file discovered in Phase 2, create the
+pipeline in Azure DevOps. Only runs if the user approved this in Phase 3.
+
+**Prerequisites:** `az devops` extension installed and configured with
+`az devops configure --defaults organization=... project=...`.
+If `az pipelines` commands fail, report the setup requirement and skip.
+
+```bash
+# Derive a pipeline name from the YAML filename
+# azure-pipelines.yml -> "CI" (default)
+# build.azure-pipelines.yml -> "Build"
+# deploy.azure-pipelines.yml -> "Deploy"
+YAML_PATH="azure-pipelines.yml"   # each discovered file
+PIPELINE_NAME="CI"                # derived from filename, or ask user
+
+# Get the repo name from the remote URL
+REPO_NAME=$(basename -s .git "$(git remote get-url origin)")
+
+az pipelines create \
+  --name "$PIPELINE_NAME" \
+  --yaml-path "$YAML_PATH" \
+  --repository "$REPO_NAME" \
+  --repository-type tfsgit \
+  --branch main \
+  --skip-first-run
+```
+
+**Naming convention:**
+- `azure-pipelines.yml` -> pipeline name: `"CI"`
+- `<name>.azure-pipelines.yml` -> pipeline name: capitalize `<name>`
+- If the user chose a custom name in Phase 3, use that instead
+
+**Error handling:**
+- If `az pipelines create` fails with auth error -> report: `az login` required
+- If it fails with "already exists" -> skip (idempotent)
+- If `az devops` extension not installed -> report and skip

package/skills/rig/references/phase-prompts.md

@@ -0,0 +1,180 @@
+# Rig Phase Prompts
+
+Subagent prompts for system check, repo analysis, and verification phases.
+
+---
+
+## Phase 1: System Requirements Check
+
+**Agent:** Bash (haiku)
+
+```
+Check system requirements for repository bootstrapping.
+
+Limit SYSTEM_REPORT to 10 lines maximum.
+
+## Checks
+
+1. **Git installed**
+   git --version
+   Record: git_installed, git_version
+
+2. **Git global config**
+   git config --global user.email
+   git config --global user.name
+   Record: email_configured, name_configured, email_value, name_value
+
+## Output Format
+
+SYSTEM_REPORT:
+- git_installed: true|false
+- git_version: {version}
+- email_configured: true|false
+- email_value: {email or "not set"}
+- name_configured: true|false
+- name_value: {name or "not set"}
+```
+
+---
+
+## Phase 2: Repository Analysis
+
+**Agent:** Bash (haiku)
+
+```
+Analyze repository structure and current configuration.
+
+Limit REPO_REPORT to 20 lines maximum.
+
+## Checks
+
+1. **Git initialization**
+   [ -d .git ] && echo "initialized" || echo "not initialized"
+   Record: git_initialized
+
+2. **Branch name** (if initialized)
+   git branch --show-current 2>/dev/null || git symbolic-ref --short HEAD 2>/dev/null
+   Record: current_branch, is_main=(branch == "main")
+
+3. **Lefthook**
+   command -v lefthook >/dev/null && echo "installed" || echo "not installed"
+   [ -f lefthook.yml ] && echo "configured" || echo "not configured"
+   Record: lefthook_installed, lefthook_configured
+
+4. **Commit template**
+   [ -f .gitmessage ] && echo "exists" || echo "missing"
+   git config commit.template 2>/dev/null
+   Record: commit_template_exists, commit_template_configured
+
+5. **Platform detection**
+   REMOTE_URL=$(git remote get-url origin 2>/dev/null)
+   if echo "$REMOTE_URL" | grep -qiE 'dev\.azure\.com|visualstudio\.com'; then
+     PLATFORM="azdo"
+   elif echo "$REMOTE_URL" | grep -qi 'github\.com'; then
+     PLATFORM="github"
+   else
+     PLATFORM="github"
+   fi
+   Record: platform
+
+6. **PR template**
+   If PLATFORM == github:
+     [ -f .github/pull_request_template.md ] && echo "exists" || echo "missing"
+   If PLATFORM == azdo:
+     ([ -f .azuredevops/pull_request_template.md ] || [ -f pull_request_template.md ]) && echo "exists" || echo "missing"
+   Record: pr_template_exists
+
+7. **CI workflow**
+   If PLATFORM == github:
+     [ -f .github/workflows/ci.yml ] && echo "exists" || echo "missing"
+   If PLATFORM == azdo:
+     [ -f azure-pipelines.yml ] && echo "exists" || echo "missing"
+   Record: ci_workflow_exists
+
+8. **Azure pipeline YAML files** (if PLATFORM == azdo)
+   Find pipeline YAML files in the repo:
+   ```
+   find . -maxdepth 3 \( -name "azure-pipelines.yml" -o -name "*.azure-pipelines.yml" \) -not -path "./.git/*" 2>/dev/null
+   ```
+   For each file found, check if a matching pipeline already exists in Azure DevOps:
+   ```
+   az pipelines list --query "[].{name:name, path:process.yamlFilename}" -o tsv 2>/dev/null
+   ```
+   Record: pipeline_yaml_files, existing_pipelines
+
+9. **Project structure**
+   ls package.json 2>/dev/null && echo "has_package_json"
+   ls requirements.txt pyproject.toml setup.py 2>/dev/null && echo "has_python"
+   ls go.mod 2>/dev/null && echo "has_go"
+   ls Cargo.toml 2>/dev/null && echo "has_rust"
+   Find frontend dirs: src/components, frontend/, client/, app/
+   Find backend dirs: src/api, backend/, server/, api/
+   Record: project_type, has_frontend, has_backend, detected_components
+
+9. **Existing scripts** (for hook configuration)
+   Parse package.json scripts if exists: lint, format, format:check, typecheck, type-check, test
+   Record: available_scripts
+
+## Output Format
+
+REPO_REPORT:
+- git_initialized: true|false
+- current_branch: {branch or "N/A"}
+- is_main_branch: true|false
+- platform: github|azdo
+- lefthook_installed: true|false
+- lefthook_configured: true|false
+- commit_template_exists: true|false
+- commit_template_configured: true|false
+- pr_template_exists: true|false
+- ci_workflow_exists: true|false
+- pipeline_yaml_files: [list of paths, or "none"] (azdo only)
+- existing_pipelines: [list of registered pipeline names, or "none"] (azdo only)
+- unregistered_pipelines: [pipeline YAMLs not yet registered, or "none"] (azdo only)
+- project_type: node|python|go|rust|unknown
+- has_frontend: true|false
+- has_backend: true|false
+- detected_components: [list]
+- available_scripts: {scripts from package.json}
+```
+
+---
+
+## Phase 5: Verification
+
+**Agent:** Bash (haiku)
+
+```
+Verify rig configuration was applied correctly.
+
+Limit VERIFY_REPORT to 10 lines maximum.
+
+## Checks
+
+1. Test lefthook
+   lefthook run pre-commit --dry-run 2>&1
+
+2. Verify files exist
+   Detect platform from remote URL (same pattern as Phase 2).
+   If PLATFORM == github:
+     ls -la .gitmessage lefthook.yml .github/pull_request_template.md .github/workflows/ci.yml
+   If PLATFORM == azdo:
+     ls -la .gitmessage lefthook.yml .azuredevops/pull_request_template.md azure-pipelines.yml
+     (Also check root-level pull_request_template.md as fallback)
+
+3. Check git config
+   git config --local commit.template
+
+4. Verify Azure Pipelines registered (if PLATFORM == azdo and pipelines were created in Phase 4)
+   az pipelines list --query "[].{name:name, id:id}" -o table 2>/dev/null
+   Record: registered_pipelines
+
+## Output Format
+
+VERIFY_REPORT:
+- lefthook_working: true|false
+- lefthook_error: {error if any}
+- files_created: [list]
+- git_config_set: true|false
+- registered_pipelines: [list of pipeline names, or "N/A"] (azdo only)
+```

package/skills/rig/references/report-template.md

@@ -0,0 +1,28 @@
+# Rig Final Report Template
+
+Present this summary after all configuration is complete:
+
+```
+Rig Complete!
+
+Repository: {repo_name}
+Branch: {branch}
+
+Configured:
+  {status} Lefthook installed and configured
+  {status} Pre-commit hooks: {list of hooks}
+  {status} Pre-push hooks: {list of hooks}
+  {status} Commit template: .gitmessage
+  {status} PR template: {.github/pull_request_template.md | .azuredevops/pull_request_template.md}
+  {status} CI workflow: {.github/workflows/ci.yml | azure-pipelines.yml}
+  {if azdo and pipelines registered:}
+  {status} Azure Pipelines registered: {list of pipeline names}
+
+Notes:
+  {any warnings, e.g., "Branch is 'master', consider renaming to 'main'"}
+
+Next steps:
+  1. Review generated files and commit them
+  2. Push to remote to activate CI
+  3. Test hooks with: lefthook run pre-commit
+```

package/skills/rig/tests/evals.json

@@ -0,0 +1,29 @@
+[
+  {
+    "name": "banner-and-tagline",
+    "prompt": "Bootstrap this repo with standard tools",
+    "assertions": [
+      { "type": "contains", "value": "██" },
+      { "type": "regex", "value": "(Rigging up|Bolting down|Assembling the|Hoisting the|Locking in|Wiring up|Setting up the drill|blueprint to build)" },
+      { "type": "semantic", "value": "The response begins with an ASCII art banner displayed BEFORE any explanation or workflow steps" }
+    ]
+  },
+  {
+    "name": "tooling-awareness",
+    "prompt": "Set up hooks and CI for this project",
+    "assertions": [
+      { "type": "contains", "value": "██" },
+      { "type": "regex", "value": "lefthook", "flags": "i" },
+      { "type": "regex", "value": "(GitHub Actions|CI|workflow)", "flags": "i" },
+      { "type": "semantic", "value": "Describes setting up git hooks (via lefthook), commit templates, PR templates, and GitHub Actions workflows for lint/format/type-check/build" }
+    ]
+  },
+  {
+    "name": "idempotency-and-confirmation",
+    "prompt": "Rig my repository",
+    "assertions": [
+      { "type": "contains", "value": "██" },
+      { "type": "semantic", "value": "Mentions that the process is idempotent (safe to run multiple times) and will prompt the user for confirmation before making changes" }
+    ]
+  }
+]

package/skills/ship/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: ship
+description: >
+  Ship changes through the full PR lifecycle. Use after completing feature work
+  to commit, push, create PR, wait for checks, and merge. Handles the entire
+  workflow: syncs with main, creates feature branch if needed, groups commits
+  logically with semantic messages, creates detailed PR, monitors CI, fixes
+  issues, squash merges, and cleans up. Invoke when work is ready to ship.
+---
+
+# Ship - Full PR Lifecycle
+
+When this skill is invoked, IMMEDIATELY output the banner below before doing anything else.
+Pick ONE tagline at random — vary your choice each time:
+
+```
+{tagline}
+
+    ██╗███████╗██╗  ██╗██╗██████╗
+   ██╔╝██╔════╝██║  ██║██║██╔══██╗
+  ██╔╝ ███████╗███████║██║██████╔╝
+ ██╔╝  ╚════██║██╔══██║██║██╔═══╝
+██╔╝   ███████║██║  ██║██║██║
+╚═╝    ╚══════╝╚═╝  ╚═╝╚═╝╚═╝
+
+```
+
+Taglines:
+- 🚚 Special delivery!!!
+- 📦 If it compiles, it ships!
+- 🚢 Anchors aweigh!
+- 🙏 git push and pray!
+- ⚡ Shipping faster than Amazon Prime!
+- 🏀 Yeet the code into production!
+- 📬 Another one for the merge queue!
+- 🟢 LGTM — Let's Get This Merged!
+
+Follow instructions in: [instructions.md](instructions.md)
+
+## Subagent Architecture
+
+All work runs in subagents to keep the primary conversation context clean:
+
+| Stage | Agent Type | Model | Purpose |
+|-------|-----------|-------|---------|
+| Sync | Bash | haiku | Git sync (cheap, fast) |
+| Ship | ship-analyzer | sonnet | Analyze code, commit, push, create PR |
+| CI | Bash (background) | haiku | Poll checks without blocking |
+| Fix CI | general-purpose | default | Read code, fix failures |
+| Land | Bash | haiku | Merge + final sync |
+
+The `ship-analyzer` custom agent (`~/.claude/agents/ship-analyzer.md`) reads
+source files to write meaningful commit messages and PR descriptions.
+Falls back to `general-purpose` if not installed.
+