| name | implement-plugin |
| description | Package and distribute Claude Code plugins with schema-safe manifests, canonical layout, component wiring, and release-ready validation. |
Implement Plugin
Implement plugin-level packaging, manifest wiring, structure checks, runtime load checks, and distribution guidance.
Workflow
- Define plugin metadata and distribution scope.
- Update
.claude-plugin/plugin.json and component path mappings.
- Validate manifest and directory structure.
- Verify runtime load with
--plugin-dir and optional install flow.
- Run CI-parity smoke tests before distribution.
Progressive Disclosure
-
Manifest schema and field rules: references/manifest-schema.md
-
Directory conventions and anti-patterns: references/directory-structure.md
-
Test strategy across local/CI: references/testing-strategies.md
-
Distribution checklist and channels: references/plugin-distribution.md
-
Scope and install context guidance: references/plugin-scopes.md
-
Manifest validator: scripts/validate-manifest.sh
-
Layout validator: scripts/check-structure.sh
-
Runtime load check: scripts/test-plugin-load.sh
-
Minimal manifest template: assets/templates/minimal-plugin.json
-
Complete manifest template: assets/templates/complete-plugin.json
-
Manifest with components template: assets/templates/plugin-with-components.json
Multi-Platform Support
A plugin directory can target multiple AI coding assistant platforms simultaneously. Add platform-specific manifest subdirectories alongside .claude-plugin/:
| Platform | Manifest Dir | Required Fields | Platform Skill |
|---|
| Claude Code | .claude-plugin/ | name, version, description | (this skill) |
| Cursor | .cursor-plugin/ | name | ../implement-cursor-plugin/SKILL.md |
| Codex | .codex-plugin/ | name, version, description | ../implement-codex-plugin/SKILL.md |
Shared components (skills/, .mcp.json) live at the plugin root and are reused across all platforms that support them.
Validate all platforms at once:
./integration_tests/run.sh --manifest-only --verbose
Component Skills
- Hooks:
../implement-hooks/SKILL.md
- Agent Skills:
../implement-agent-skills/SKILL.md
- Sub-Agents:
../implement-sub-agents/SKILL.md
- Agent Teams:
../implement-agent-teams/SKILL.md
- Cursor plugins:
../implement-cursor-plugin/SKILL.md
- Codex plugins:
../implement-codex-plugin/SKILL.md
- Umbrella selection guide:
../implement-claude-extensions/SKILL.md
Sources