Back to list
drillan

release-check

by drillan

1🍴 0📅 Jan 21, 2026

SKILL.md


name: release-check description: > 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. version: 0.0.1 license: MIT compatibility: Requires spec kit artifacts metadata: author: drillan category: quality-gate repository: https://github.com/drillan/speckit-gates

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

Score

Total Score

60/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon