CtrlK
BlogDocsLog inGet started
Tessl Logo

mobile-design

(Mobile-First · Touch-First · Platform-Respectful)

33

Quality

28%

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 ./skills/mobile-design/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%Scale 1-5

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

This is a moderately well-structured mobile design skill that provides genuinely useful platform-specific knowledge, concrete anti-patterns, and executable code examples. Its main weaknesses are: references to 8+ required files that don't exist in the bundle, some verbosity in philosophical framing, and a workflow that lacks explicit sequencing and feedback loops between its many sections. The anti-pattern tables and platform defaults are the strongest elements.

Suggestions

Provide the referenced bundle files (mobile-design-thinking.md, touch-psychology.md, etc.) or remove the 'REQUIRED' enforcement language — currently the skill demands reading files that don't exist.

Add explicit workflow sequencing: number the major sections as sequential steps and add a feedback loop for when MFRI scores are too low or checkpoint items can't be filled.

Trim philosophical framing (the 'Final Law' quote, 'Mobile is NOT a small desktop', 'Think constraints first, aesthetics second') — these don't add actionable value for Claude.

Remove the 'When to Use' section at the bottom as it's a meaningless placeholder that adds no value.

DimensionReasoningScore

Conciseness

The skill contains useful mobile-specific knowledge Claude wouldn't inherently know (platform defaults, anti-patterns, performance patterns), but includes unnecessary philosophical framing ('Mobile is NOT a small desktop', 'Final Law' quotes), redundant emphasis markers, and some concepts Claude already understands (what Fitts' Law is, that fingers aren't cursors). The tables are efficient but the overall document could be tightened by ~30%.

3 / 5

Actionability

Provides concrete, executable code examples for React Native FlatList and Flutter patterns, specific touch target sizes, clear anti-pattern tables with alternatives, and a usable checklist. Minor gaps: the MFRI scoring system is somewhat abstract and the checkpoint template is more of a form than executable guidance. The framework decision tree and platform defaults are highly actionable.

4 / 5

Workflow Clarity

There's a clear sequence implied (assess MFRI → ask questions → read files → fill checkpoint → design/code → release checklist), but the workflow is spread across sections without explicit sequencing between them. The release checklist provides validation, but there's no feedback loop for what happens when checks fail. The mandatory checkpoint in section 8 is a good validation step but lacks error recovery guidance.

3 / 5

Progressive Disclosure

The skill references 8+ external files (mobile-design-thinking.md, touch-psychology.md, platform-ios.md, etc.) which is good progressive disclosure design, but none of these files exist in the bundle. The references are clearly signaled in tables, but without the bundle files, the skill is incomplete — critical content like 'touch-psychology.md' and 'mobile-performance.md' are marked REQUIRED but unavailable. The main file itself is quite long (~200 lines) and some sections (anti-pattern tables) could potentially be in reference files.

3 / 5

Total

13

/

20

Passed

Description

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

This description is essentially non-functional as a skill selector. It consists only of three parenthetical buzzwords with no concrete actions, no trigger terms, and no guidance on when to use the skill. It would be nearly impossible for Claude to correctly select this skill from a list of available skills.

Suggestions

Replace the abstract adjectives with concrete actions describing what the skill does, e.g., 'Builds responsive mobile interfaces, implements touch gestures, adapts layouts for iOS and Android platforms.'

Add an explicit 'Use when...' clause with natural trigger terms, e.g., 'Use when the user asks about mobile app design, responsive layouts, touch interactions, or cross-platform UI development.'

Specify the domain and output format clearly to distinguish this skill from other UI/design skills, e.g., mention specific technologies, file types, or frameworks involved.

DimensionReasoningScore

Specificity

The description contains no concrete actions whatsoever. It only lists three abstract adjectives/buzzwords ('Mobile-First', 'Touch-First', 'Platform-Respectful') with no indication of what the skill actually does.

1 / 5

Completeness

The description answers neither 'what does this do' nor 'when should Claude use it'. It provides only abstract design principles with no actionable information.

1 / 5

Trigger Term Quality

There are no natural keywords a user would say. 'Mobile-First', 'Touch-First', and 'Platform-Respectful' are design philosophy jargon, not terms users would naturally use when requesting help with a task.

1 / 5

Distinctiveness Conflict Risk

The description is so vague it could apply to any mobile development, responsive design, or UI/UX skill. There is nothing to distinguish it from other skills or define its niche.

1 / 5

Total

4

/

20

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-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.