| name | promote-check |
| description | Promotion preflight gate for the agent-skills marketplace. Run before promoting a skill from a sandbox plugin to an official one, or before opening a promotion PR, to get a go / no-go verdict. Audit-first: it chains the deterministic skill-audit signals, marketplace/registry alignment, and version + CHANGELOG presence, and BLOCKS (no-go) on any unresolved finding, citing the failing gate. User-invoked only. For fixing what it surfaces use skill-studio:skill-enhance; for the release wiring use repo-governance:skill-maintainer. |
| disable-model-invocation | true |
Promote Check
A user-invoked preflight gate for promoting a skill into an official plugin.
Established policy is audit-first: a promotion must fix everything the audit
surfaces, not just pass a binary. This skill makes that discipline mechanical
and hard to skip — it emits a go / no-go verdict and names the gate that
failed.
It composes existing tooling; it does not re-implement any check. Fixing findings
is skill-studio:skill-enhance; version/CHANGELOG/marketplace wiring and the
actual move is repo-governance:skill-maintainer. This skill only decides
go / no-go.
Apply when
- Deciding whether a candidate skill is ready to graduate from a sandbox plugin
(e.g.
blassioli) to an official one.
- Before opening a promotion PR, as the preflight that must be green first.
Do not apply when
- Authoring or fixing a skill →
skill-studio:skill-create / skill-enhance.
- Doing the version bump / CHANGELOG / marketplace move →
repo-governance:skill-maintainer.
- Auditing for judgment dimensions (archetype fit, description quality) →
skill-studio:skill-audit (this gate consumes only its deterministic signals).
Procedure
Run the deterministic gate against the candidate skill directory:
bash "${CLAUDE_SKILL_DIR}/scripts/promote-check.sh" plugins/<plugin>/skills/<skill>
Read the verdict:
- go — every gate passed. The candidate is clear for the
skill-maintainer
promotion workflow. go is necessary, not sufficient: judgment dimensions
(archetype fit, description quality, real traction) are still the owner's call.
- no-go — one or more gates failed. The output names each failing gate and
the finding. Route the fixes (audit findings →
skill-enhance; drift/version/
changelog → skill-maintainer), then re-run until go.
The gates run in order and every failure is reported (not just the first). See
references/gates.md for exactly what each gate checks, the
exit codes, and the tools it wraps.
Gates
| Gate | Blocks when | Wraps |
|---|
audit | unresolved mechanical finding (name↔folder, orphan/dangling refs, non-exec scripts, relative bundled-script calls, cross-package links, missing/invalid metadata) | skill-studio audit-skill.sh |
alignment | marketplace ↔ plugin.json ↔ metadata ↔ CHANGELOG ↔ registry drift | scripts/marketplace-consistency.sh |
version | metadata.json has no version | — |
changelog | no CHANGELOG.md, or its top entry ≠ metadata version | — |
Confirmation policy
- This gate is read-only and side-effect-free; it never edits, versions, moves,
or promotes anything. Acting on a
go (the actual promotion) is
skill-maintainer and carries its own confirmation policy.
Dependencies
scripts/marketplace-consistency.sh (the alignment gate) and
plugins/skill-studio/.../audit-skill.sh (the audit gate) must exist in the
repo. If either is missing the gate exits non-zero with a clear message rather
than passing silently.
Maintainer validation commands for this skill package live in
README.md.
