diff --git a/plugins/plugin-dev/skills/plugin-structure/README.md b/plugins/plugin-dev/skills/plugin-structure/README.md deleted file mode 100644 index 236dd27..0000000 --- a/plugins/plugin-dev/skills/plugin-structure/README.md +++ /dev/null @@ -1,108 +0,0 @@ -# Plugin Structure Skill - -Comprehensive guidance on Claude Code plugin architecture, directory layout, and best practices. - -## Overview - -This skill provides detailed knowledge about: -- Plugin directory structure and organization -- `plugin.json` manifest configuration -- Component organization (commands, agents, skills, hooks) -- Auto-discovery mechanisms -- Portable path references with `${CLAUDE_PLUGIN_ROOT}` -- File naming conventions - -## Skill Structure - -### SKILL.md (1,654 words) - -Core skill content covering: -- Directory structure overview -- Plugin manifest (plugin.json) fields -- Component organization patterns -- ${CLAUDE_PLUGIN_ROOT} usage -- File naming conventions -- Auto-discovery mechanism -- Best practices -- Common patterns -- Troubleshooting - -### References - -Detailed documentation for deep dives: - -- **manifest-reference.md**: Complete `plugin.json` field reference - - All field descriptions and examples - - Path resolution rules - - Validation guidelines - - Minimal vs. complete manifest examples - -- **component-patterns.md**: Advanced organization patterns - - Component lifecycle (discovery, activation) - - Command organization patterns - - Agent organization patterns - - Skill organization patterns - - Hook organization patterns - - Script organization patterns - - Cross-component patterns - - Best practices for scalability - -### Examples - -Three complete plugin examples: - -- **minimal-plugin.md**: Simplest possible plugin - - Single command - - Minimal manifest - - When to use this pattern - -- **standard-plugin.md**: Well-structured production plugin - - Multiple components (commands, agents, skills, hooks) - - Complete manifest with metadata - - Rich skill structure - - Integration between components - -- **advanced-plugin.md**: Enterprise-grade plugin - - Multi-level organization - - MCP server integration - - Shared libraries - - Configuration management - - Security automation - - Monitoring integration - -## When This Skill Triggers - -Claude Code activates this skill when users: -- Ask to "create a plugin" or "scaffold a plugin" -- Need to "understand plugin structure" -- Want to "organize plugin components" -- Need to "set up plugin.json" -- Ask about "${CLAUDE_PLUGIN_ROOT}" usage -- Want to "add commands/agents/skills/hooks" -- Need "configure auto-discovery" help -- Ask about plugin architecture or best practices - -## Progressive Disclosure - -The skill uses progressive disclosure to manage context: - -1. **SKILL.md** (~1,650 words): Core concepts and workflows -2. **References** (~2,900 words): Detailed field references and patterns -3. **Examples** (~4,000 words): Complete working examples - -Claude loads references and examples only as needed based on the task. - -## Related Skills - -This skill works well with: -- **hook-development**: For creating plugin hooks -- **mcp-integration**: For integrating MCP servers (when available) -- **marketplace-publishing**: For publishing plugins (when available) - -## Maintenance - -To update this skill: -1. Keep SKILL.md lean and focused on core concepts -2. Move detailed information to references/ -3. Add new examples/ for common patterns -4. Ensure all documentation uses imperative/infinitive form