Skip to content

docs(skills): add kfeatures-release-flow skill#53

Merged
leodido merged 1 commit intomainfrom
skill/release-flow
May 4, 2026
Merged

docs(skills): add kfeatures-release-flow skill#53
leodido merged 1 commit intomainfrom
skill/release-flow

Conversation

@leodido
Copy link
Copy Markdown
Owner

@leodido leodido commented May 4, 2026

A skill that captures the release-cut workflow used in the v0.5.0 cycle, so the next cut does not re-derive it from AGENTS.md and commit history.

Layout

.skills/kfeatures-release-flow/
├── SKILL.md
└── references/
    └── release-cut.md

SKILL.md triggers on phrases like "cut a kfeatures release", "tag vX.Y.Z", "regenerate release notes", "verify a kfeatures download", "GH007".

Content

  • Staged CHANGELOG, commit, push, tag, push workflow with explicit-approval checkpoints at every git mutation, per AGENTS.md.
  • GH007 / noreply identity recovery, with placeholders (<noreply-email>, <username>) and a pointer to .devcontainer/devcontainer.json for the canonical values.
  • PR-label-driven categorized release notes: the .github/workflows/labeler.yml and .github/release.yml coupling, and the recipe for retro-labeling old PRs (gh pr edit --add-label / --remove-label, then GitHub UI > Edit > "Generate release notes" without re-tagging).
  • Cosign keyless verification: the cosign verify-blob --bundle command and the certificate-identity-pins-the-tag detail.

Scope

Release engineering only. Per-PR CLI engineering rules (structcli error contracts, inMCPMode, printJSON, bats coverage matrix) stay in AGENTS.md and CONTRIBUTING.md. If they prove worth extracting later, that goes in a separate skill.

Validation

  • Valid frontmatter (name + description).
  • Name kebab-case, matches folder.
  • Description has what, when, and trigger phrases.
  • No forbidden files (README/CHANGELOG/etc.).
  • Reference file linked from SKILL.md with description of when to read it.
  • SKILL.md under 500 lines.
  • No nested reference subdirs.

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label May 4, 2026
@leodido leodido self-assigned this May 4, 2026
@leodido leodido force-pushed the skill/release-flow branch 2 times, most recently from 8ea28ec to df06d9b Compare May 4, 2026 13:51
Captures the release-cut workflow distilled in the v0.5.0 cycle: the staged CHANGELOG → commit → push → tag → push sequence with explicit-approval checkpoints, GH007 / noreply identity recovery, PR-label-driven categorized release notes (labeler workflow ↔ .github/release.yml coupling, additive-labeler retro-labeling recipe), and cosign keyless verification of published artifacts.

Co-authored-by: Ona <no-reply@ona.com>
@leodido leodido force-pushed the skill/release-flow branch from df06d9b to cfa7bd0 Compare May 4, 2026 13:54
@leodido leodido merged commit 1d80c85 into main May 4, 2026
7 checks passed
@leodido leodido deleted the skill/release-flow branch May 4, 2026 13:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant