| name | review-plugin-submission |
| description | Audit a Kodik plugin for marketplace readiness. Use when validating manifests, component metadata, discovery paths, and submission quality before publishing. |
Review plugin submission
Trigger
A plugin is implemented and needs a final quality check before submission or release.
Workflow
- Verify manifest validity:
.kodik-plugin/plugin.json exists
id is valid lowercase kebab-case and matches the folder name
- manifest uses only the flat v1 fields:
schemaVersion, id, version, title, description, category, icon, author, homepageUrl, sourceUrl, tags, prompts, userConfig
- no import-only fields such as
originalAuthor, sourceMarketplace, keywords, repository, license, or interface
- Verify component discoverability:
- Skills in
skills/*/SKILL.md
- Rules in
rules/*.md
- Agents in
agents/ markdown files
- Commands in
commands/*.md
- Hooks in
hooks/hooks.json
- MCP config in root
.mcp.json with a top-level servers object
- Verify component metadata:
- Skills include
name and description frontmatter
- Rules include valid frontmatter and clear guidance
- Agents and commands include
name and description
- Verify repository integration:
- For marketplace repos, plugin entry exists in
.kodik-plugin/marketplace.json
source resolves to plugin directory and names are unique
- Verify documentation quality:
homepageUrl and sourceUrl point to useful destinations
icon is ./assets/app-icon.svg, SVG-only, and contains no embedded raster image data
Checklist
- Manifest exists and parses as valid JSON
- Manifest uses the exact flat v1 field set
- No broken file references
- No missing frontmatter on skills/rules/agents/commands
- Plugin scope is clear and focused
- Marketplace registration complete (if multi-plugin repo)
Output
- Pass/fail report by section
- Prioritized fix list
- Final submission recommendation