CtrlK
BlogDocsLog inGet started
Tessl Logo

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

78%

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

82%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 exceptionally lean and well-structured with concrete API-level guidance and clear anti-patterns. Its main weaknesses are the absence of executable Kotlin code examples and a dangling, empty References section.

Suggestions

Add a short copy-paste Kotlin snippet (e.g., a minimal Theme.kt showing lightColorScheme/darkColorScheme and MaterialTheme usage) to make the guidance fully executable.

Either populate the 'References' section with real linked files or remove the empty header so navigation is not misleading.

Include a brief validation checkpoint (e.g., 'grep for Color(0x and raw fontSize = to confirm no hardcoded tokens remain') to close the workflow gap.

DimensionReasoningScore

Conciseness

The body is lean and efficient, assumes Claude's knowledge of Compose/M3, and contains no padding or over-explanation — every token earns its place.

5 / 5

Actionability

Gives concrete, executable guidance with specific file names (Color.kt, Theme.kt, Type.kt) and real API slots (lightColorScheme/darkColorScheme, MaterialTheme.colorScheme), but lacks copy-paste Kotlin code examples that would fully cover the common cases.

4 / 5

Workflow Clarity

For a simple single-purpose enforcement skill the action is unambiguous (define files, map values, access via MaterialTheme, avoid anti-patterns), but there is no verification/checkpoint for confirming all raw values were mapped.

4 / 5

Progressive Disclosure

Well-organized sections (Guidelines, Anti-Patterns, References) suit a sub-50-line simple skill, but the 'References' header is empty with no listed or linked reference files, a minor organization gap.

4 / 5

Total

17

/

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.

The description is concise, uses appropriate third-person voice, and clearly pairs a 'what' with a concrete 'when' clause for a well-scoped niche. It is held back slightly by a thin, somewhat abstract 'what' that names only a couple of actions rather than a comprehensive list.

Suggestions

Expand the 'what' with a few more concrete actions (e.g., 'configure light/dark color schemes, map typography scales, apply spacing tokens') to lift specificity and completeness toward the top anchor.

Add a couple of natural synonyms or file-path triggers (e.g., 'ui/theme', 'Color.kt', 'Theme.kt') users might mention to round out trigger-term coverage.

DimensionReasoningScore

Specificity

Names the domain (Material Design 3 theming and design token usage in Jetpack Compose) and 1-2 concrete actions ('Enforce...theming', 'design token usage'), but coverage is not comprehensive — only two abstract verbs rather than multiple specific operations.

3 / 5

Completeness

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'); the 'when' is concrete but the 'what' is somewhat thin on distinct actions.

4 / 5

Trigger Term Quality

Good coverage of natural terms a Compose developer would say ('M3 components, color schemes, typography, or design tokens'), with relevant technical synonyms; a few natural phrasings are still missing.

4 / 5

Distinctiveness Conflict Risk

Targets a clear niche (Jetpack Compose + Material Design 3 theming/tokens) with distinct, domain-specific triggers and minimal overlap risk with unrelated skills.

5 / 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.

Validation14 / 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
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.