CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-add

Install skills from a zip URL or local zip file path. Use this skill whenever the user wants to install a skill from a zip link or a local file, or uses commands like /skill-add with a URL or file path. Trigger on phrases like: install skill, install from zip, skill from zip, skill from url, add skill from zip, 安装skill, 从zip安装skill, 从本地安装skill.

Quality

90%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

Excellent, tightly focused content for a single-task skill: fully executable commands, clear argument semantics, explicit guardrails, and a real, well-signaled script bundle. The only notable flaw is mild repetition of the URL-vs-local-path distinction across sections that could be trimmed without losing clarity.

DimensionReasoningScore

Conciseness

The body is lean with no concept explanations Claude already knows, but the URL-vs-local-path duality is restated three to four times (intro, 'How to Install', the bullet list, and 'Notes') and the install destination appears twice, so it fits the minor-redundancy anchor rather than the every-token-earns-its-place anchor.

4 / 5

Actionability

Copy-paste ready ruby commands with both invocation forms, explicit argument definitions, and a worked slug-inference example (canvas-design-1.2.0.zip → canvas-design) covering the common remote and local cases — fully executable.

5 / 5

Workflow Clarity

A simple single-purpose skill where the single action is unambiguous: exact script path, explicit argument semantics, built-in result reporting, an anti-pattern warning ('Do NOT manually download or unzip'), and an ask-the-user fallback when the source is missing, meeting the simple-skill exception at the top anchor.

5 / 5

Progressive Disclosure

A ~50-line, well-sectioned body whose only bundle dependency is a single one-level-deep, clearly signaled reference (scripts/install_from_zip.rb), which exists on disk; per the under-50-lines guidance this earns the top anchor.

5 / 5

Total

19

/

20

Passed

Description

86%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 that explicitly covers both what the skill does and when to use it, with unusually thorough trigger coverage including bilingual variants. Its main weakness is that the capability list is thin — one action with two input sources rather than a set of concrete actions.

Suggestions

Expand the capability clause to 2-3 concrete actions (e.g., 'Install skills from a zip URL or local zip path; download and extract the archive; copy skill directories to ~/.clacky/skills/') to raise specificity.

Add the '.zip' file-extension trigger term and common user phrasings like 'install a skill' to round out trigger coverage.

Sharpen distinctiveness by scoping the triggers to zip/source installation (e.g., 'install skill from zip or file') to reduce overlap with general skill-management skills.

DimensionReasoningScore

Specificity

Names the domain and 1-2 concrete actions ("Install skills from a zip URL or local zip file path") but does not list several specific actions like downloading, extracting, or copying, so it matches the 1-2-action anchor rather than the several-actions anchor.

3 / 5

Completeness

Clearly answers what ("Install skills from a zip URL or local zip file path") and when ("Use this skill whenever the user wants to install a skill from a zip link or a local file... Trigger on phrases like:...") with concrete trigger phrases, exactly matching the top anchor.

5 / 5

Trigger Term Quality

Comprehensive natural trigger coverage with synonyms ("install skill, install from zip, skill from zip, skill from url, add skill from zip"), the command form (/skill-add), and bilingual variants (安装skill, 从zip安装skill, 从本地安装skill); only trivial variants like a bare ".zip" mention are missing, keeping it at the top anchor rather than the good-coverage anchor.

5 / 5

Distinctiveness Conflict Risk

A clear zip-installation niche with distinct triggers, but generic phrases like "install skill" create minor overlap risk with other skill-management skills, fitting the mostly-distinct anchor rather than the minimal-conflict anchor.

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

clacky-ai/openclacky

Path

lib/clacky/default_skills/skill-add/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.