CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

evolution

This skill enables makepad-skills to self-improve continuously during development.

Quality

53%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/evolution/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

57%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 delivers strong actionable content — concrete install commands, hook configuration, a sequenced evolution process, and explicit quality guidelines — but it is a monolithic ~370-line file with redundant sections and no actual bundle files despite advertising references/ and templates/ directories. The main workflow also lacks an inline validation checkpoint before contributions are pushed.

Suggestions

Add a validation checkpoint inside the Evolution Process (e.g., Step 4.5: verify contributed code compiles and examples work before committing/pushing), so the workflow isn't dependent on the separate periodic Self-Validation activity.

Move the hooks JSON configuration, skill-routing tables, and contribution templates into actual reference files (references/hooks-config.md, references/routing.md, templates/pattern.md), keeping SKILL.md as a lean overview with clearly signaled one-level-deep links — the file tree currently advertises directories that don't exist in the bundle.

Cut duplication to improve token efficiency: remove the verbatim description repeat at the top, merge 'Auto-Evolution Prompts' and 'Continuous Improvement Checklist' into 'When to Evolve', and fix the malformed 'Skill File Locations' tree (mislabeled '# ===' lines and the incorrect '16' core-skill count).

DimensionReasoningScore

Conciseness

The body is mostly tables and actionable lists, but at ~370 lines it carries padding that could be trimmed: the opening line repeats the description verbatim, the 'Auto-Evolution Prompts' and 'Continuous Improvement Checklist' sections substantially duplicate 'When to Evolve', and the 'Skill File Locations' tree includes malformed filler lines ('├── # === Core Skills (16) ===') with a miscounted list. It fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than 4, where only minor trimming would be needed.

3 / 5

Actionability

Concrete executable guidance dominates: the curl install command, exact hooks JSON for .claude/settings.json, git branch/commit/push commands, a classification map, and concrete markdown marker formats. It is not a 5 because the Step 3 pattern templates are placeholders ('// DSL code', '// Rust code', 'Brief description...') rather than a filled real example, and some routing tables describe behavior of hook scripts whose contents are not provided.

4 / 5

Workflow Clarity

The Evolution Process is clearly sequenced (Steps 1–5) and Self-Correction has a detect→verify→correct loop, but the main contribution workflow has validation gaps: no checkpoint to verify contributed code compiles or examples work before committing/pushing (the Self-Validation checklist exists as a separate periodic activity, not an inline step). This matches 'steps listed but validation gaps; sequence present but checkpoints missing or implicit'; a 4 would require validation embedded in the evolution sequence itself.

3 / 5

Progressive Disclosure

The file has good in-document structure (Quick Navigation table with anchor links, clear section headers), but no bundle files exist — references/, scripts/, and assets/ are absent — while the 'Skill File Locations' tree advertises 'evolution/references/ ← Detailed guides' and 'templates/' that are not part of this bundle. Content that clearly belongs in separate files (the full hooks JSON config, routing tables, contribution templates) is inlined in one ~370-line file. This fits 'some structure but could be better organized; references present but not clearly signaled; content that should be separate is inline' rather than 2, since the single file is itself well-organized and navigable.

3 / 5

Total

13

/

20

Passed

Description

28%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 names its domain but describes capability only in abstract terms ('self-improve continuously') with no concrete actions, no natural trigger phrases, and no 'use when' guidance. It would rarely be selected by a user's natural phrasing and risks being skipped or conflated with general improvement requests.

Suggestions

Add a 'Use when...' clause with concrete trigger phrases, e.g., 'Use when the user solves a Makepad error worth documenting, discovers a reusable widget or shader pattern, or asks to update/contribute to makepad-skills.'

Replace 'self-improve continuously' with the specific actions the skill performs: classify new knowledge (widget patterns, shader techniques, error fixes), correct wrong skill content, validate examples, and adapt guidance across Makepad branches.

Include natural synonyms users would actually say — 'contribute', 'document this fix', 'update the skills', 'add a pattern' — to improve trigger-term coverage and distinctiveness.

DimensionReasoningScore

Specificity

The description names the domain ("makepad-skills") but the only action is the generic "self-improve continuously during development" — no concrete actions like capturing patterns, correcting skill errors, or version validation are stated. This matches the anchor 'Names the domain but actions are minimal or generic'; it is not a 1 because the domain is named, and not a 3 because no concrete action is actually enumerated.

2 / 5

Completeness

It has a vague 'what' ("self-improve continuously") and entirely lacks a 'when' — no 'Use when...' clause or equivalent trigger guidance, which alone caps completeness at 3. It fits the anchor 'Has a vague what and no when'; a 3 would require a clear, concrete 'what', which the abstract 'self-improve' phrasing does not provide.

2 / 5

Trigger Term Quality

Keywords are limited to "makepad-skills", "self-improve", and "development" — no natural phrases a user would say when needing this skill (e.g., 'add a pattern', 'fix a skill', 'contribute', 'update skills'). This is one or two generic keywords missing the natural user phrasing; it is above 1 only because 'makepad' is a genuine domain term.

2 / 5

Distinctiveness Conflict Risk

The 'makepad-skills' domain reference gives it a somewhat specific niche, but 'self-improve continuously during development' is broad enough to overlap with general refactoring, documentation, or code-improvement skills. It is more distinct than generic descriptions (not 2) but still carries overlap risk with related Makepad/contribution skills (not 4).

3 / 5

Total

9

/

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