skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
drillan/speckit-gates53 installs

release-check

Validates all artifacts are complete and consistent for release. Checks spec kit artifacts, documentation, versioning, and API docs. Run before creating a release to ensure nothing is missing.

How do I install this agent skill?

npx skills add https://github.com/drillan/speckit-gates --skill release-check
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill is a validation utility defined in markdown that instructs an agent to check project artifacts. It is functionally safe as it contains no executable code, but it possesses an inherent surface for indirect prompt injection via the project files it is designed to analyze.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerwarn

    1/2 files flagged

What does this agent skill do?

release-check

Validates release readiness before creating a release.

Purpose

This skill validates that all artifacts are complete and consistent for release:

  • Spec kit artifacts: spec.md, plan.md, tasks.md exist and are complete
  • Documentation: README.md, CHANGELOG.md have required sections
  • Versioning: Version numbers are consistent across package.json and CHANGELOG
  • API docs: API documentation matches contract specifications

Output

The skill outputs a ReleaseChecklist with:

  • Overall readiness status (Ready/Not Ready)
  • Individual check items with pass/fail/skip status
  • Version consistency information
  • Specific issues to address before release

Usage

This is a manual skill - run it before creating a release:

npx skills run release-check

Or via AI agent:

User: Check if we're ready for release

Exit Codes

CodeStatusMeaning
0ReadyAll checks pass
1Not ReadySome checks failed
3ErrorRequired files missing

Checks Performed

Artifact Checks (FR-022)

CheckRequirement
spec.md existsRequired
plan.md existsRequired
tasks.md existsRequired
All tasks completeRequired

Documentation Checks (FR-023)

CheckRequirement
README.md existsRequired
README.md has usage sectionRequired
CHANGELOG.md existsRequired
CHANGELOG.md has unreleased sectionRequired

Version Checks (FR-026)

CheckRequirement
package.json version presentOptional
CHANGELOG.md version presentOptional
Versions matchIf both present

API Checks (FR-025)

CheckRequirement
contracts/ existsOptional
API docs exist if contractsRequired if contracts
Endpoints documentedRequired if contracts

Checklist Output Format

## Release Checklist

**Status**: Ready to Release / Not Ready

### Artifacts
| Status | Check | Details |
|--------|-------|---------|
| [PASS] | spec.md exists | |
| [PASS] | plan.md exists | |
| [FAIL] | All tasks complete | 5 tasks remaining |

### Documentation
| Status | Check | Details |
|--------|-------|---------|
| [PASS] | README.md exists | |
| [SKIP] | API docs | No contracts/ directory |

Recommendations

If release check fails:

  1. Complete all remaining tasks in tasks.md
  2. Ensure README.md has a usage section
  3. Update CHANGELOG.md with release notes
  4. Verify version numbers are consistent
  5. Run release-check again to verify fixes

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/drillan/speckit-gates/release-check">View release-check on skillZs</a>