craft

Analyze codebase architecture with mode support

Architecture Diagrams

Architecture Planning

Architecture Review

Universal pre-flight check that validates project readiness

Generate a new custom validator template for /craft:check

Smart detection of project type, build tools, test frameworks, and CI requirements

Generate GitHub Actions CI workflow from project detection

Cross-repo CI status dashboard showing all workflow runs

Validate existing CI workflow against project configuration

Fix CI Failures

Run CI checks locally before pushing (lint, test, coverage, security)

Validate command frontmatter, find deprecated patterns, report health score

Test Coverage Report

Debug Assistance

Code Demonstration

Security audit of dependencies for known vulnerabilities

Dependency Check

Track Claude Desktop releases and identify plugin integration opportunities

Documentation & Website Pre-flight Check

Code style and quality checks with mode support

Refactoring Guidance

Track Claude Code + Desktop releases and identify plugin-relevant changes

Release Workflow

Generate Tests

Discovery Engine Usage Guide

Generate curl-based installation scripts for GitHub releases

Complete Homebrew automation - formulas, casks, workflows, auditing, and dependency management

Claude Code marketplace distribution - init, validate, test, and publish

Complete PyPI automation - build, publish, and workflow generation

Universal command that intelligently routes to appropriate craft commands

/craft:docs:api - OpenAPI/Swagger Documentation

Auto-update CHANGELOG.md based on git commits

Internal link validation for documentation

Documentation health check (links, staleness, navigation)

Interactive section-by-section CLAUDE.md editing with preview

Create CLAUDE.md from lean project-type template with auto-population

Sync CLAUDE.md with project state - update metrics, audit, fix, optimize

Terminal Recording & GIF Generator with dependency management

/craft:docs:guide - Orchestrated Guide Generator

/craft:docs:help - Help Page Generator

Markdown quality and error detection with auto-fix

Mermaid diagrams — templates, NL creation, MCP validation, and live preview

Update mkdocs.yml navigation from directory structure

/craft:docs:prompt - Generate Documentation Prompts

/craft:docs:quickstart - Quick Start Generator

/craft:docs:site - Website Documentation Focus

Detect code changes and classify documentation needs

/craft:docs:tutorial - Interactive Tutorial Generator

Smart documentation generator with interactive category-level updates

/craft:docs:website - ADHD-Friendly Website Enhancement

/craft:docs:workflow - Workflow Documentation Generator

Interactive git branch management assistant

Clean up merged branches safely

Git Commands Learning Guide

Git Commands Quick Reference

Git Safety Rails Guide

Git Undo Guide - Emergency Reference

Git activity summary - recent commits, branch status, and productivity insights

Initialize git repository with craft workflow patterns

Re-enable branch protection after bypass, configure protection level

Enhanced git status with teaching-specific context

Smart git synchronization with remote repositories

Session-scoped bypass for branch protection with reason logging

Git worktree management for parallel development workflows

/craft:hub - Command Discovery Hub

Launch orchestrator mode with subagent delegation, monitoring, mode-aware execution, and chat compression

Generate ORCHESTRATE file from spec, with optional worktree creation and cross-repo detection

Resume orchestration session across devices using Claude Desktop session teleportation

Feature Planning

Roadmap Generation

Sprint Planning

/craft:site:add - Add Pages with Navigation Sync

/craft:site:audit - Content Inventory & Audit

Build documentation site (Quarto, pkgdown, MkDocs) with teaching mode support

Validate documentation site for broken links and common issues

/craft:site:consolidate - Merge Duplicate Content

/craft:site:create - Full Documentation Site Wizard

Deploy documentation site to GitHub Pages

Documentation Framework Comparison

/site-init - Initialize Documentation Site

/craft:site:nav - Navigation Reorganization

/site-preview - Preview Documentation Locally

Display comprehensive semester progress dashboard

Publish teaching site with preview workflow (draft → production)

/craft:site:status - Documentation Site Dashboard

/craft:site:theme - Quick Theme Changes

Update documentation site based on code changes

Context-aware help that suggests relevant commands

Unified test runner with category filtering and modes

Auto-detect project type and generate test suite

Manage Jinja2 templates for test generation

Semester Progress Calculation Utilities

Teaching Configuration Parser

ADHD-Friendly Workflow Guide

Enhanced brainstorming with smart detection, design modes, time budgets, agent delegation, context-aware questions, and spec capture

/done - Session Completion & Context Capture

/focus - Single-Task Mode

Generate insights report from session facets data with friction patterns, goal categories, and CLAUDE.md suggestions

/next - Decision Support

/recap - Context Restoration

/refine - Prompt Optimizer

Interactive review of spec documents with validation, status updates, and archival

/stuck - Unblock Helper

/task-cancel - Cancel Background Task

/task-output - View Background Task Results

/task-status - Background Task Status

Master API documentation with OpenAPI 3.1, AI-powered tools, and modern developer experience practices. Create interactive docs, generate SDKs, and build comprehensive developer portals. Use PROACTIVELY for API documentation or developer portal creation.

Expert in creating VHS tape files for terminal GIF demos.

Creates comprehensive technical documentation from existing codebases. Analyzes architecture, design patterns, and implementation details to produce long-form technical manuals and ebooks. Use PROACTIVELY for system documentation, architecture guides, or technical deep-dives.

Create Mermaid diagrams for flowcharts, sequences, ERDs, and architectures. Masters syntax for all diagram types and styling. Uses mcp-mermaid for validation and rendering. Use PROACTIVELY for visual documentation, system diagrams, or process flows.

Creates exhaustive technical references and API documentation. Generates comprehensive parameter listings, configuration guides, and searchable reference materials. Use PROACTIVELY for API docs, configuration references, or complete technical specifications.

Creates step-by-step tutorials and educational content from code. Transforms complex concepts into progressive learning experiences with hands-on examples. Use PROACTIVELY for onboarding guides, feature tutorials, or concept explanations.

Enhanced orchestrator with subagent monitoring, mode-aware execution, resilient error handling, and ADHD-optimized status tracking. Use proactively for complex multi-step tasks requiring parallel agent delegation.

Manages background agent delegation, task parallelization, and result synthesis for workflow automation

Write and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes.

Automate changelog generation from commits, PRs, and releases following Keep a Changelog format. Use when setting up release workflows, generating release notes, or standardizing commit conventions.

Classify documentation needs based on code changes

Validate Mermaid diagrams in markdown files for syntax errors, configuration, and health score. Uses mcp-mermaid for full validation and local regex for fast pre-checks.

Generate and maintain OpenAPI 3.1 specifications from code, design-first specs, and validation patterns. Use when creating API documentation, generating SDKs, or ensuring API contract compliance.

This skill should be used when the user asks to "audit guard", "guard friction", "tune guard", "guard false positives", "fix guard blocking", or mentions branch guard configuration issues. Analyzes branch-guard.sh rules and proposes JSON config changes to reduce false positives.

This skill should be used when the user asks to "apply insights", "insights to rules", "update rules from insights", "apply suggestions", or mentions updating CLAUDE.md from insights data. Extracts suggestions from the /insights report and applies them to the global CLAUDE.md via the sync pipeline.

This skill should be used when the user asks to "release", "create a release", "ship it", "publish a new version", "bump version and release", "cut a release", or mentions releasing to GitHub/npm/PyPI. Orchestrates the full release pipeline from pre-flight checks through GitHub release creation.