CtrlK
BlogDocsLog inGet started
Tessl Logo

neumorphism

Soft, extruded UI elements with inner and outer shadows on monochromatic surfaces for a tactile, embedded look.

48

Quality

51%

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/neumorphism/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%

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

The skill body is well-organized and outlines a thorough design-system authoring workflow, but it stays abstract — providing structure and rules without neumorphism-specific executable examples or validation checkpoints.

Suggestions

Add concrete neumorphism examples — e.g., inner/outer shadow token combinations (surface/base + dark/light shadow offsets) and copy-paste CSS or component markup — to lift actionability.

Insert an explicit validation/feedback loop into the authoring workflow (e.g., 'After drafting rules, run the QA checklist and fix any rule that fails a token/threshold anchor before output').

Tighten or deduplicate sections that restate generic design-system principles to improve token efficiency and neumorphism specificity.

DimensionReasoningScore

Conciseness

The body is well-structured and not padded with basic concept explanations, but it is fairly long and somewhat abstract for a skill whose job is producing neumorphism guidance; a few sections restate general design-system principles rather than adding neumorphism-specific value.

2 / 3

Actionability

It provides clear structural expectations (tokens, states, QA checklist) and concrete do/don't rules, but offers no concrete code, token-to-shadow mappings, or copy-paste examples specific to neumorphism.

2 / 3

Workflow Clarity

The authoring workflow is clearly sequenced into six numbered steps, but it lacks explicit validation/feedback checkpoints and the skill's own QA checklist is described rather than shown as an executable validation loop.

2 / 3

Progressive Disclosure

Content is organized into clear single-purpose sections with no bundle files or external references to manage; for a standalone skill, the well-organized structure is sufficient.

3 / 3

Total

9

/

12

Passed

Description

45%

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 visually specific about neumorphism's defining effects but lacks explicit 'Use when...' trigger language and natural user keywords, capping completeness and trigger quality.

Suggestions

Append a 'Use when...' clause naming natural trigger phrases (e.g., 'Use when designing soft, extruded UI with inner/outer shadows, or when the user mentions neumorphism, soft UI, or tactile surfaces').

Add common user-facing keywords like 'UI design', 'soft shadows', and 'design system' to improve trigger term coverage.

Keep the third-person voice but make the when-to-use boundary explicit to reduce overlap with general design-system skills.

DimensionReasoningScore

Specificity

Lists several concrete styling actions — 'soft, extruded UI elements', 'inner and outer shadows', 'monochromatic surfaces' — describing tangible visual effects rather than vague abstractions.

3 / 3

Completeness

It clearly states what the skill produces (a tactile, embedded look via inner/outer shadows) but provides no 'Use when...' clause, so the 'when' guidance is only implied by the design term.

2 / 3

Trigger Term Quality

The only natural user-facing term is the implicit 'neumorphism' (via name); the description leans on technical styling jargon and omits common trigger phrases like 'UI design', 'soft shadows', or 'design system'.

1 / 3

Distinctiveness Conflict Risk

Neumorphism is a recognizable niche, but the description lacks explicit trigger guidance and could overlap with general UI/design-system skills.

2 / 3

Total

8

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
bergside/awesome-design-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.