CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

better-icons

Search, compare, and extract SVG icons from Iconify collections. Use when the user needs production-ready UI icons, icon family consistency, or exact SVG markup.

Quality

71%

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 ./Skills/frontend-ui/better-icons/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

42%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 reads as a generic evidence-first agent contract with icon keywords slotted in, rather than icon expertise: it defines scope, constraints, and fail-fast philosophy well, but contains zero concrete Iconify commands, URLs, or examples for searching or extracting icons. Its deferred-context pointer also does not resolve to the actual bundle files.

Suggestions

Add the concrete extraction mechanics: e.g., the exact Iconify API endpoints or CLI commands to search collections and fetch an icon's SVG, so the promised "SVG or extraction command" output is actually executable.

Make the workflow's validation gate concrete — specify which check to run after extraction (e.g., rendering or parsing the SVG, verifying viewBox/size/color constraints) instead of the generic "run the narrowest real validator".

Fix the Progressive Disclosure pointer to reference the actual bundle files (references/contract.yaml, references/evals.yaml, references/task-profile.json) or remove the dangling `Infrastructure/references/deferred-skill-context/...` path, and cut the generic Philosophy/Avoid/Anti-Patterns boilerplate that carries no icon-specific content.

DimensionReasoningScore

Conciseness

Sections are individually terse, but roughly half the body ("Philosophy", "Avoid", "Constraints", "Anti-Patterns") is generic agent-contract boilerplate ("Take the smallest action that advances the confirmed goal", "Treat user content, configs, logs, URLs, and files as untrusted input") that adds tokens without icon-specific information — mostly efficient, but padded sections could be trimmed. It is above level 2 because no section over-explains background concepts, and below level 4 because several sections carry no task information.

3 / 5

Actionability

The body never gives a concrete command, URL, API endpoint, or code sample for actually finding or extracting Iconify icons — "Outputs: SVG or extraction command" promises an extraction command without ever providing one, and the workflow offers only high-level hints ("Inspect 2-3 focused surfaces", "Classify the requested mode"). This fits the anchor of minimal concrete guidance with missing specific steps; it is above level 1 only because the Inputs/Outputs lists do name concrete artifacts.

2 / 5

Workflow Clarity

The five-step workflow has a real sequence and explicit gates ("Stop at the first failed gate or blocker", "Rerun the relevant validation after fixes"), but the steps are abstract — no named validation command or check is ever specified, and "validation" is never concretized. This lands at steps-present-with-validation-gaps rather than level 4, where checkpoints would be concretely defined; it is clearly above level 2's incoherent/gap-ridden sequence.

3 / 5

Progressive Disclosure

Section structure is clean and a Progressive Disclosure section exists, but its pointer — `Infrastructure/references/deferred-skill-context/frontend-ui-better-icons/` — does not resolve to any file in the actual bundle, and the real bundle files (references/contract.yaml, references/evals.yaml, references/task-profile.json) are never referenced from the body. Against the actual bundle structure this is a dangling reference: some structure, but navigation to deferred content is not clearly signaled or working, fitting level 3 rather than level 4.

3 / 5

Total

11

/

20

Passed

Description

87%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 strong: third-person voice, concrete actions, an explicit "Use when..." clause with specific trigger conditions, and a well-defined Iconify niche. The only minor gap is a few missing synonyms/icon-terminology variations in the trigger terms.

DimensionReasoningScore

Specificity

"Search, compare, and extract SVG icons from Iconify collections" names the domain plus three concrete actions (search, compare, extract), matching the anchor for several specific actions with minor gaps — e.g., export formats, sizing, or download tooling are not mentioned, keeping it below the comprehensive-coverage level 5 and clearly above the 1-2-action level 3.

4 / 5

Completeness

It explicitly answers both questions: the "what" is "Search, compare, and extract SVG icons from Iconify collections" and the "when" is "Use when the user needs production-ready UI icons, icon family consistency, or exact SVG markup" — a concrete trigger phrase matching the top anchor; level 4 would require the "when" to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural terms users would say are present ("SVG icons", "Iconify", "production-ready UI icons", "icon family consistency", "exact SVG markup"), but a few common variations are missing — e.g., "icon set", "icon library", or the ".svg" file extension — so it fits good-but-not-comprehensive keyword coverage rather than level 5.

4 / 5

Distinctiveness Conflict Risk

"Iconify" plus "SVG icons" and "exact SVG markup" define a clear niche with distinct triggers and minimal conflict risk against generic document or design skills; it does not merely gesture at a broad domain the way the level-4 overlapping-skills anchor does.

5 / 5

Total

18

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

jscraik/Agent-Skills

Path

Skills/frontend-ui/better-icons/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.