CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

android-design-system

Enforce Material Design 3 theming and design token usage in Jetpack Compose. Use when implementing M3 components, color schemes, typography, or design tokens.

64

Quality

80%

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

Quality

Content

75%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 body is a compact, concrete rule set with well-paired anti-patterns and no padding — solid instruction-level guidance for a design-token skill. Its weaknesses are the absence of any executable code example, an implicit rather than explicit workflow, and a dangling empty References section (plus an unexplained P2 priority marker) that should be populated or removed.

Suggestions

Add a minimal executable Theme.kt snippet showing the lightColorScheme/darkColorScheme slot mapping so the guidance is copy-paste ready.

Remove the empty "## References" section (or populate it), since no bundle files exist behind it.

Present the setup as a short numbered sequence (create Color.kt/Theme.kt/Type.kt → map values to scheme slots → access only via MaterialTheme) with a quick self-check for values lacking a slot.

Delete or explain the "## **Priority: P2 (MEDIUM)**" marker, which carries no actionable meaning for the skill's execution.

DimensionReasoningScore

Conciseness

The body is lean with no explanation of concepts Claude already knows, but two elements are trimmable noise: the unexplained "## **Priority: P2 (MEDIUM)**" marker and the dangling "## References" heading with no content or files behind it. Efficient with minor instances that could be trimmed, which is the score-4 anchor rather than 'every token earns its place'.

4 / 5

Actionability

Concrete guidance throughout: specific file names ("Define `Color.kt`, `Theme.kt`, and `Type.kt` in `ui/theme/`"), specific APIs ("`lightColorScheme`/`darkColorScheme` slots"), and anti-patterns given as paired bad/good forms ("not `Color(0xFF...)`" / "Use `MaterialTheme.colorScheme.*`"). Not 5 because there is no copy-paste-ready Kotlin example and the spacing guidance ("Prefer named `.dp` tokens") never names an actual token.

4 / 5

Workflow Clarity

The implicit sequence (define theme files → map values to scheme slots → access via MaterialTheme) is clear and the rules are unambiguous, but it is never presented as an ordered workflow and lacks any checkpoint (e.g., how to handle a value with no matching slot). No destructive/batch operations exist, so no validation cap applies, but the sequence stays implicit, which fits anchor 4 rather than the explicit-checkpoint anchor 5.

4 / 5

Progressive Disclosure

Sections are well organized (Guidelines, Anti-Patterns) and the body is short enough to need no bundle files, which would otherwise merit 5. However, the "## References" section advertises content that does not exist — no references/, scripts/, or assets/ directories are present — a minor organization/navigation gap that fits anchor 4.

4 / 5

Total

16

/

20

Passed

Description

78%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: third-person, concise, with an explicit 'Use when...' clause covering concrete triggers. Its main weakness is specificity — it states one broad enforcement action rather than enumerating the concrete things it does — and a few natural synonyms are missing from the trigger list.

Suggestions

Enumerate concrete actions in the first sentence, e.g., "Create Color.kt/Theme.kt/Type.kt, map raw values to lightColorScheme/darkColorScheme slots, and migrate hardcoded Color(0xFF...) values to MaterialTheme tokens in Jetpack Compose."

Add natural synonyms users actually say to the 'Use when' clause, such as "Material You", "dynamic color", or "Compose theming".

State what happens to non-conforming code (e.g., refactoring or migrating it) to sharpen the 'what' beyond the single verb "Enforce".

DimensionReasoningScore

Specificity

"Enforce Material Design 3 theming and design token usage in Jetpack Compose" names the domain plus one broad action, but does not enumerate concrete actions (e.g., creating theme files or migrating hardcoded values). It matches the anchor for domain + 1-2 actions without comprehensive coverage, and is not score 4 because it never lists several specific actions.

3 / 5

Completeness

It explicitly answers both: what ("Enforce Material Design 3 theming and design token usage in Jetpack Compose") and when ("Use when implementing M3 components, color schemes, typography, or design tokens"), with concrete trigger phrases. The 'when' is explicit, so this is not the score-4 case of an improvable trigger.

5 / 5

Trigger Term Quality

"Use when implementing M3 components, color schemes, typography, or design tokens" gives good keyword coverage with natural terms, but misses common synonyms a user might say such as "Material You", "dynamic color", or "Compose theming". Not 5 because synonym coverage is incomplete; clearly above 3 since multiple relevant, natural keywords are present.

4 / 5

Distinctiveness Conflict Risk

The Material Design 3 / Jetpack Compose niche is distinct, but generic trigger terms like "typography", "color schemes", and "design tokens" could also match web or other design-system skills, giving minor overlap risk. Not 5 because the niche's triggers are not fully distinct from adjacent styling skills.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

HoangNguyen0403/agent-skills-standard

Path

skills/android/android-design-system/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.