Initial commit

skills/documentation-update/assets/agent-skills.md.j2

@@ -0,0 +1,73 @@
+# Agent Skills Reference
+
+This document catalogs all agent skills with progressive disclosure patterns across the marketplace.
+
+## Overview
+
+- **Total Skills**: {{ stats.total_skills }}
+- **Total Plugins**: {{ stats.total_plugins }}
+- **Last Updated**: {{ now }}
+
+---
+
+## What are Agent Skills?
+
+Agent skills are modular knowledge packages that use progressive disclosure architecture:
+
+1. **Metadata** (Frontmatter) - Always loaded
+2. **Instructions** - Core guidance loaded when activated
+3. **Resources** (assets/) - Loaded on demand
+
+All skills follow the [Anthropic Agent Skills Specification](https://github.com/anthropics/skills/blob/main/agent_skills_spec.md).
+
+---
+
+{% for plugin in marketplace.plugins %}
+## {{ plugin.name }}
+
+**Description**: {{ plugin.description }}
+
+**Version**: {{ plugin.version }}
+
+{% if plugin.skills %}
+**Skills**:
+
+{% for skill in all_skills %}
+{% if skill.plugin == plugin.name %}
+### {{ skill.name }}
+
+{{ skill.description }}
+
+**Location**: `plugins/{{ plugin.name }}/skills/{{ skill.path }}/`
+
+**Structure**:
+- `SKILL.md` - Skill definition with frontmatter
+- `assets/` - Templates, configurations, examples
+- `references/` - Additional documentation
+
+{% endif %}
+{% endfor %}
+{% else %}
+*No skills defined*
+{% endif %}
+
+---
+
+{% endfor %}
+
+## Progressive Disclosure Benefits
+
+- **Token Efficiency**: Load only relevant knowledge when needed
+- **Specialized Expertise**: Deep domain knowledge without bloat
+- **Clear Activation**: Explicit triggers prevent unwanted invocation
+- **Composability**: Mix and match skills across workflows
+- **Maintainability**: Isolated updates don't affect other skills
+
+## Using Skills
+
+Skills are automatically invoked by agents when their trigger conditions are met. You can also manually invoke skills when needed for specific operations.
+
+---
+
+*This documentation is automatically generated from the marketplace catalog.*
+*Last updated: {{ now }}*

skills/documentation-update/assets/agents.md.j2

@@ -0,0 +1,64 @@
+# Agent Reference
+
+This document provides a comprehensive reference of all agents available across plugins in the marketplace.
+
+## Overview
+
+- **Total Agents**: {{ stats.total_agents }}
+- **Total Plugins**: {{ stats.total_plugins }}
+- **Last Updated**: {{ now }}
+
+---
+
+{% for category, plugins in plugins_by_category.items() %}
+## {{ category|title }} Agents
+
+{% for plugin in plugins %}
+### {{ plugin.name }}
+
+**Description**: {{ plugin.description }}
+
+**Version**: {{ plugin.version }}
+
+{% if plugin.agents %}
+**Agents**:
+
+{% for agent in all_agents %}
+{% if agent.plugin == plugin.name %}
+#### {{ agent.name }}
+
+- **Model**: `{{ agent.model }}`
+- **Description**: {{ agent.description }}
+- **Location**: `plugins/{{ plugin.name }}/agents/{{ agent.file }}`
+
+{% endif %}
+{% endfor %}
+{% else %}
+*No agents defined*
+{% endif %}
+
+---
+
+{% endfor %}
+{% endfor %}
+
+## Usage
+
+To use an agent from the command line:
+
+```bash
+# Invoke with Task tool
+Use Task tool with subagent_type="<agent-name>"
+```
+
+## Model Distribution
+
+Agents are optimized for specific models based on their complexity:
+
+- **Haiku**: Fast execution for deterministic tasks
+- **Sonnet**: Complex reasoning and architecture decisions
+
+---
+
+*This documentation is automatically generated from the marketplace catalog.*
+*Last updated: {{ now }}*

skills/documentation-update/assets/plugins.md.j2

@@ -0,0 +1,88 @@
+# Plugin Directory
+
+Complete catalog of all plugins available in the marketplace.
+
+## Overview
+
+- **Total Plugins**: {{ stats.total_plugins }}
+- **Total Agents**: {{ stats.total_agents }}
+- **Total Commands**: {{ stats.total_commands }}
+- **Total Skills**: {{ stats.total_skills }}
+- **Last Updated**: {{ now }}
+
+---
+
+{% for category, plugins in plugins_by_category.items() %}
+## {{ category|title }}
+
+{% for plugin in plugins %}
+### {{ plugin.name }}
+
+{{ plugin.description }}
+
+**Version**: {{ plugin.version }}
+
+**Author**: {% if plugin.author %}{{ plugin.author.name }}{% else %}{{ marketplace.owner.name }}{% endif %}
+
+**License**: {{ plugin.license }}
+
+{% if plugin.keywords %}
+**Keywords**: {{ plugin.keywords|join(', ') }}
+{% endif %}
+
+**Components**:
+{% if plugin.agents %}
+- **Agents**: {{ plugin.agents|length }}
+{% endif %}
+{% if plugin.commands %}
+- **Commands**: {{ plugin.commands|length }}
+{% endif %}
+{% if plugin.skills %}
+- **Skills**: {{ plugin.skills|length }}
+{% endif %}
+
+**Location**: `{{ plugin.source }}`
+
+{% if plugin.homepage %}
+**Homepage**: {{ plugin.homepage }}
+{% endif %}
+
+{% if plugin.repository %}
+**Repository**: {{ plugin.repository }}
+{% endif %}
+
+---
+
+{% endfor %}
+{% endfor %}
+
+## Plugin Architecture
+
+Each plugin follows these principles:
+
+- **Single Responsibility**: One plugin does one thing well
+- **Composability**: Mix and match plugins based on needs
+- **Context Efficiency**: Smaller tools for better LLM performance
+- **Maintainability**: Isolated updates, clear boundaries
+
+## Installation
+
+All plugins are included in this marketplace. To use a plugin:
+
+1. Ensure the plugin directory exists in `plugins/`
+2. Use agents via the Task tool
+3. Use commands via slash commands
+4. Skills are automatically loaded when needed
+
+## Categories
+
+Plugins are organized into the following categories:
+
+{% for category in plugins_by_category.keys() %}
+- **{{ category|title }}**: {{ plugins_by_category[category]|length }} plugin(s)
+{% endfor %}
+
+---
+
+*This documentation is automatically generated from the marketplace catalog.*
+*Last updated: {{ now }}*

skills/documentation-update/assets/usage.md.j2

@@ -0,0 +1,250 @@
+# Usage Guide
+
+Comprehensive guide for using Claude Code plugins, agents, commands, and skills from this marketplace.
+
+## Overview
+
+This marketplace provides {{ stats.total_plugins }} plugin(s) with:
+- {{ stats.total_agents }} specialized agent(s)
+- {{ stats.total_commands }} command(s)
+- {{ stats.total_skills }} skill(s)
+
+**Last Updated**: {{ now }}
+
+---
+
+## Quick Start
+
+### Using Agents
+
+Agents are specialized domain experts invoked via the Task tool:
+
+```
+Use Task tool with subagent_type="<agent-name>"
+```
+
+**Example**:
+```
+Use Task tool with subagent_type="plugin-architect" to design a new plugin
+```
+
+### Using Commands
+
+Commands are slash commands for specific workflows:
+
+```bash
+/<command-name> [arguments]
+```
+
+**Available Commands**:
+
+{% for command in all_commands %}
+- `{{ command.name }}` - {{ command.description }}
+  - Plugin: {{ command.plugin }}
+  - File: `plugins/{{ command.plugin }}/commands/{{ command.file }}`
+{% endfor %}
+
+### Using Skills
+
+Skills are automatically invoked by agents when their trigger conditions are met. Skills provide:
+
+- Modular knowledge packages
+- Progressive disclosure (metadata → instructions → resources)
+- Spec-compliant with Anthropic guidelines
+
+**Available Skills**:
+
+{% for skill in all_skills %}
+- `{{ skill.name }}` - {{ skill.description }}
+  - Plugin: {{ skill.plugin }}
+  - Path: `plugins/{{ skill.plugin }}/skills/{{ skill.path }}/`
+{% endfor %}
+
+---
+
+## Common Workflows
+
+### Creating a New Plugin
+
+Use the `claude-plugin` plugin to create new plugins:
+
+```bash
+# Create a new plugin
+/create <plugin-name> "<description>" [components]
+
+# Example
+/create golang-advanced "Advanced Go development tools" agents,commands,skills
+```
+
+### Updating an Existing Plugin
+
+Modify plugins by adding, updating, or removing components:
+
+```bash
+# Add a new agent
+/update <plugin-name> add agent <agent-name>
+
+# Modify a command
+/update <plugin-name> modify command <command-name>
+
+# Remove a skill
+/update <plugin-name> remove skill <skill-name>
+```
+
+### Working with Agents
+
+Invoke agents for specialized tasks:
+
+```
+# For architecture and design
+Use Task tool with subagent_type="plugin-architect"
+
+# Add your task description
+[Describe what you need the agent to do]
+```
+
+---
+
+## Plugin Architecture
+
+### Directory Structure
+
+```
+plugins/
+├── <plugin-name>/
+│   ├── agents/           # Specialized agents (optional)
+│   │   └── agent.md
+│   ├── commands/         # Slash commands (optional)
+│   │   └── command.md
+│   └── skills/           # Agent skills (optional)
+│       └── skill-name/
+│           ├── SKILL.md
+│           ├── assets/
+│           └── references/
+```
+
+### Component Requirements
+
+Each plugin must have:
+- At least one agent OR one command
+- Proper YAML frontmatter in all files
+- Clear, focused purpose
+- Entry in marketplace.json
+
+---
+
+## Agent Reference
+
+### Available Agents
+
+{% for agent in all_agents %}
+#### {{ agent.name }}
+
+- **Plugin**: {{ agent.plugin }}
+- **Model**: {{ agent.model }}
+- **Description**: {{ agent.description }}
+- **Invocation**: `Use Task tool with subagent_type="{{ agent.name }}"`
+
+{% endfor %}
+
+### Model Selection
+
+Agents use different models based on task complexity:
+
+- **Haiku**: Fast execution for deterministic tasks
+  - Code generation from specs
+  - Test creation
+  - Documentation generation
+
+- **Sonnet**: Complex reasoning and architecture
+  - System design
+  - Security audits
+  - Language expertise
+  - Multi-agent orchestration
+
+---
+
+## Best Practices
+
+### When Creating Plugins
+
+1. **Single Responsibility**: One plugin, one purpose
+2. **Clear Naming**: Use hyphen-case, be descriptive
+3. **Complete Documentation**: Include frontmatter and examples
+4. **Spec Compliance**: Follow Anthropic guidelines
+5. **Test Thoroughly**: Verify functionality before committing
+
+### When Using Agents
+
+1. **Choose the Right Agent**: Match agent expertise to task
+2. **Provide Clear Context**: Detailed task descriptions
+3. **Use Appropriate Models**: Haiku for speed, Sonnet for complexity
+4. **Compose When Needed**: Combine multiple agents for complex workflows
+
+### When Working with Skills
+
+1. **Progressive Disclosure**: Load only what's needed
+2. **Clear Triggers**: Use explicit activation criteria
+3. **Modular Design**: Keep skills focused and reusable
+4. **Document Well**: Include usage examples
+
+---
+
+## Marketplace Management
+
+### Adding Plugins
+
+Plugins are added via the marketplace update process:
+
+1. Create plugin directory and components
+2. Update `.claude-plugin/marketplace.json`
+3. Regenerate documentation
+
+### Updating Documentation
+
+Documentation is automatically generated from the marketplace:
+
+```bash
+# Regenerate all docs
+python plugins/claude-plugin/skills/documentation-update/doc_generator.py
+
+# Generate specific file
+python plugins/claude-plugin/skills/documentation-update/doc_generator.py --file agents
+```
+
+---
+
+## Categories
+
+Plugins are organized by category:
+
+{% for category, plugins in plugins_by_category.items() %}
+### {{ category|title }}
+
+{% for plugin in plugins %}
+- **{{ plugin.name }}** - {{ plugin.description }}
+{% endfor %}
+
+{% endfor %}
+
+---
+
+## Getting Help
+
+- **Documentation**: See `docs/` directory for detailed references
+- **Architecture**: See `docs/architecture.md` for design principles
+- **Contributing**: See `.github/CONTRIBUTING.md` for contribution guidelines
+
+---
+
+## Resources
+
+- [Architecture Documentation](./architecture.md)
+- [Agent Reference](./agents.md)
+- [Skills Reference](./agent-skills.md)
+- [Plugin Directory](./plugins.md)
+
+---
+
+*This documentation is automatically generated from the marketplace catalog.*
+*Last updated: {{ now }}*