release-notes-generator

Drafts evidence-cited release notes and assesses a seven-rung maturity ladder for shipped roadmap slices.

2|Updated Jun 22, 2026
One-click install
npx skills add https://github.com/Kemetra/Seshat-BI --skill release-notes-generator-kemetra
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: release-notes-generator
Source: https://github.com/Kemetra/Seshat-BI/tree/main/.claude/skills/release-notes-generator
Command: npx skills add https://github.com/Kemetra/Seshat-BI --skill release-notes-generator-kemetra

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a roadmap milestone ships, there is no durable, reviewable record of what became possible in that release or how mature the kit's capabilities actually are. This Skill reads committed evidence and drafts a per-release note plus an evidence-gated maturity report, without inventing confidence scores or self-approving anything. ## Core Features & Use Cases - Seven-block release notes: Drafts what became possible, what changed, readiness stages affected, new modules/adapters, known limitations, migration notes, and the next best slice, with every capability claim citing committed evidence. - Binary maturity ladder (L0-L6): Assesses seven rungs from docs-only to an official Power BI execution adapter, reporting the highest rung whose required evidence all exists and naming missing artifacts for the rest. - Honesty guardrails: Refuses numeric maturity scores, production-ready claims without evidence, self-approval of releases, and any re-measurement (no validators, no DB connections, no re-running checks). - Use Case: After shipping roadmap slice F033, ask for the release notes; the Skill reads the F028 evidence pack, F032 compatibility matrix, and roadmap ledger, drafts the note as status draft, reports the current level (e.g., L1), and stops for the named release owner to approve. ## Quick Start Ask the agent to generate the release notes and assess the kit's maturity level for the roadmap slice that just shipped.

Frequently Asked Questions about release-notes-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate release notes for a shipped roadmap slice?▼

Ask the agent to generate the release notes for the shipped F-numbered slice. The Skill reads the committed evidence pack, compatibility matrix, and roadmap ledger, then drafts the seven required blocks with every capability claim cited, leaving the note in draft status for a named release owner.

How is the kit maturity level assessed?▼

Maturity is assessed against seven binary rungs, L0 through L6, where each rung passes only if its required evidence exists on disk. The reported level is the highest rung whose evidence all exists; higher rungs are reported not achieved with the missing artifact named.

Can the skill give a numeric maturity score out of 100?▼

No. The skill declines any request for a percentage, average, or numeric confidence score, citing the no-fake-confidence rule. It returns the per-rung verdicts with cited evidence instead, since the ladder is milestones, not a score.

Does the release notes generator re-run validation or connect to the database?▼

No. It only reads committed evidence such as the evidence pack, compatibility matrix, and roadmap ledger. It never runs seshat check, profiles sources, opens database connections, or reads powerbi outputs; missing inputs are recorded as evidence not available.

Can the skill approve a release or publish it?▼

No. Approval, level confirmation, tagging, and publishing are named-human actions under Core Authority. The skill always leaves the note as status draft and records approval only when a named release owner is listed in the approvals field.

What happens when the compatibility matrix disagrees with the repo contents?▼

The skill records the disagreement as a finding and does not resolve it or pick a side. For example, if the matrix claims an adapter interoperates but no adapter exists in-repo, the conflict is surfaced for the human owner to decide.