CtrlK
BlogDocsLog inGet started
Tessl Logo

common-store-changelog

Generate user-facing release notes for the Apple App Store and Google Play Store by collecting git history, triaging user-impacting changes, and drafting store-compliant changelogs. Enforces character limits (App Store ≤4000, Google Play ≤500), tone, and bullet format. Use when generating release notes, app store changelog, play store release, what's new, or version release notes for any mobile app.

76

Quality

96%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

92%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a high-quality skill that is concise, actionable, and well-structured. The workflow is clearly sequenced with validation checkpoints, the output templates are concrete and copy-paste ready, and the anti-patterns section effectively prevents common mistakes. The only weakness is the reference to a bundle file (references/commit_examples.md) that doesn't exist in the provided bundle, which slightly undermines progressive disclosure.

DimensionReasoningScore

Conciseness

Every section is lean and purposeful. No unnecessary explanations of what git is, what app stores are, or how changelogs work. Rules are stated as direct imperatives with concrete examples ('Faster checkout' not 'refactored cart service').

3 / 3

Actionability

Provides specific git commands, concrete output templates with exact formatting, explicit character limits, clear categorization labels (New/Improved/Fixed), and anti-pattern examples showing what to drop and why. The output format sections are copy-paste ready.

3 / 3

Workflow Clarity

The 5-step workflow is clearly sequenced (Collect → Triage → Draft App Store → Draft Play Store → Validate) with an explicit validation step that checks character counts and verifies bullets map to real commits. The anti-patterns section adds further guardrails against common errors.

3 / 3

Progressive Disclosure

References a commit-to-bullet examples file (references/commit_examples.md) which is a good signal for progressive disclosure, but the bundle has no files provided so the reference is unverifiable. The skill itself is well-structured with clear sections, but the missing bundle file slightly undermines the reference strategy.

2 / 3

Total

11

/

12

Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that clearly articulates specific capabilities (git history collection, change triage, store-compliant formatting with exact character limits), provides a comprehensive 'Use when' clause with multiple natural trigger terms, and occupies a distinct niche focused on mobile app store release notes. It is concise, uses third-person voice throughout, and would be easily distinguishable from related but different skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: collecting git history, triaging user-impacting changes, drafting store-compliant changelogs, enforcing character limits with exact numbers, tone, and bullet format.

3 / 3

Completeness

Clearly answers both 'what' (generate release notes by collecting git history, triaging changes, drafting changelogs with specific constraints) and 'when' (explicit 'Use when...' clause with multiple trigger scenarios).

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'release notes', 'app store changelog', 'play store release', 'what's new', 'version release notes', 'mobile app'. These are highly natural phrases a user would use.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive niche targeting specifically Apple App Store and Google Play Store release notes with platform-specific character limits. Unlikely to conflict with generic changelog or git history skills due to the mobile app store focus.

3 / 3

Total

12

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

9

/

11

Passed

Repository
HoangNguyen0403/agent-skills-standard
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.