CtrlK
BlogDocsLog inGet started
Tessl Logo

weather-svg-creator

Creates an SVG weather card showing the current temperature for Dubai. Writes the SVG to orchestration-workflow/weather.svg and updates orchestration-workflow/output.md.

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 ./.claude/skills/weather-svg-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%

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 and cleanly sectioned with a clear three-step sequence, but it leans on unbundled reference files for the actual templates, omits any SVG-validity verification step, and points to reference.md and examples.md that are not present. Bundling the referenced files and adding a validation checkpoint would address the weakest dimensions.

Suggestions

Bundle the referenced reference.md and examples.md files (or inline the SVG/markdown templates) so the offloaded content actually exists.

Name the specific placeholders to replace and add a validation step that confirms the written SVG is self-contained and well-formed before finishing.

Trim the minor redundancy where reference.md is linked in both Instructions and Additional resources.

DimensionReasoningScore

Conciseness

The body is lean and well-structured with no explanation of concepts Claude already knows; every section earns its place, fitting the 'lean and efficient' anchor.

3 / 3

Actionability

It gives concrete output paths and steps but defers the actual SVG/markdown templates and placeholder names to reference.md, which is not bundled, leaving the executable guidance incomplete.

2 / 3

Workflow Clarity

The three steps are clearly sequenced, but the rule that 'The SVG must be self-contained and valid' has no corresponding verification checkpoint, leaving validation implicit rather than explicit.

2 / 3

Progressive Disclosure

Sections are well-organized and references are clearly signaled one level deep, but the referenced files (reference.md, examples.md) do not exist in the bundle, so the navigation promised by the overview does not actually resolve.

2 / 3

Total

9

/

12

Passed

Description

67%

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 distinct, naming concrete actions and a clear niche, but it omits any 'Use when...' trigger guidance and offers only sparse natural keywords, which caps completeness and trigger quality. Adding explicit trigger conditions would raise the two weaker dimensions.

Suggestions

Add an explicit 'Use when...' clause stating when Claude should invoke this skill (e.g., 'Use when generating a weather visualization card for Dubai from a provided temperature').

Broaden natural trigger keywords to include variations a user might say, such as 'weather visualization', 'temperature display', or 'SVG card'.

DimensionReasoningScore

Specificity

It lists multiple concrete actions — 'Creates an SVG weather card', 'Writes the SVG to orchestration-workflow/weather.svg', and 'updates orchestration-workflow/output.md' — matching the anchor that names several specific concrete actions.

3 / 3

Completeness

It clearly states what the skill does but lacks any 'Use when...' clause or equivalent trigger guidance; per the guidelines a missing explicit trigger caps completeness at 2.

2 / 3

Trigger Term Quality

It includes relevant natural terms ('SVG weather card', 'temperature', 'weather') but coverage is sparse with no common variations, fitting the anchor for 'some relevant keywords but missing common variations'.

2 / 3

Distinctiveness Conflict Risk

The niche is tightly scoped — a weather SVG card for Dubai with specific output paths under 'orchestration-workflow/' — making it clearly distinct and unlikely to trigger for the wrong skill.

3 / 3

Total

10

/

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

relative_links

Relative link issues: 4 missing

Warning

Total

15

/

16

Passed

Repository
shanraisshan/claude-code-best-practice
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.