CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

app-store-optimization

App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store. Use when the user asks about ASO, app store rankings, app metadata, app titles and descriptions, app store listings, app visibility, or mobile app marketing on iOS or Android. Supports keyword research and scoring, competitor keyword analysis, metadata optimization, A/B test planning, launch checklists, and tracking ranking changes.

88

1.18x
Quality

82%

Does it follow best practices?

Impact

95%

1.18x

Average score across 6 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

The canonical home for this skill is app-store-optimization in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 content is well-structured and unusually data-rich, with concrete workflows, formulas, limits, and explicit validation checkpoints per workflow. Its main weakness is bundle integrity: all 12 referenced files (3 references, 8 scripts, 1 asset) are missing, breaking progressive disclosure and making the script commands non-executable. Secondary issues are absent error-recovery loops and a small amount of filler sections.

Suggestions

Add the referenced bundle files (references/keyword-research-guide.md, references/platform-requirements.md, references/aso-best-practices.md, assets/aso-audit-template.md, and the 8 scripts) or remove/replace the broken links — currently every 'See:' link and script command fails.

Add error-recovery feedback loops to the workflows: each bolded 'Validation' step states pass criteria but should also instruct what to do on failure (e.g., 'if character counts exceed limits, trim secondary keywords and re-check').

Trim redundancy and filler: the description structure appears in both workflow step 5 and the 'Description Structure' tree, and the 'Communication' section's confidence-tagging scheme is vague guidance not tied to any concrete output format.

DimensionReasoningScore

Conciseness

The body is dense with domain-specific data (character limit tables, keyword scoring weights, sample-size quick reference) that Claude cannot reliably know, and mostly avoids explaining known concepts. However, there is padding that could be trimmed: the description structure is stated twice (workflow step 5 and the 'Description Structure' tree), and the 'Communication' section ('Bottom Line → What (with confidence) → Why → How to Act', emoji tagging) is vague filler. This is 'efficient with minor over-explanation' rather than the 5 anchor's every-token-earns-its-place.

4 / 5

Actionability

Guidance is largely executable: a concrete title formula, exact platform character limits, specific keyword-field rules ('Remove plurals... No spaces after commas'), and copy-ready script commands with arguments. The main gap is that all 8 referenced scripts (e.g., `python keyword_analyzer.py --keywords "todo,task,planner"`) point to files that do not exist in the bundle, so those commands cannot actually be run — concrete commands with a real execution gap puts this at the 4 anchor, not 5.

4 / 5

Workflow Clarity

Each workflow is a clearly numbered sequence ending in an explicit bolded validation checkpoint ('**Validation:** Keywords scored; placement mapped; no competitor brand names included; no plurals in iOS keyword field') plus a pre-launch checklist, matching the 'clear sequence with most checkpoints present' anchor. It falls short of 5 because there are no error-recovery feedback loops — the validation steps state criteria but never instruct what to do when validation fails.

4 / 5

Progressive Disclosure

In-body structure is good — well-organized sections and a consolidated 'Tools and References' table — but every referenced bundle path (references/keyword-research-guide.md, references/platform-requirements.md, references/aso-best-practices.md, assets/aso-audit-template.md, and 8 scripts) does not exist in the bundle. Scored against the actual bundle structure, navigation fails at every reference, and some content that belongs in those files (platform tables, before/after examples) is inlined instead. This sits between the 'references present but organization issues' (3) and 'minor organization gaps' (4) anchors; the broken file structure pulls it to 3.

3 / 5

Total

15

/

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 description: concrete multi-action capability list, explicit platform scope, and a well-formed 'Use when' clause with natural trigger terms. Only minor gaps — a few common download-growth phrasings and slight overlap risk with general marketing skills via the 'mobile app marketing' trigger.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility' plus 'keyword research and scoring, competitor keyword analysis, metadata optimization, A/B test planning, launch checklists, and tracking ranking changes' — with named platforms. This matches the anchor for multiple specific concrete actions with comprehensive coverage; nothing is left as vague domain gesturing.

5 / 5

Completeness

It explicitly answers both questions: 'what' via the concrete action list and 'when' via 'Use when the user asks about ASO, app store rankings, app metadata, app titles and descriptions, app store listings, app visibility, or mobile app marketing on iOS or Android' — concrete trigger phrases, matching the top anchor. It is not the 4 anchor because the 'when' clause is already fully explicit and specific, not merely adequate.

5 / 5

Trigger Term Quality

Natural user phrasings are well covered: 'ASO, app store rankings, app metadata, app titles and descriptions, app store listings, app visibility, or mobile app marketing on iOS or Android'. A few common variations users would say are missing (e.g., 'get more downloads', 'increase app downloads', 'Google Play ranking'), so it lands at good-but-not-comprehensive coverage rather than the 5 anchor with full synonyms.

4 / 5

Distinctiveness Conflict Risk

The niche is clear (store-specific ASO on Apple App Store and Google Play, distinct from web SEO), but the trigger 'mobile app marketing on iOS or Android' is broad enough to overlap with general marketing skills (the body itself lists related marketing skills). Minor overlap risk with closely related skills places it at the 4 anchor rather than the 5 anchor's 'minimal conflict risk'.

4 / 5

Total

18

/

20

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.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 15 missing, 3 suspicious

Warning

referenced_paths_exist

Referenced path issues: 18 missing

Warning

Total

13

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/app-store-optimization/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.