claude-plugin:documentation

Documentation Generation Command

Regenerate all documentation files (agents.md, agent-skills.md, plugins.md, usage.md) from the marketplace catalog and plugin metadata using Jinja2 templates.

Arguments

• $1 - Specific file to generate: agents, agent-skills, plugins, usage, or all (optional, defaults to all)
• $2 - Additional options as JSON (optional)

Usage

# Regenerate all documentation files
/claude-plugin:documentation

# Regenerate specific file
/claude-plugin:documentation agents

# Dry run to preview changes
/claude-plugin:documentation all '{"dry_run": true}'

# Specify custom paths
/claude-plugin:documentation all '{"marketplace": ".claude-plugins/marketplace.json", "output": "docs"}'

Workflow

This command orchestrates documentation generation by:

1. Validating Prerequisites

   • Verify marketplace.json exists and is valid
   • Check template files exist in documentation-update skill
   • Ensure plugin directories are accessible
   • Verify output directory exists or can be created

2. Preparing Context

   • Load marketplace catalog
   • Scan all plugin directories
   • Extract agent/command/skill metadata
   • Build component indexes
   • Calculate statistics

3. Generating Documentation

   • Invoke documentation-update skill
   • Render Jinja2 templates with context
   • Write output to docs/ directory
   • Report any warnings or errors

4. Verifying Output

   • Check all requested files were generated
   • Verify file formatting and structure
   • Validate links and references
   • Report success and statistics

---

Implementation

Target File: ${1:-"all"} Options: ${2:-"{}"}

Step 1: Validate Prerequisites

Check that all required components exist:

# Check marketplace exists
if [ ! -f .claude-plugins/marketplace.json ]; then
  echo "Error: Marketplace file not found at .claude-plugins/marketplace.json"
  exit 1
fi

# Check skill exists
if [ ! -f plugins/claude-plugin/skills/documentation-update/doc_generator.py ]; then
  echo "Error: Documentation update skill not found"
  exit 1
fi

# Check templates exist
if [ ! -d plugins/claude-plugin/skills/documentation-update/assets ]; then
  echo "Error: Template directory not found"
  exit 1
fi

# Create docs directory if needed
mkdir -p docs