Swiftmade Claude Code plugins

Working methods we use often enough to want them written down, packaged so Claude Code can load them in any project.

Install

/plugin marketplace add swiftmade/claude-plugins
/plugin install swiftmade@swiftmade

Then restart Claude Code. Everything in the plugin is namespaced under swiftmade: — /swiftmade:pre-ship-review, and so on.

To update later: /plugin marketplace update swiftmade.

What's in it

swiftmade:pre-ship-review	Reviews a change across several narrow angles derived from what it touches, ending on what a person will misread. Leans on the built-in /code-review and /simplify for the correctness and quality passes.

Layout

.claude-plugin/marketplace.json     lists the plugins in this repo
plugins/
  swiftmade/
    .claude-plugin/plugin.json      name, version, author
    skills/<name>/SKILL.md          a skill
    commands/<name>.md              a slash command
    agents/<name>.md                a subagent
    hooks/hooks.json                hooks

Only skills/ exists today. The other directories are picked up if you add them — nothing needs registering.

Adding a skill

Drop a directory into plugins/swiftmade/skills/, containing a SKILL.md that opens with frontmatter:

---
name: my-skill
description: What it does, and when Claude should reach for it. This is
  the only part Claude reads when deciding whether the skill applies,
  so write the trigger conditions into it rather than just the topic.
---

Bump version in plugins/swiftmade/.claude-plugin/plugin.json, then:

claude plugin validate . --strict

Nothing else to register — skills are discovered from the directory.

Adding a separate plugin

Give it its own directory under plugins/ with its own .claude-plugin/plugin.json, and add an entry to the plugins array in .claude-plugin/marketplace.json pointing at ./plugins/<name>. Worth doing when something should be installable on its own rather than arriving with everything else.

Testing a change before pushing

Point a marketplace at the working copy instead of the published repo:

/plugin marketplace add ./path/to/this/repo

If claude plugin eval is enabled on your account, claude plugin eval init will scaffold cases that run with and without the plugin, so a change can be measured rather than assumed.

License

MIT