CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

qtpass-releasing

Cuts QtPass releases from main or the 1.8 branch, bumps version files, writes the CHANGELOG and metainfo entries, tags signed vX.Y.Z or rc tags, drives the draft release with installers, GPG-signs and publishes it. Use when preparing a release, rc, version bump, changelog, tag, installers, publishing or downstream packages.

75

Quality

94%

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

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 operational skill: a dense, eight-step release workflow with executable commands, per-step verification checkpoints, error-recovery loops, and appropriately split reference files. It teaches only project-specific constraints (branch topology, SignPath approval, asset-signing rules) and assumes Claude knows the underlying tooling.

DimensionReasoningScore

Conciseness

The body assumes Claude's competence throughout — no explanations of git tagging, GPG, or CI concepts — and every sentence is operational (e.g. "Tag the merge commit on the release branch, not the PR branch", "SignPath refuses a run that was re-run more than three times"). Only project-specific facts are included, and each earns its place; nothing here is padded or time-conditional guidance.

5 / 5

Actionability

Fully executable, copy-paste-ready commands cover every stage: `git checkout -b release/X.Y.Z origin/main`, `qmake6 && make -j4 && make check`, `git tag -s vX.Y.Z -m "QtPass vX.Y.Z"`, `gh release edit vX.Y.Z --notes-file <(sed -n '/^## \[X.Y.Z\]/,/^## \[/p' CHANGELOG.md | sed '$d')`, and a dry-run-then-run pattern for signing. The version-bump table names each exact file and field, and both branch variants (main and 1.8) are covered.

5 / 5

Workflow Clarity

Steps 1–8 are clearly sequenced with an explicit "**Verify:**" checkpoint after nearly every stage, plus error-recovery guidance ("If the release date slips, land a follow-up 'Release X.Y.Z: dated YYYY-MM-DD' PR before tagging", "Do not tag on a red run"). Destructive/publishing operations are guarded by `--dryrun` and tag verification (`git tag -v`), so the batch/destructive validation cap does not apply.

5 / 5

Progressive Disclosure

The core release procedure lives in SKILL.md while the two detail-heavy domains (downstream packaging, local builds) are split into real, one-level-deep bundle files, each clearly signaled with a when-to-read condition ("Read [references/downstream-packaging.md](references/downstream-packaging.md) when bumping FreeBSD, OpenBSD, MacPorts…"). Both referenced files exist in the bundle, and lint/doc details are correctly delegated to sibling skills (qtpass-docs, qtpass-linting) rather than inlined.

5 / 5

Total

20

/

20

Passed

Description

88%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, specific description in third-person voice with a comprehensive action list and an explicit 'Use when' trigger clause. Its only weaknesses are a couple of missing natural trigger terms (signing, release notes) and slight overlap risk with sibling QtPass skills on generic words like 'changelog' and 'tag'.

DimensionReasoningScore

Specificity

Six concrete third-person actions cover the workflow end to end: "Cuts QtPass releases from main or the 1.8 branch, bumps version files, writes the CHANGELOG and metainfo entries, tags signed vX.Y.Z or rc tags, drives the draft release with installers, GPG-signs and publishes it". Coverage is comprehensive across the whole release pipeline, matching the top anchor rather than the 'minor gaps' of 4.

5 / 5

Completeness

It explicitly answers both questions: the what is the full action list, and the when is an explicit "Use when preparing a release, rc, version bump, changelog, tag, installers, publishing or downstream packages" clause with concrete trigger phrases — the pattern of the anchor-5 example.

5 / 5

Trigger Term Quality

The when-clause lists the natural release vocabulary — "preparing a release, rc, version bump, changelog, tag, installers, publishing or downstream packages" — which a maintainer would genuinely say. A few natural terms are still missing from the trigger list, e.g. signing/release notes ("GPG-signs" appears only in the what), so it falls just short of comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche (QtPass release management) is clear and the description names the project, so conflict with unrelated skills is minimal. However, generic trigger words like "changelog" and "tag" overlap with the sibling qtpass-docs/linting skills this bundle references, which is minor overlap risk with closely related skills — the anchor-4 case rather than 'minimal conflict risk'.

4 / 5

Total

18

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

IJHack/QtPass

Path

.opencode/skills/qtpass-releasing/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.