marketplace-devlisted
Install: claude install-skill app-vitals/shipwright
# Marketplace Development Guide
This skill encodes the conventions and checklists for working with the `shipwright` plugin
in this self-hosted single-plugin marketplace. Follow it to prevent version drift and
maintain consistency.
## When This Activates
- Bumping the plugin version (new feature, bug fix, breaking change)
- Adding or modifying commands, skills, agents, or hooks
- Editing `plugins/shipwright/.claude-plugin/plugin.json`
- Editing `.claude-plugin/marketplace.json` (once it exists — see MKT-1.2)
- Updating plugin descriptions or README content
- Creating or reviewing PRs that touch `plugins/shipwright/`
---
## Version Ownership
**This is the most important section.** Version in this repo is owned by **semantic-release**
and **`scripts/sync-version.ts`** — do NOT manually bump version numbers.
### How Versioning Works
Versions are determined automatically on every merge to `main`:
1. **semantic-release** analyzes conventional commits since the last tag
2. It calls `scripts/sync-version.ts <nextVersion>` via `prepareCmd` in `.releaserc.json`
3. `sync-version.ts` writes the new version to **five locations**:
| # | File | Updated by |
|---|------|------------|
| 1 | `package.json` | `sync-version.ts` |
| 2 | `plugins/shipwright/package.json` | `sync-version.ts` |
| 3 | `metrics/package.json` | `sync-version.ts` |
| 4 | `agent/package.json` | `sync-version.ts` |
| 5 | `version.txt` | `sync-version.ts` |
A sixth location, `.claude-plugin/marketplace.json`, wi