CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

moai-tool-svg

SVG creation, optimization, and transformation specialist. Use when creating vector graphics, optimizing SVG files with SVGO, implementing icon systems, building data visualizations, or adding SVG animations.

Quality

77%

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 ./.moai/archive/skills/v3.0/moai-tool-svg/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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 highly actionable and well-organized by time tiers, with copy-paste SVG, SVGO, and animation examples throughout. Its main weaknesses are redundant basic-knowledge cheatsheets, no explicit workflow with validation checkpoints, and a broken module reference index that fails to link the real bundle files.

Suggestions

Fix the reference index: replace the non-existent modules/*.md entries with the actual bundle files (e.g., 'Examples: see references/examples.md' and 'Extended API reference: see references/reference.md'), and remove the dangling 'see the modules directory' pointer.

Move the Common Shapes Cheatsheet and Path Commands Quick Reference into references/reference.md — Claude already knows basic shape and path syntax — and keep only non-obvious quick-reference items inline to improve token efficiency.

Add an explicit optimization workflow with validation, e.g. 1. Back up originals, 2. Run SVGO over the directory, 3. Verify before/after file sizes and check viewBox/title preservation, 4. Re-run with adjusted config if accessibility attributes were stripped — this supplies the missing feedback loop for a batch operation.

DimensionReasoningScore

Conciseness

The body is compact and code-dense with no padded prose, but substantial sections restate concepts Claude already knows — the 'Common Shapes Cheatsheet' (rect/circle/ellipse/line syntax) and the full 'Path Commands Quick Reference' (M/L/C/Q/A definitions) are basic SVG knowledge, matching anchor 3's 'mostly efficient but includes some unnecessary explanation'. It is not a 2 because there is no fluffy narrative padding and most examples carry non-obvious specifics (SVGO config overrides, stroke-dashoffset draw animation).

3 / 5

Actionability

Nearly every section is copy-paste-ready executable content: a complete basic SVG template, concrete SVGO CLI commands ('svgo input.svg -o output.svg', '--config svgo.config.mjs'), a full svgo.config.mjs with preset overrides, working React icon components, and runnable CSS keyframe/draw animations. This matches anchor 5's 'fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

There is no sequenced multi-step workflow — the content is organized by depth tier (30s / 5min / 10+min) rather than by process, and while a Verification checklist exists (before/after file size, viewBox, aria attributes), there are no validation checkpoints inside the workflows themselves (e.g. SVGO directory optimization is a batch operation with no verify/retry loop). This matches anchor 3: sequence implicit, checkpoints missing or implicit.

3 / 5

Progressive Disclosure

The 'Module Index' points to modules/svg-basics.md, modules/svg-styling.md, modules/svg-optimization.md, and modules/svg-animation.md — none of which exist in the bundle — while the actual bundle files (references/examples.md and references/reference.md) are never referenced from the body, leaving 'For detailed patterns on each topic, see the modules directory' as a broken pointer. Combined with inline reference material that duplicates what belongs in reference.md, this matches anchor 2's broken/buried reference structure; it is above 1 only because section headers and the time-tiered layout keep navigation possible.

2 / 5

Total

13

/

20

Passed

Description

83%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.

A strong description in third person that clearly states capabilities and provides an explicit, concrete 'Use when...' clause. Trigger coverage is good and domain-specific, with only minor gaps (no '.svg' extension, slight overlap with general dataviz skills via the visualization trigger).

DimensionReasoningScore

Specificity

The description names the domain and several specific actions ('optimizing SVG files with SVGO', 'implementing icon systems', 'building data visualizations', 'adding SVG animations'), matching anchor 4's 'several specific actions; minor gaps in coverage'. The 'transformation specialist' phrase stays generic and the SVGO tooling is only mentioned once, so it does not reach the comprehensive coverage of a 5.

4 / 5

Completeness

It explicitly answers both questions: 'SVG creation, optimization, and transformation specialist' states what it does, and 'Use when creating vector graphics, optimizing SVG files with SVGO, implementing icon systems, building data visualizations, or adding SVG animations' gives concrete trigger phrases. This matches anchor 5's pattern of a clear 'what' plus an explicit 'when' with concrete triggers.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'vector graphics', 'SVGO', 'icon systems', 'data visualizations', 'SVG animations' are phrases users would plausibly say. It misses common variations such as the '.svg' file extension and 'icons' as a standalone term, so it falls just short of the comprehensive synonym/extension coverage of a 5.

4 / 5

Distinctiveness Conflict Risk

The SVG/SVGO niche is well differentiated with distinct triggers, matching anchor 4's 'mostly distinct; minor overlap risk'. The 'building data visualizations' trigger overlaps with general charting/dataviz skills, which keeps it below the clear-niche, minimal-conflict profile of a 5.

4 / 5

Total

17

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

modu-ai/moai-adk

Path

.moai/archive/skills/v3.0/moai-tool-svg/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.