write_documentation

Write Plugin Documentation

You are tasked with generating comprehensive documentation for all plugins in this marketplace.

Process:

1. Read the marketplace configuration:

   • Read .claude-plugin/marketplace.json to get the list of all plugins
   • Extract plugin metadata: name, description, version, author, category

2. For each plugin, gather information:

   • Read all command files from {plugin}/commands/*.md
   • Read all agent files from {plugin}/agents/*.md
   • Extract frontmatter metadata where available (description, model, etc.)
   • Extract command/agent names, descriptions, and key features from content

3. Generate documentation file for each plugin:

   • Create docs/{plugin-name}.md for each plugin

   • Use the existing docs/humanlayer.md as a reference format

   • Include:

     • Plugin overview with metadata (category, version, author)
     • Commands section with usage examples
     • Agents section (if applicable) with use cases
     • Requirements section (if applicable)

   • Format:

     # {Plugin Name} Plugin
     
     **Category:** {category}
     **Version:** {version}
     **Author:** {author}
     
     {description}
     
     ## Commands
     
     ### `/{command-name}`
     
     {Description from frontmatter or content}
     
     **Features:**
     - {List key features extracted from content}
     
     **Usage:**
     ```bash
     /{command-name} [args]
     

     ---

     Agents

     {agent-name}

     {Description}

     Use when you need to:

     • {Use cases}

     Tools: {List from frontmatter if available}

     ---

     Requirements

     {Any special requirements or setup needed}

4. Update README.md:

   • Read the current README.md
   • Update the "Available Plugins" section to include ALL plugins
   • For each plugin:
     • Add a subsection with plugin name
     • Add a link to its documentation: **[Full Documentation →](docs/{plugin-name}.md)**
     • Add a quick overview listing main commands and agents
   • Ensure formatting is consistent
   • Preserve existing content structure