CtrlK
BlogDocsLog inGet started
Tessl Logo

greptimedb-release

Runbook for publishing a new GreptimeDB version (tag + GitHub release + docs release-note PR) on the upstream GreptimeTeam/greptimedb repo. Use when asked to "release" / "publish" a GreptimeDB version (e.g. v1.1.0, v1.0.3).

76

Quality

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

100%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.

An exemplary runbook: fully executable commands, a validated multi-step sequence with stop-gates and a rollback path, and dense domain-specific gotchas with essentially no filler. Content is appropriately partitioned with the companion changelog skill.

DimensionReasoningScore

Conciseness

The body is lean and every paragraph encodes runbook-specific gotchas rather than concepts Claude already knows — prerelease-as-build-in-progress marker, FETCH_HEAD vs. a stale remote-tracking ref, conditional makeLatest handling, tag cleanup heuristics. The only redundancy is mild repetition of confirm-with-user phrasing, which does not pull it down to anchor 4's over-explanation level.

5 / 5

Actionability

Every step has a copy-paste-ready command with full flags (git fetch/show for the version check, gh release create with target/title/notes/prerelease, gh release view/edit/delete with --json fields), and the one placeholder (<remote>) is resolved by an explicit discovery procedure. Changelog work is delegated to a named companion skill rather than left vague.

5 / 5

Workflow Clarity

A clearly numbered §0–§6 sequence with explicit validation gates — the Cargo version stop-gate ("must equal the version being released, or stop"), post-create gh release view verification, and post-CI verification — plus a rollback section with double confirmation and show-before-delete. The destructive-operation cap at 3 does not apply because validation and error-recovery feedback are present, matching anchor 5.

5 / 5

Progressive Disclosure

Self-contained at ~119 lines with well-organized sections; changelog generation is appropriately split out to the clearly-signaled, one-level-deep greptimedb-release-note skill, and no bundle files exist to nest or mis-navigate. Matches anchor 5's clear overview with well-signaled references.

5 / 5

Total

20

/

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 description: concrete deliverables, explicit trigger guidance with example versions, and clear niche scoping. Only minor room to grow via natural synonyms like "cut a release" and a slightly fuller enumeration of the flow.

DimensionReasoningScore

Specificity

The description names three concrete deliverables ("tag + GitHub release + docs release-note PR") plus the target repo ("upstream GreptimeTeam/greptimedb"), matching anchor 4's several specific actions. It is not 5 because coverage has minor gaps — branch creation, CI verification, and rollback steps go unmentioned.

4 / 5

Completeness

It explicitly answers both what ("Runbook for publishing a new GreptimeDB version (tag + GitHub release + docs release-note PR) on the upstream GreptimeTeam/greptimedb repo") and when ("Use when asked to 'release' / 'publish' a GreptimeDB version (e.g. v1.1.0, v1.0.3)") with concrete trigger phrases, matching anchor 5 exactly.

5 / 5

Trigger Term Quality

Explicit quoted trigger phrases "release" / "publish" plus concrete version examples ("v1.1.0, v1.0.3") give good keyword coverage a user would naturally say. It falls short of anchor 5 because common synonyms such as "cut a release" or "ship a version" are missing.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche: GreptimeDB-specific, names the exact repo, and scopes itself away from changelog generation (delegated to a separate skill). Minimal conflict risk with other skills, matching anchor 5.

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
GreptimeTeam/greptimedb
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.