CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

release-runbook

Use when asked to deploy, release, publish, or ship OpenMeld to production — workers, Web, CLI, or local components. Routes to `pnpm run deploy`; never deploy raw.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

76%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 deliberately thin router that is maximally lean, clearly signals its two owner documents, and gives exact entry-point commands with flag schemas. Its weaknesses are an unsequenced verification checkpoint for a production-deploy workflow and references that point outside the skill bundle rather than to bundled files.

Suggestions

Sequence the validation step explicitly, e.g. 'Run `pnpm run verify:release-ready` first; only proceed to `pnpm run deploy` when it passes', turning the implicit checkpoint into an ordered one with a pass/fail gate.

Add one worked example invocation (e.g. `pnpm run deploy -- --scope workers --lane github --dry-run`) so the entry point is copy-paste ready rather than only a flag schema.

Bundle the owner documents (or skill-local copies/summaries) inside the skill, e.g. references/production-release.md, so the router's references resolve from the skill directory itself instead of repo-relative paths.

DimensionReasoningScore

Conciseness

Every line is operational — two read directives, two commands, one delegation rule ('Those files own every release rule; do not restate them here') — with zero explanation of concepts Claude already knows, matching the 'lean and efficient; every token earns its place' anchor. The closing sentence ('Select the actual lane and remaining commands from the owner document') slightly restates the opening handoff, but as emphasis on a safety-critical delegation rather than padding, it does not drop to anchor 4's 'minor instances of over-explanation'.

5 / 5

Actionability

Concrete and executable throughout: exact file paths ('developing/engineering/production-release.md'), a conditional rule ('If the scope includes CLI distribution, also read ...'), and exact commands with flag schemas ('pnpm run deploy -- --scope <auto|names> --lane <local|github|auto> --dry-run', 'pnpm run verify:release-ready'). It stops short of anchor 5 because no worked example invocation is given and all operational detail is deferred to external documents — minor gaps rather than copy-paste coverage of the common cases.

4 / 5

Workflow Clarity

The read-before-act sequence is clear ('Read `developing/engineering/production-release.md` before acting'), but the verification checkpoint is implicit: 'pnpm run verify:release-ready' is merely listed as an entry point and never ordered before the deploy command. For a production-release (high-stakes, effectively irreversible) workflow this matches anchor 3 ('sequence present but checkpoints missing or implicit') rather than anchor 4, which requires most checkpoints explicitly sequenced; the simple-skill exception cannot lift it because the validation cap for risky operations takes precedence.

3 / 5

Progressive Disclosure

Exemplary thin-router structure: a clear overview with well-signaled, one-level-deep, conditional references ('If the scope includes CLI distribution, also read `developing/engineering/cli-binary-release.md`') and no nested or buried references. It falls short of anchor 5 because both referenced owner documents live at repo-relative paths outside the skill bundle — no references/, scripts/, or assets/ directories exist, so the referenced files cannot be verified from the skill itself — a minor organization gap.

4 / 5

Total

16

/

20

Passed

Description

90%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 tight, well-scoped router description with explicit trigger verbs, a named product and component scopes, and a concrete command plus a safety constraint ('never deploy raw'). The only weakness is thin action coverage — it describes routing rather than the fuller release workflow — which caps specificity at mid-scale.

Suggestions

Mention the pre-flight check (`pnpm run verify:release-ready`) in the description to broaden concrete action coverage beyond routing alone.

Optionally surface the dry-run capability as a distinctive concrete action, since it is a key feature of the deploy entry point.

DimensionReasoningScore

Specificity

It names the domain ('deploy, release, publish, or ship OpenMeld to production — workers, Web, CLI, or local components') and one concrete action ('Routes to `pnpm run deploy`'), matching the 'domain plus 1-2 concrete actions, but not comprehensive' anchor. It does not list several distinct actions (verification, lane selection, dry-running are absent from the description), so it sits below anchor 4, while the named command keeps it above anchor 2's generic-actions level.

3 / 5

Completeness

The what is explicit ('Routes to `pnpm run deploy`; never deploy raw') and the when is explicit with concrete trigger phrases ('Use when asked to deploy, release, publish, or ship OpenMeld to production'), matching the top anchor. It clearly exceeds anchor 4 because the when clause enumerates four explicit trigger verbs plus scope rather than a single loosely specified condition.

5 / 5

Trigger Term Quality

'deploy, release, publish, or ship ... to production' supplies four natural synonyms a user would actually say, reinforced by concrete component names ('workers, Web, CLI, or local components'). This matches the comprehensive-synonyms top anchor — file extensions are inapplicable to this domain and no meaningful natural term is missing — so it stays above anchor 4's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

It is scoped to a named product ('OpenMeld'), a specific outcome ('to production'), and a specific command ('pnpm run deploy'), creating a clear niche with minimal conflict risk. It fits anchor 5 better than anchor 4 because the product-plus-production scoping leaves little overlap with adjacent skills such as dev-environment or CI tooling.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

amplifthq/opentag

Path

.claude/skills/release-runbook/SKILL.md

Reviewed

Table of Contents

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.