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 }}*