warp-release-notes

Use when drafting GitHub release notes for a Warp feature or bugfix release from Towncrier fragments or a tagged final changelog.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-structured workflow skill: copy-paste commands, explicit validation/feedback checkpoints, and clean one-level-deep reference navigation. The only minor weakness is a few rationale passages that could be tightened for token efficiency.

Dimension	Reasoning	Score
Conciseness	Dense and operational, assuming Claude's competence (no padding about what Towncrier/gists/release notes are); rationale paragraphs cover project-specific gotchas that earn their place. Minor sections of explanatory rationale could be trimmed, so it is 'efficient with minor over-explanation' rather than the perfectly lean 5.	4 / 5
Actionability	Provides copy-paste-ready git/gh/uv commands with exact flags and paths (e.g. 'git tag --list ... --sort=-v:refname', 'gh gist edit <id> --filename ...'), a concrete script invocation with arguments, and specific examples covering the common feature/bugfix cases.	5 / 5
Workflow Clarity	Sequences a multi-step process across Phases 1–6 with explicit validation checkpoints — a mandatory user-confirmation gate in Phase 2, abort-if-zero and draft_status checks, a self-audit checklist in 5e, and a feedback loop (new refs re-run Phase 1) — matching the top anchor.	5 / 5
Progressive Disclosure	SKILL.md is an orchestration overview that delegates detail to one-level-deep, clearly signaled reference files (style-rules, contributor-attribution, feature-investigation, the two templates) and a script — all verified to exist — with content appropriately split and easy to navigate.	5 / 5
	Total	19 / 20 Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, concrete description with an explicit trigger clause covering both what and when, scoped to a distinct Warp-specific niche. Slightly short of maximal specificity and trigger-term synonym coverage, but well above the midpoint.

Dimension	Reasoning	Score
Specificity	Names the domain ('GitHub release notes for a Warp feature or bugfix release') and concrete input sources ('Towncrier fragments or a tagged final changelog'), listing several specific actions/sources with only minor coverage gaps — fits the 'several specific actions; minor gaps' anchor rather than the 3 (1-2 actions) or the comprehensive 5.	4 / 5
Completeness	Explicitly answers both what ('drafting GitHub release notes ... from Towncrier fragments or a tagged final changelog') and when via a concrete 'Use when ...' trigger clause, satisfying the top anchor; the Use when clause is present so it is not capped at 3.	5 / 5
Trigger Term Quality	Includes natural terms a user would say ('release notes', 'feature or bugfix release', 'Towncrier fragments', 'changelog') with good coverage; a few synonyms are missing, so it sits at 'good keyword coverage' rather than the fully comprehensive 5.	4 / 5
Distinctiveness Conflict Risk	Tightly scoped to 'Warp feature or bugfix release' plus Towncrier/changelog inputs — a clear niche with distinct triggers and minimal overlap with other skills.	5 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
relative_links	Relative link issues: 1 suspicious	Warning

	Total	15 / 16 Passed

Repository: NVIDIA/warp
Path: .codex/skills/warp-release-notes/SKILL.md
Commit: 238de60

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.