CtrlK
BlogDocsLog inGet started
Tessl Logo

release-asc-cli

Publish and verify a new release of the App-Store-Connect-CLI repository. Use only when the user explicitly asks to release, tag, or publish a specific ASC CLI version, including the full GitHub release, artifact, Homebrew, WinGet, cleanup, and release-announcement workflow.

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

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

The body is an exceptionally lean, fully operational release runbook: concrete commands at every stage, explicit stop/validation checkpoints, resume-reconciliation rules, and error-recovery loops. Its only structural weakness is that the changelog writing rules and example entry could live in a reference file like the announcement template does.

DimensionReasoningScore

Conciseness

The body explains nothing Claude already knows; every sentence is a repository-specific operational constraint ("Never tag a correction committed only in the detached release worktree", "Do not retry by silently moving or recreating a published tag"). It assumes competence and every token earns its place, matching the lean anchor 5 rather than the has-trimmable-over-explanation anchor 4.

5 / 5

Actionability

Guidance is directly executable: a copy-paste release gate ("make format", "make check-docs", "make lint", "ASC_BYPASS_KEYCHAIN=1 make test", "./asc version"), concrete verification checks ("codesign --verify", checksum comparison, "pnpm run lint", "pnpm build", "git diff --check"), and a complete example changelog entry. This matches the fully-executable anchor 5; the only near-gap is that the annotated-tag command is described rather than spelled out, which does not rise to a minor gap given the surrounding command coverage.

5 / 5

Workflow Clarity

The sequence (prove target → release gate → publish → verify consumer-visible state → changelog → announcement → cleanup) is clearly ordered with explicit validation checkpoints ("Stop on unexplained failures; do not tag around a broken gate", restart the gate if origin/main advanced) and error-recovery feedback loops for winget failures (inspect retry history, one rerun, back-off rules, "report the exact blocker instead of looping"). This matches anchor 5, including the destructive/batch validation requirement.

5 / 5

Progressive Disclosure

The announcement template is correctly split into references/release-announcement.md, signaled one level deep ("Read [references/release-announcement.md](...)"), and sections are well organized. Minor gap: the ~30-line changelog writing rules plus a worked example sit inline in SKILL.md although a references directory exists, so it fits anchor 4 (minor organization gaps) rather than the fully-appropriately-split anchor 5.

4 / 5

Total

19

/

20

Passed

Description

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

The description is concrete, third-person, and complete: it names the full release pipeline and provides an explicit, well-bounded "Use only when..." trigger clause. Its only weakness is slightly thin coverage of natural trigger variations (e.g. "cut a release", "ship a version", "v"-prefixed tags).

DimensionReasoningScore

Specificity

"Publish and verify a new release" plus "the full GitHub release, artifact, Homebrew, WinGet, cleanup, and release-announcement workflow" lists multiple specific concrete actions with comprehensive coverage of the release pipeline, matching the anchor-5 example rather than the minor-gaps anchor 4. Third person voice is used throughout, so no voice penalty applies.

5 / 5

Completeness

It clearly answers "what" ("Publish and verify a new release of the App-Store-Connect-CLI repository") and "when" with an explicit trigger clause: "Use only when the user explicitly asks to release, tag, or publish a specific ASC CLI version". Both are explicit and concrete, matching anchor 5; the "when" is fully explicit so anchor 4 does not fit.

5 / 5

Trigger Term Quality

"release, tag, or publish a specific ASC CLI version" plus "Homebrew" and "WinGet" are natural phrases users would say, giving good keyword coverage. It misses a few natural variations such as "cut a release", "ship", or explicit version formats (e.g. "v5.1.0"), so it fits anchor 4 rather than the comprehensive-synonyms anchor 5.

4 / 5

Distinctiveness Conflict Risk

Scoped to a single named repository ("App-Store-Connect-CLI") with a narrow explicit trigger, it occupies a clear niche with distinct triggers and minimal risk of firing for the wrong skill; there is no meaningful overlap with generic release or git skills.

5 / 5

Total

19

/

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
rorkai/App-Store-Connect-CLI
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.