CtrlK
BlogDocsLog inGet started
Tessl Logo

muapi-design-guide

Create a comprehensive brand design guide — color palette, typography pairings, UI component previews, and visual identity rules with example mockups.

57

Quality

66%

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 ./library/visual/design-guide/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

87%

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

The body is concise, highly actionable, and well-structured with concrete commands and prompts across three clear phases. Its main gap is the absence of verification checkpoints after the batch image generation, which leaves workflow_clarity capped at 2.

Suggestions

Add an explicit verification step after generation, e.g. confirm each 'muapi predict wait <request_id>' succeeded and retry any failed asset before presenting the guide.

Include a brief error-recovery note for common generation failures (rate limits, rejected prompts) to complete the validate->fix->retry loop.

Optionally note how the four assets should be ordered or titled when presented as a cohesive guide.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — each phase gives a command, model ID, prompt, and aspect ratio with no concept explanation or padding, matching the score-3 'every token earns its place' anchor.

3 / 3

Actionability

Guidance is fully executable: concrete 'muapi image generate' commands with exact prompts, model IDs, aspect ratios, and a curl fallback with polling, making it copy-paste ready.

3 / 3

Workflow Clarity

The three parallel phases are clearly sequenced, but for a batch generation workflow there are no explicit validation/verification checkpoints confirming assets succeeded before presenting them, which per the rubric caps workflow clarity at 2.

2 / 3

Progressive Disclosure

Content is organized into clearly labeled sections (Inputs, Steps, Notes, Trigger Keywords) in a single concise file with no nested references; per the simple-skills scoring note this earns a 3 for well-organized short content.

3 / 3

Total

11

/

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 specific and concrete about what the skill produces, but it omits any 'Use when...' trigger guidance and embeds no natural trigger keywords, capping completeness and trigger-term quality. Adding an explicit 'Use when' clause with natural terms would lift the lower dimensions.

Suggestions

Add a 'Use when ...' clause naming natural triggers, e.g. 'Use when creating a brand or visual identity guide, design system, or brand color/typography reference.'

Weave natural user terms ('brand guide', 'design system', 'brand colors', 'typography') into the description itself rather than only listing them in the body's Trigger Keywords section.

Keep the existing concrete action list, which already anchors the specificity dimension well.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'color palette, typography pairings, UI component previews, and visual identity rules with example mockups' — matching the score-3 anchor that lists several specific concrete actions.

3 / 3

Completeness

It clearly answers 'what' but provides no 'when' guidance; per the rubric, a missing 'Use when...' clause caps completeness at 2, and it is not a 1 because the what is fully and concretely stated.

2 / 3

Trigger Term Quality

The description contains no natural trigger keywords a user would say; the 'Trigger Keywords' list lives in the body rather than the description, so coverage of natural terms is effectively absent.

1 / 3

Distinctiveness Conflict Risk

The brand-design niche is somewhat distinct, but without explicit triggers it could overlap with generic design or styling skills; not a 3 because it lacks clearly distinct trigger phrasing.

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
SamurAIGPT/Generative-Media-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.