CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ux-ui-analyze-single-page

Analyze exactly one captured UI page (from ux_ui_map screenshots + request JSON) and immediately write/update ux_ui_map/pages/{page}.md in neutral descriptive language. Use when asked to analyze screenshots, rewrite corresponding analysis immediately, or avoid memory/context saturation.

Quality

77%

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 ./.github/skills/ux-ui-analyze-single-page/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 lean, well-structured instruction-only skill: concrete file paths, a clearly sequenced procedure with an input-confirmation checkpoint and a hard stop, and appropriately inline content with no bundle files needed. The main gaps are the confusing "template at ux_ui_map/pages/{page}.md" reference in step 3 and the absence of any handling for missing inputs or post-write verification.

Suggestions

Fix step 3's wording: either point to a real template file (e.g. ux_ui_map/templates/page.md) or say "write the page doc at ux_ui_map/pages/{page}.md with these sections: ..." — currently the output path is mislabeled as a template.

Add a one-line fallback for missing inputs, e.g. "If any screenshot or the request JSON is missing, note it in the doc's Screenshot table rather than skipping the page silently."

Trim the "Example prompt that should trigger this skill" section or the "When to use" section — they largely duplicate the frontmatter description.

DimensionReasoningScore

Conciseness

The body is lean and instructional throughout — crisp rules ("Descriptive only: do not judge, do not recommend, do not assign severity") and a tight 4-step procedure with no padding or explanation of concepts Claude already knows. It is not 5 because the "When to use" and "Example prompt that should trigger this skill" sections substantially duplicate the frontmatter description, and not 3 because there is no unnecessary explanation beyond that redundancy.

4 / 5

Actionability

Concrete input paths (ux_ui_map/requests/{page}.json, screenshots/{page}/desktop|tablet|mobile.png), a specified output (ux_ui_map/pages/{page}.md), and an enumerated output structure (Overview, ASCII layout diagram, Screenshot table, Regions) make the guidance mostly executable. It is not 5 because step 3's "using the template at ux_ui_map/pages/{page}.md" confusingly names the output file as a template (no template file exists), and a short example doc snippet would remove ambiguity.

4 / 5

Workflow Clarity

The procedure is a clearly sequenced 4-step workflow with an input checkpoint ("Load the request JSON to confirm route and expected screenshot paths"), an inspection order (desktop first, then tablet/mobile), and a hard stop ("Stop after writing this one page"). It is not 5 because there are no error-recovery steps (e.g. what to do if a screenshot or request JSON is missing) and no post-write verification, and not 3 because one explicit checkpoint and an unambiguous sequence are present.

4 / 5

Progressive Disclosure

The skill is ~35 lines with no bundle files (no references/, scripts/, or assets/ directories exist) and no external references to verify; all content fits inline in well-organized, clearly headed sections (When to use, Inputs, Output, Rules, Procedure, Example). Per the rubric's simple-skill guideline, a sub-50-line skill with no need for external references scores 5 with well-organized sections alone.

5 / 5

Total

17

/

20

Passed

Description

67%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 precise about scope, inputs, and outputs, and includes an explicit "Use when" clause, giving it solid specificity and completeness. Its main weakness is trigger-term quality: only one genuinely natural trigger phrase, with the remaining triggers being awkward or jargon-heavy ("avoid memory/context saturation"). Adding natural user phrasings and synonyms would raise both completeness and trigger quality.

Suggestions

Add natural trigger phrasings users would actually say, e.g. "Use when the user says 'analyze this page's screenshots', 'describe the UI page', or 'write the page doc now'".

Replace or supplement the jargon trigger "avoid memory/context saturation" with user-level phrasing such as "when the analysis should be written out page by page rather than all at once at the end".

Mention what the analysis covers (layout hierarchy, responsive behavior across desktop/tablet/mobile) so the 'what' is comprehensive, not just two verbs.

DimensionReasoningScore

Specificity

"Analyze exactly one captured UI page (from ux_ui_map screenshots + request JSON) and immediately write/update ux_ui_map/pages/{page}.md in neutral descriptive language" names concrete inputs, actions, output artifact, and scope constraints. It sits between anchor 3 (1-2 concrete actions) and anchor 4 (several specific actions, minor gaps) — the actions are tightly specified but coverage is incomplete (what the analysis examines, e.g. layout/responsive changes, is omitted), so 4 rather than 3 because the precision exceeds anchor 3's generic examples, and not 5 because only two verbs are covered.

4 / 5

Completeness

The description explicitly answers both "what" (analyze one captured UI page and write/update the page doc in neutral descriptive language) and "when" (an explicit "Use when" clause with trigger phrases). It falls short of anchor 5 because the trigger phrases are unevenly concrete — "avoid memory/context saturation" is not a phrase a user would naturally say — matching anchor 4 (both present, 'when' could be more specific).

4 / 5

Trigger Term Quality

"Use when asked to analyze screenshots, rewrite corresponding analysis immediately, or avoid memory/context saturation" includes one natural phrase ("analyze screenshots") but "rewrite corresponding analysis immediately" is stilted phrasing users would not say verbatim and "avoid memory/context saturation" is agent-internal jargon. This matches anchor 3 (some relevant keywords but missing common variations such as "describe the page", "update the page doc", "UI screenshots") — not 4 because keyword coverage is not good enough, not 2 because the screenshots trigger is genuinely natural.

3 / 5

Distinctiveness Conflict Risk

"Analyze exactly one captured UI page (from ux_ui_map screenshots + request JSON)" carves out a clear niche tied to a specific repo workflow, making it mostly distinct with minimal conflict risk. It is not 5 because it could plausibly overlap with a closely related sibling skill that analyzes multiple UI pages, and not 3 because the single-page scoping and ux_ui_map paths are specific enough to disambiguate.

4 / 5

Total

15

/

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

raphaelmansuy/edgequake

Path

.github/skills/ux-ui-analyze-single-page/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.