# Implement Plugin > Package and distribute Claude Code plugins with schema-safe manifests, canonical layout, component wiring, and release-ready validation. Use when this capability is needed. - Skill: `tomevault-io/implement-plugin` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/implement-plugin` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/implement-plugin/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Web & Frontend - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/implement-plugin --- # Implement Plugin Implement plugin-level packaging, manifest wiring, structure checks, runtime load checks, and distribution guidance. ## Workflow 1. Define plugin metadata and distribution scope. 2. Update `.claude-plugin/plugin.json` and component path mappings. 3. Validate manifest and directory structure. 4. Verify runtime load with `--plugin-dir` and optional install flow. 5. Run CI-parity smoke tests before distribution. ## Project-Specific Patterns (dbt-heros) When working in this repository: ### Pre-Implementation Checklist - Review `CLAUDE.md` for architectural philosophy and safety requirements - Check repository rules in `.claude/rules/` (auto-loaded context) - Review related ADRs in `docs/adr/` for architectural decisions - Verify safety mode enforcement is planned if plugin has destructive tools ### Plugin Structure Requirements - Follow canonical layout (see `.claude/rules/plugin-patterns.md`) - Use lowercase-with-hyphens naming (e.g., `lightdash-development`) - Include safety hooks for any destructive tools (see ADR-0005) - Place plugin-specific components in `plugins/{name}/` - Place shared components in `.claude/skills/` (not in plugin directories) ### Safety Mode Integration If the plugin includes destructive operations: 1. Define safety mode requirements in tool descriptions 2. Add PreToolUse hooks in `hooks/hooks.json` 3. Implement deterministic safety checks (not just LLM prompts) 4. Document safety modes in plugin README ### Testing Requirements Before finalizing plugin: - Run `make format` and `make lint` - Run `make test-integration-docker` successfully - Validate manifest: `./integration_tests/validate-manifest.sh` - Test plugin loading: `./integration_tests/test-plugin-loading.sh` - Document test evidence ### Documentation Requirements - Create/update plugin README in `plugins/{name}/README.md` - Add entry to main `README.md` plugin table - Create plugin documentation in `docs/plugins/` - Create ADR if plugin introduces new architectural patterns ### Monorepo Coordination - Check if other plugins have similar patterns (avoid duplication) - Consider extracting shared logic to `.claude/skills/` - Verify symlink topology remains intact (`.agents/skills`, `.claude/agents`) - Ensure plugin works independently (no tight coupling to other plugins) ## 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` ## 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` - Umbrella selection guide: `../implement-claude-extensions/SKILL.md` ## Sources - https://code.claude.com/docs/en/plugins - https://code.claude.com/docs/en/plugins-reference --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/yu-iskw) — claim your Tome and manage your conversions.