name: help description: Show available commands and skills in this plugin with usage information

Help Skill

Display help information for the personal-plugin commands and skills.

IMPORTANT: This skill must be updated whenever commands or skills are added, changed, or removed from this plugin.

Usage

/help                          # Show all commands and skills
/help <command-name>           # Show detailed help for a specific command

Mode 1: List All (no arguments)

When invoked without arguments, display this table:

personal-plugin Commands and Skills
===================================

COMMANDS
--------
| Command | Description |
|---------|-------------|
| /analyze-transcript | Meeting transcript to structured markdown report |
| /ask-questions | Interactive Q&A session from questions JSON file |
| /assess-document | Document quality evaluation with scored assessment report |
| /bump-version | Automate version bumping across plugin files with CHANGELOG placeholder |
| /check-updates | Check for available plugin updates by comparing installed versions to... |
| /clean-repo | Comprehensive repository cleanup, organization, and documentation refresh |
| /consolidate-documents | Analyze multiple document variations and synthesize a superior consolidated... |
| /convert-hooks | Convert plugin hook bash scripts to PowerShell for Windows compatibility |
| /convert-markdown | Convert a markdown file to a nicely formatted Microsoft Word document |
| /create-plan | Generate detailed IMPLEMENTATION_PLAN.md from requirements documents (BRD,... |
| /define-questions | Extract questions and open items from documents to JSON |
| /develop-image-prompt | Generate detailed image generator prompts from content, optimized for 11x17... |
| /finish-document | Extract questions from a document, answer them interactively, and update the... |
| /implement-plan | Execute IMPLEMENTATION_PLAN.md using orchestrated subagents with automatic... |
| /new-command | Generate a new command file from a template with proper structure and... |
| /new-skill | Generate a new skill file with proper nested directory structure and required... |
| /plan-improvements | Analyze codebase and generate prioritized improvement recommendations with... |
| /plan-next | Analyze repo and recommend the next logical action |
| /remove-ip | Sanitize documents by removing company identifiers and non-public... |
| /review-arch | Quick architectural audit with technical debt assessment (read-only, no... |
| /review-pr | Structured PR review with security, performance, and code quality analysis |
| /scaffold-plugin | Create a new plugin with proper directory structure, metadata, and starter files |
| /setup-statusline | Custom status line setup (Windows/PowerShell) |
| /test-project | Ensure 90%+ test coverage, run all tests with sub-agents, fix failures, then... |
| /validate-plugin | Validate plugin structure, frontmatter, and content for consistency and... |

SKILLS
------
| Skill | Description |
|-------|-------------|
| /help | Show available commands and skills in this plugin with usage information |
| /research-topic | Orchestrate parallel deep research across multiple LLM providers and synthesize results |
| /ship | Create branch, commit, push, open PR, auto-review, fix issues, and merge |
| /validate-and-ship | Validate plugins, clean repository, and ship changes in one automated workflow |
| /visual-explainer | Transform text or documents into AI-generated images that explain concepts visually |

---
Use '/help <name>' for detailed help on a specific command or skill.

Mode 2: Detailed Help (with argument)

When invoked with a command or skill name, read the corresponding file and display:

Description - From frontmatter
Arguments - From "Input Validation" section if present
Output - What the command produces
Example - Usage example

Command Reference

Use this reference to provide detailed help. Read the actual command file to get the most accurate information.

/analyze-transcript

Description: Meeting transcript to structured markdown report Arguments: [--format [md|json]] Output: Generated output file Example:

/analyze-transcript meeting-notes.txt
/analyze-transcript transcript.md --format json

/ask-questions

Description: Interactive Q&A session from questions JSON file Arguments: [--force] Output: Generated output file Example:

/ask-questions questions-PRD-20260110.json

/assess-document

Description: Document quality evaluation with scored assessment report Arguments: [--format [md|json]] Output: Files in reports/ Example:

/assess-document
/assess-document PRD.md

/bump-version

Description: Automate version bumping across plugin files with CHANGELOG placeholder Arguments: [--dry-run] Output: In-conversation output Example:

/bump-version personal-plugin minor    # 1.6.0 -> 1.7.0
/bump-version bpmn-plugin patch        # 1.5.0 -> 1.5.1
/bump-version personal-plugin major    # 1.6.0 -> 2.0.0

/check-updates

Description: Check for available plugin updates by comparing installed versions to... Arguments: [--verbose] Output: Generated output file Example:

/check-updates --verbose

/clean-repo

Description: Comprehensive repository cleanup, organization, and documentation refresh Arguments: [--dry-run] [--audit] [--docs-only] Output: In-conversation report with cleanup summary Example:

/clean-repo                    # Full cleanup with documentation sync
/clean-repo --docs-only        # Focus only on documentation updates
/clean-repo --dry-run          # Preview changes without executing

/consolidate-documents

Description: Analyze multiple document variations and synthesize a superior consolidated... Arguments: [doc3-path...] Output: consolidated-[topic]-YYYYMMDD-HHMMSS.md Example:

/consolidate-documents draft-v1.md draft-v2.md
/consolidate-documents spec-a.md spec-b.md spec-c.md
/consolidate-documents requirements-old.md requirements-new.md updates.md

/convert-markdown

Description: Convert a markdown file to a nicely formatted Microsoft Word document Arguments: [] Output: In-conversation output Example:

/convert-markdown requires pandoc for document conversion.

/convert-hooks

Description: Convert plugin hook bash scripts to PowerShell for Windows compatibility Arguments: [--dry-run] [--verbose] [--list] Output: PowerShell scripts and updated hooks.json Example:

/convert-hooks ralph-wiggum           # Convert hooks for a plugin
/convert-hooks my-plugin --dry-run    # Preview changes
/convert-hooks --list                 # Show plugins with hooks

/create-plan

Description: Generate detailed IMPLEMENTATION_PLAN.md from requirements documents (BRD, PRD, TDD, design specs) Arguments: [] [--output ] [--phases ] [--verbose] Output: IMPLEMENTATION_PLAN.md in repository root Example:

/create-plan                              # Auto-discover documents
/create-plan PRD.md TDD.md               # Use specific documents
/create-plan --phases 5                   # Target 5 phases

/define-questions

Description: Extract questions and open items from documents to JSON Arguments: [--format [json|csv]] Output: Generated output file Example:

/define-questions
/define-questions PRD.md

/develop-image-prompt

Description: Generate detailed image generator prompts from content, optimized for 11x17... Arguments: [--style ] Output: Generated output file Example:

/develop-image-prompt architecture.md
/develop-image-prompt process-flow.md --style brand-guidelines.md
/develop-image-prompt "microservices communication patterns"

/finish-document

Description: Extract questions from a document, answer them interactively, and update the... Arguments: [--auto] [--force] Output: Generated output file Example:

/finish-document PRD.md
/finish-document
/finish-document PRD.md

/implement-plan

Description: Execute IMPLEMENTATION_PLAN.md using orchestrated subagents with automatic testing, documentation, and git workflow Arguments: None required Output: Updates IMPLEMENTATION_PLAN.md, PROGRESS.md, LEARNINGS.md; creates and merges PR Example:

/implement-plan

/new-command

Description: Generate a new command file from a template with proper structure and... Arguments: [] [] Output: plugins/personal-plugin/commands/[command-name].md Example:

/new-command

/new-skill

Description: Generate a new skill file with proper nested directory structure and required frontmatter Arguments: [] Output: plugins/personal-plugin/skills/[skill-name]/SKILL.md Example:

/new-skill                    # Interactive mode
/new-skill quick-test         # With skill name

Key Differences from /new-command:

Creates nested directory: skills/[name]/SKILL.md
Includes required name field in frontmatter
Skills are for proactive suggestions, commands are user-initiated

/plan-improvements

Description: Analyze codebase and generate prioritized improvement recommendations with... Arguments: None required Output: Generated output file Example:

/plan-improvements

/plan-next

Description: Analyze repo and recommend the next logical action Arguments: None required Output: Generated output file Example:

/plan-next

/remove-ip

Description: Sanitize documents by removing company identifiers and non-public... Arguments: [--company ] [--mode [standard|strict]] Output: Generated output file Example:

/remove-ip internal-process.md
/remove-ip strategy-doc.md --mode strict
/remove-ip playbook.md --company "Acme Corp" --industry "Finance"

/review-arch

Description: Quick architectural audit with technical debt assessment (read-only, no... Arguments: None required Output: In-conversation output Example:

/review-arch

/review-pr

Description: Structured PR review with security, performance, and code quality analysis Arguments: Output: In-conversation output Example:

/review-pr 123                                    # Review PR #123
/review-pr https://github.com/owner/repo/pull/42 # Review from URL

/scaffold-plugin

Description: Create a new plugin with proper directory structure, metadata, and starter files Arguments: [] Output: plugins/[plugin-name]/.claude-plugin/plugin.json Example:

/scaffold-plugin

/setup-statusline

Description: "[Personal] Troy's custom status line setup (Windows/PowerShell)" Arguments: None required Output: In-conversation output Example:

/setup-statusline

/test-project

Description: Ensure 90%+ test coverage, run all tests with sub-agents, fix failures, then... Arguments: None required Output: In-conversation output Example:

/test-project

/validate-plugin

Description: Validate plugin structure, frontmatter, and content for consistency and... Arguments: [--all] [--fix] [--verbose] Output: In-conversation output Example:

/validate-plugin personal-plugin          # Validate single plugin
/validate-plugin --all                    # Validate all plugins
/validate-plugin bpmn-plugin --verbose    # Detailed output

/help

Description: Show available commands and skills in this plugin with usage information Arguments: None required Output: In-conversation output Example:

/help                          # Show all commands and skills
/help <command-name>           # Show detailed help for a specific command

/research-topic

Description: Orchestrate parallel deep research across multiple LLM providers and synthesize results Arguments: [--sources <claude,openai,gemini>] [--depth <brief|standard|comprehensive>] [--format <md|docx|both>] [--no-clarify] [--no-audience] Output: reports/research-[topic]-YYYYMMDD-HHMMSS.md and .docx Features:

Detects audience profile from CLAUDE.md files (project/local/global)
Interactive API key setup wizard if .env missing
Creates .env file with collected keys Example:

/research-topic What are the best practices for implementing RAG systems?
/research-topic --sources claude,openai --depth comprehensive "Compare transformer architectures"
/research-topic --depth brief --no-clarify --no-audience "Current state of quantum computing"

/ship

Description: Create branch, commit, push, open PR, auto-review, fix issues, and merge Arguments: [] [draft] [--dry-run] [--audit] Output: Generated output file Example:

/ship

/validate-and-ship

Description: Validate plugins, clean repository, and ship changes in one automated workflow Arguments: [--skip-validate] [--skip-cleanup] [--dry-run] [] Output: In-conversation output with PR URL on success Example:

/validate-and-ship                      # Full workflow: validate → cleanup → ship
/validate-and-ship feat/my-feature      # With custom branch name
/validate-and-ship --dry-run            # Preview all phases without executing
/validate-and-ship --skip-validate      # Skip validation, run cleanup and ship

Workflow:

Phase 1: Run /validate-plugin --all (stops on errors, continues on warnings)
Phase 2: Run /clean-repo (auto-executes artifact cleanup)
Phase 3: Run /ship (full git workflow with auto-review and merge)

/visual-explainer

Description: Transform text or documents into AI-generated images that explain concepts visually Arguments: [--style ] [--output-dir ] [--max-iterations ] [--pass-threshold <0-1>] [--image-count ] [--aspect-ratio ] [--resolution ] [--no-cache] [--dry-run] [--resume ] [--setup-keys] Output: visual-explainer-[topic]-[timestamp]/ directory with images, metadata, and summary Features:

Uses Gemini Pro 3 for 4K image generation
Claude Sonnet Vision for quality evaluation
Iterative refinement with escalating strategies
Checkpoint/resume for long-running generations
Interactive mode for style and image count selection Example:

/visual-explainer "How does photosynthesis work?"
/visual-explainer architecture.md --style professional-sketch --image-count 5
/visual-explainer --resume checkpoint.json
/visual-explainer --dry-run "Explain microservices patterns"

Error Handling

If the requested command is not found:

Command '[name]' not found in personal-plugin.

Available commands:
  /analyze-transcript, /ask-questions, /assess-document, /bump-version, /check-updates, /clean-repo, /consolidate-documents, /convert-hooks, /convert-markdown, /create-plan, /define-questions, /develop-image-prompt, /finish-document, /implement-plan, /new-command, /new-skill, /plan-improvements, /plan-next, /remove-ip, /review-arch, /review-pr, /scaffold-plugin, /setup-statusline, /test-project, /validate-plugin

Available skills:
  /help, /research-topic, /ship, /validate-and-ship, /visual-explainer

help

SKILL.md