CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

axiom-validate-screenshots

Use when the user mentions App Store screenshot validation, screenshot review, checking screenshots before submission, or verifying screenshot dimensions and content.

Quality

79%

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 ./axiom-codex/skills/axiom-validate-screenshots/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

73%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 strong, expert-level skill body: an explicitly sequenced workflow with real validation checkpoints, concrete executable commands, specific issue taxonomies with guideline citations, and a copy-paste report template. Its weaknesses are moderate redundancy (a duplicate no-issues report template and five near-identical invocation examples), inlined time-sensitive details that will age, and one cross-skill reference that is not resolvable within this bundle.

Suggestions

Replace the full "When No Issues Found" template with a short instruction (e.g. "If no issues: use the same report with zero issue counts and the 'Verified' checklist") to remove ~20 redundant lines.

Collapse the five invocation examples to two or three distinct phrasings, and trim the duplicate Device Coverage section/table in the report template to one representation.

Move the accepted-sizes table to references/screenshot-sizes.md (read on demand) and either bundle the device-control status-bar guidance or drop the dangling axiom-tools file pointer; keep the April 2027 / iOS 27.1 SDK requirement note with an explicit 'current as of' qualifier.

DimensionReasoningScore

Conciseness

The core content is dense, high-value domain knowledge (exact pixel sizes, false-positive list, guideline citations), but there is noticeable tightening opportunity: the full second template under "When No Issues Found" duplicates the main report structure, the main template contains both a "Device Coverage" section and a "Device Coverage Summary" table, there are five near-identical invocation examples, and time-sensitive specifics ("required from April 2027 for apps using the iOS 27.1 SDK or later", model-year lists) are inlined without a deprecation note. This exceeds anchor 4's 'minor instances of over-explanation' but is far from anchor 2's padded conceptual explanation.

3 / 5

Actionability

The guidance is highly concrete — an executable sips dimension-check command, specific placeholder strings ("Lorem ipsum", "STAGING", "example@email.com"), a complete markdown report template, and per-issue What/Why/Fix structure. It misses anchor 5 because the bash loop uses placeholder filenames ("<file1>", "<file2>") requiring substitution rather than being copy-paste ready, and sips is macOS-only with no stated fallback — minor gaps characteristic of anchor 4.

4 / 5

Workflow Clarity

Steps 1–5 are explicitly sequenced with genuine validation checkpoints throughout: "Do not proceed without a folder path", "If 0 images found, report and stop", a 20-image cap with user notification, uncertainty handling ("flag it as MEDIUM (not CRITICAL) with a note"), and a feedback loop ("Re-run validation" after fixes). Checklists exist in the form of the CRITICAL/HIGH/MEDIUM taxonomy and the false-positive list. The batch-operation cap does not apply because verification is embedded at every stage, matching anchor 5 rather than anchor 4.

5 / 5

Progressive Disclosure

The body is well-organized with clear section headers, and its one external reference is clearly signaled ("see axiom-tools (`skills/device-control-ref.md`, Status bar for screenshots)"). It falls short of anchor 5 because that referenced file is not part of this bundle (no references/ directory exists, so the pointer cannot be resolved locally), and the ~15-line accepted-sizes table is borderline content that could live in a reference file. It is above anchor 3 since the structure is good and the reference is not buried.

4 / 5

Total

16

/

20

Passed

Description

73%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 well-constructed trigger-oriented description with an explicit 'Use when' clause, good natural keyword coverage, and a distinct App Store niche. Its main weakness is that the 'what' is thin — the action verbs are near-synonyms and the description never states what the validation actually checks for or produces.

Suggestions

Add a leading what-clause describing the concrete checks, e.g. "Validates App Store screenshots against Apple's submission requirements — dimensions, placeholder text, debug artifacts, broken UI, and competitor references — and produces an issue report." before the 'Use when' clause.

Include a few more natural trigger variations such as "marketing screenshots" or "before App Store submission" to broaden keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain (App Store screenshots) and one fairly concrete action ("verifying screenshot dimensions and content"), but its other action words ("validation", "screenshot review", "checking screenshots") are synonyms rather than distinct specific actions — it never says what issues are detected or what output is produced. This sits at anchor 3: above anchor 2 (which would have only generic actions with no concrete targets) and below anchor 4 (which would list several distinct specific actions).

3 / 5

Completeness

The "when" is fully explicit ("Use when the user mentions…" with four distinct triggers), and a "what" is stated ("App Store screenshot validation… verifying screenshot dimensions and content"). It misses anchor 5 because the what-clause is thin and largely restates the triggers — it does not say the skill checks compliance against Apple's submission requirements or produces an issue report.

4 / 5

Trigger Term Quality

Natural phrases like "App Store screenshot validation", "screenshot review", "checking screenshots before submission", and "screenshot dimensions" cover what users would actually say. It falls short of anchor 5's comprehensive coverage because common variations such as "marketing screenshots", "App Store submission", or "will my screenshots get rejected" are absent.

4 / 5

Distinctiveness Conflict Risk

"App Store" bounds every trigger to a clear niche with minimal conflict risk — this would not fire for general image review, design review, or code skills. The generic phrase "screenshot review" alone might overlap with a UI-review skill, but it is embedded in an App Store submission context throughout, matching anchor 5 rather than anchor 4.

5 / 5

Total

16

/

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

CharlesWiltgen/Axiom

Path

axiom-codex/skills/axiom-validate-screenshots/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.