CtrlK
BlogDocsLog inGet started
Tessl Logo

metadata-optimization

When the user wants to optimize App Store metadata — title, subtitle, keyword field, or description. Also use when the user mentions "optimize my title", "ASO metadata", "keyword field", "character limits", "app description", or "write my subtitle". For keyword discovery, see keyword-research. For full ASO audits, see aso-audit.

70

Quality

85%

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

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

A well-built instruction-only skill: concrete, example-driven guidance with ready-to-use output templates and a clear assess-then-optimize workflow. The main improvement is making validation explicit — turning the 'Common Mistakes to Flag' list into a directed pre-delivery checklist — and trimming the persona opener and repeated rules.

Suggestions

Convert 'Common Mistakes to Flag' into an explicit final validation step, e.g. 'Before delivering: verify every field is within its platform limit, no keyword repeats across title/subtitle/keyword field, and no plural forms or spaces in the keyword field.'

Trim the persona opener ('You are an expert ASO copywriter...') and deduplicate rules repeated across sections (character limits, natural-reading requirements) to recover tokens.

Signal in the Initial Assessment what to do when `app-marketing-context.md` is absent, so the workflow does not stall on a missing optional input.

DimensionReasoningScore

Conciseness

The body is dense prescriptive rules and reference data (limit tables, formulas, output templates) with almost no concept explanation Claude already knows; the main trimmable padding is the role-play opener 'You are an expert ASO copywriter...' and some rule repetition (e.g., 'Use the full 30 characters' stated under both title and subtitle). It sits at the 'efficient; minor instances of over-explanation that could be trimmed' anchor — leaner than the 3 anchor's 'some unnecessary explanation', but not the 5 anchor's 'every token earns its place'.

4 / 5

Actionability

Per the code-vs-instruction note, absence of code is not penalized when guidance is actionable — and this is highly actionable: concrete title formulas with real examples ('Calm - Sleep & Meditation', 'Duolingo: Language Lessons'), exact keyword-field formatting rules (comma-separated, no spaces, singular forms, character budget '[X]/100'), a 6-part description structure, and copy-paste output templates (metadata package with recommended + two alternatives, keyword coverage matrix, before/after table). Specific examples cover the common cases, matching the top anchor.

5 / 5

Workflow Clarity

There is a clear sequence (5-step Initial Assessment → per-field optimization → output package → mistakes to flag), but validation is implicit rather than an explicit checkpoint: 'Common Mistakes to Flag' is a list, not an instructed 'verify character counts and cross-field keyword duplication before delivering' step. This matches the 4 anchor ('clear sequence with most checkpoints present; minor validation gaps') — not 5, which requires explicit validate-and-retry feedback loops; the copywriting task is not destructive/batch, so no cap applies.

4 / 5

Progressive Disclosure

No bundle files exist, so this is scored on the body's own structure: well-organized sections with headers, a conditional external context file ('Check for `app-marketing-context.md`'), and clearly signaled sibling-skill pointers in Related Skills. It fits the 4 anchor ('good structure; most content appropriately placed; references mostly clear') — the 5 anchor's well-signaled one-level-deep reference files can't apply since no references/ directory exists, and at ~165 lines the all-inline approach is defensible but not exemplary structure across files.

4 / 5

Total

17

/

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: explicit what/when, natural quoted trigger phrases, and explicit routing to sibling skills that reduces conflict risk. The only gap is that the single verb 'optimize' carries all the action, keeping specificity just below the top anchor.

Suggestions

Replace the single generic verb 'optimize' with a couple of distinct concrete actions (e.g., 'rewrite and expand title, subtitle, keyword field, and description copy within platform character limits') to lift specificity.

Add one or two common natural variations users say, such as 'App Store Optimization' or 'improve my store listing', to round out trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain and enumerates concrete targets — 'title, subtitle, keyword field, or description' — under the single action 'optimize'. It matches the 'lists several specific actions; minor gaps' anchor better than the 5 anchor, because the operative verb is one generic action applied to fields rather than multiple distinct concrete actions; but it clearly exceeds the 3 anchor's '1-2 concrete actions, not comprehensive' since all four metadata fields are explicitly covered.

4 / 5

Completeness

It explicitly answers what ('optimize App Store metadata — title, subtitle, keyword field, or description') and when ('When the user wants to...' plus 'Also use when the user mentions...'), with concrete quoted trigger phrases — a near-exact structural match to the anchor-5 exemplar. The 4 anchor would require the 'when' to be less explicit, which is not the case here.

5 / 5

Trigger Term Quality

Direct quoted user phrasings ('optimize my title', 'ASO metadata', 'keyword field', 'character limits', 'app description', 'write my subtitle') are natural and first-person, exactly what users would say. It falls short of the 5 anchor's 'comprehensive coverage... including synonyms' only because common variations like 'App Store Optimization', 'improve my ranking', or 'store listing' are absent.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (App Store metadata copy) and adds explicit boundary guidance — 'For keyword discovery, see keyword-research. For full ASO audits, see aso-audit' — which redirects overlapping use cases, satisfying the 'clear niche with distinct triggers; minimal conflict risk' anchor.

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
Eronred/aso-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.