CtrlK
BlogDocsLog inGet started
Tessl Logo

app-store-changelog

Generate user-facing App Store release notes from git history since the last tag.

64

Quality

76%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/app-store-changelog/SKILL.md

The canonical home for this skill is app-store-changelog in administrakt0r/AI-Agents-Safe-Coding-Skills

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.

The body is a well-structured, lean, instruction-only skill with an executable script, concrete examples, a clearly sequenced workflow with validation, and well-signaled one-level-deep references to real bundle files.

DimensionReasoningScore

Conciseness

The body is lean: it assumes Claude knows git and App Store concepts, uses a compact commit-to-bullet table and a short example output, and every section earns its place with no padded concept explanations.

5 / 5

Actionability

It provides a copy-paste-ready script invocation with argument examples, a concrete raw-commit-to-bullet mapping table, and a finished example output covering the common cases.

5 / 5

Workflow Clarity

The four-step Collect -> Triage -> Draft -> Validate workflow is clearly sequenced, and step 4 supplies explicit validation checkpoints (map bullets to real changes, deduplicate, ask for clarification) with a feedback loop.

5 / 5

Progressive Disclosure

SKILL.md is an overview with clearly signaled one-level-deep references to scripts/collect_release_changes.sh and references/release-notes-guidelines.md, both real bundle files, and content is appropriately split with easy navigation.

5 / 5

Total

20

/

20

Passed

Description

53%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 specific and distinct but lacks an explicit 'when to use' trigger clause and is missing common synonyms like 'What's New' or 'changelog'. It is a clear, concise what-statement that stops just short of the strongest examples.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks for App Store What's New text, release notes, or a changelog from git history since the last tag.'

Include natural synonyms users say such as 'What's New' and 'changelog' alongside 'App Store release notes'.

Optionally mention the second action ('translating commits into bullets') to lift specificity toward 4-5.

DimensionReasoningScore

Specificity

The description names the domain ('App Store release notes from git history since the last tag') and one concrete action ('Generate'), matching the anchor for naming a domain with 1-2 concrete actions but not comprehensive coverage.

3 / 5

Completeness

It clearly states what the skill does but contains no 'Use when...' clause or explicit trigger guidance, which per the judging guidelines caps completeness at 3.

3 / 5

Trigger Term Quality

It includes relevant natural terms ('App Store release notes', 'git history') but omits common variations users say such as 'What's New' or 'changelog', fitting the 'some relevant keywords but missing synonyms' anchor.

3 / 5

Distinctiveness Conflict Risk

The combination of 'App Store release notes' plus 'git history since the last tag' carves a clear niche with only minor overlap risk against generic changelog skills, matching the 'mostly distinct' anchor rather than the fully distinct 5.

4 / 5

Total

13

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.