CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

makepad-reference

This category provides reference materials for debugging, code quality, and advanced layout patterns.

Quality

56%

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/makepad-reference/SKILL.md

The canonical home for this skill is makepad-reference in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

71%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 an efficient, largely actionable quick-reference: compact error→fix tables, an executable debug command, and logging snippets. Its main structural flaw is a Quick Navigation table that advertises reference files that don't exist in the bundle, leaving the promised deeper material unreachable.

Suggestions

Create the reference files the Quick Navigation table promises (e.g. references/api.md, references/troubleshooting.md, references/code-quality.md, references/adaptive-layout.md) and replace the descriptive "File" cells with real markdown links, or drop the File column and inline the content.

Replace the duplicated intro sentence (identical to the frontmatter description) with a one-line statement of what the tables cover, saving tokens.

Add a sentence of rationale to the color-parse workaround (why changing the last digit fixes the parse error) so the fix is applied correctly rather than blindly.

DimensionReasoningScore

Conciseness

The tables are lean and every row carries a concrete fact (e.g. "Add `cx` as first argument", "Call `redraw(cx)` after changes"), with no explanation of concepts Claude already knows. Minor trimmable padding exists: the intro sentence duplicates the frontmatter description verbatim and the "File" column holds vague descriptors ("Official docs index, quick API reference") instead of links — anchor 4, not 5, for exactly those reasons; not 3 because nothing is genuinely over-explained.

4 / 5

Actionability

Concrete, executable guidance dominates: "MAKEPAD=lines cargo +nightly run", "log!(\"Value: {:?}\", my_value)", and specific error→fix pairs like "Use `text_style: <THEME_FONT_*>{}`". Minor gaps: the color-parse "change last digit" fix is a bare hack with no rationale, and the Quick Navigation table doesn't lead to actual content. Anchor 4 (mostly executable with minor gaps) — not 5 because some fixes lack context and the navigation promises detail it doesn't deliver; not 3 because the code and commands given are real and executable, not pseudocode.

4 / 5

Workflow Clarity

This is a simple single-purpose lookup skill, and the single action — consult the quick-reference tables when a Makepad error occurs — is unambiguous via the "Use When" column and the error table, so the simple-skill exception applies. However, the Quick Navigation table's "File" column implies files that don't exist anywhere in the bundle, leaving the lookup path with a dead end. Anchor 4 — not 5 because of that dead end; not 3 because direct lookup via the error table works fine and no destructive/batch operation needs validation.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/ directories), yet the Quick Navigation table presents a "File" column promising file-based detail ("Official docs index, quick API reference", "Common errors and fixes") with no actual paths or files behind it — a dangling reference structure. Anchor 3 (some structure but could be better organized; references present but not clearly signaled) — not 4/5 because the promised file-level organization is unresolvable; not 2 because the body itself is short and well-sectioned, with external links clearly labeled.

3 / 5

Total

15

/

20

Passed

Description

25%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 nearly content-free: it says only that reference materials exist for three generic topic areas, without naming Makepad, any concrete capability, or any usage trigger. It would rarely be selected over generic debugging or code-quality skills and fails both the 'what' and 'when' tests.

Suggestions

Name the technology and concrete capabilities, e.g. "Fixes Makepad build and runtime errors (field/type mismatches, color parsing, widget IDs) and applies Makepad-aware refactoring and adaptive layout patterns."

Add an explicit trigger clause, e.g. "Use when the user mentions Makepad, LiveID, Makepad widgets, or when Makepad cargo builds fail or Makepad UI code needs review."

Include the natural keyword 'Makepad' itself — users will say it, and its absence makes the description indistinguishable from any framework reference skill.

DimensionReasoningScore

Specificity

The only action stated is the generic "provides reference materials"; it names three topical areas ("debugging, code quality, and advanced layout patterns") but no concrete actions, and never mentions the technology (Makepad). This matches anchor 2 (names the domain but actions are minimal or generic) — not 1 because specific topic areas are named, not 3 because no concrete capability like 'extracts content' or 'fixes build errors' is given.

2 / 5

Completeness

The 'what' is vague ("provides reference materials") and the 'when' is entirely absent — there is no 'Use when...' clause or equivalent trigger guidance (which caps completeness at 3). Matches anchor 2 (has a vague 'what' and no 'when') — not 1 because the what at least scopes three topic areas, not 3 because nothing concrete is stated about capabilities.

2 / 5

Trigger Term Quality

The only keywords are generic ("debugging", "code quality", "advanced layout patterns"); the natural phrases a user would actually say ("Makepad", "Makepad widget error", "LiveID") are entirely absent. Matches anchor 2 (a couple of generic keywords, missing the natural phrases users say) — not 3 because there are no domain-specific terms or synonyms at all.

2 / 5

Distinctiveness Conflict Risk

With no technology named, "debugging, code quality, and advanced layout patterns" would overlap with virtually any framework reference skill. Matches anchor 2 (very broad; high overlap risk with many similar skills) — not 1 because three specific-ish areas are named rather than pure 'helps with code', not 3 because nothing in the description would steer a user away from generic debugging/code-quality skills.

2 / 5

Total

8

/

20

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.

Validation — 15 / 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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/makepad-reference/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.