Package Claude Code skills and agents as a plugin

[kdeldycke]

Summary

Repomatic already has 9 skills and 2 agents in .claude/ that follow the exact directory conventions expected by Claude Code plugins. Packaging them as a plugin would let downstream repos install and update them via claude plugin install instead of copying files.

Current state

• 9 skills in .claude/skills/repomatic-*/SKILL.md (init, sync, lint, deps, metadata, test, changelog, release, topics)
• 2 agents in .claude/agents/ (qa-engineer, grunt-qa)
• Both already use the correct file format and directory layout

Proposed changes

1. Create .claude-plugin/plugin.json manifest with metadata (name, version, description, repository URL, keywords)
2. Restructure so skills/ and agents/ are at plugin root level (or keep current paths and reference them via manifest's component path fields)
3. Set up a marketplace (marketplace.json) to make the plugin installable via claude plugin install repomatic@marketplace

What this enables

• Downstream repos get versioned, updatable skills and agents via claude plugin install repomatic --scope project
• Plugin updates propagate to all downstream repos via claude plugin update
• No more stale copies of skills/agents in downstream repos

Out of scope

• CLAUDE.md stays as project-level instructions — it's not part of the plugin system
• No hooks, MCP, or LSP needed currently

References

• Plugins reference
• Plugin marketplaces