CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

generate-code-snippet

Generate a concise, shareable code snippet URL for code.franciscomoretti.com. Use when preparing a code image or short snippet for Twitter, X, social sharing, or a presentation.

72

Quality

91%

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

SKILL.md
Quality
Evals
Security

Quality

Content

100%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 exemplar of a lean single-purpose skill: every instruction is concrete, the URL template is copy-paste ready, and the output contract is explicit. There is no padding, no over-explanation, and no structure that needs offloading to bundle files.

DimensionReasoningScore

Conciseness

Every token earns its place: three style bullets, one explicit encoding instruction, a URL template, and a one-line output rule. No concepts Claude already knows are explained, matching the lean-and-efficient anchor.

5 / 5

Actionability

Fully executable guidance — 'Base64url-encode the snippet without padding, then construct' a copy-paste URL template with <base64url> and <language> placeholders, supported languages named (tsx, shell, json), and an explicit output format ('Return the snippet in a fenced code block and the complete URL').

5 / 5

Workflow Clarity

A single-purpose skill under 50 lines with an unambiguous sequence (compose snippet, encode, construct URL, return both). The simple-skill exception applies and there are no destructive or batch operations requiring validation.

5 / 5

Progressive Disclosure

Under 50 lines with no need for external references (none exist in the bundle), and the body is well organized with a heading, bullets, and the URL template — meeting the guideline for simple skills.

5 / 5

Total

20

/

20

Passed

Description

78%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 with an explicit 'Use when' trigger clause and concrete natural terms, anchored to a specific domain. Its main weakness is thin capability coverage — it names a single action rather than enumerating what the skill does (encoding, theming, URL construction).

Suggestions

List 2-3 concrete capabilities in the description (e.g. 'encode the snippet as base64url, theme it, and build a shareable URL') to lift specificity from one named action to several.

Add a few more natural trigger synonyms such as 'share code' or 'code screenshot' to widen the natural keyword coverage.

Consider mentioning supported languages (tsx, shell, json) in the description to further differentiate from generic code-formatting skills.

DimensionReasoningScore

Specificity

The description names the domain ('code snippet URL for code.franciscomoretti.com') and one concrete action ('Generate a concise, shareable code snippet URL'), matching the anchor for 1-2 concrete actions rather than the several listed actions of level 4.

3 / 5

Completeness

It clearly answers both what ('Generate a concise, shareable code snippet URL for code.franciscomoretti.com') and when ('Use when preparing a code image or short snippet for Twitter, X, social sharing, or a presentation') with concrete trigger phrases, matching the anchor-5 example structure.

5 / 5

Trigger Term Quality

Natural trigger terms like 'code image', 'short snippet', 'Twitter, X, social sharing', and 'presentation' give good coverage, but common variations users might say (e.g. 'share code', 'code screenshot', 'code tweet') are missing.

4 / 5

Distinctiveness Conflict Risk

The named domain and social-sharing context establish a clear niche, but 'short snippet' and 'presentation' could mildly overlap with generic code-formatting or presentation skills.

4 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

FranciscoMoretti/chat-js

Path

.agents/skills/generate-code-snippet/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.