CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-repair

Use this to fix and re-install agent skills that have failed installation. This skill provides the necessary context and permissions to surgically update the `manifest.json` after a fix has been applied.

Quality

74%

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 ./.agents/skills/skill-repair/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A lean, well-organized, single-purpose instruction skill: the manifest-update procedure is concrete with a copy-paste JSON example, and the body respects the token budget. The main weakness is workflow validation — the sole verification step is a passive statement about the UI rather than an agent-run checkpoint, so a skill can be marked "installed" without confirming the fix worked.

Suggestions

Replace the passive "Verification" step with an agent-performed checkpoint, e.g. re-read the `manifest.json` to confirm the entry updated correctly, or re-check the repaired files before setting status to "installed".

Remove the duplicated manifest-update instruction (intro paragraph vs. step 3) and drop the incidental "The UI will automatically detect this change and refresh" note.

Close the actionability gap in step 3 with a brief fallback — what to do if no entry exists for the skill ID in the `skills` object.

DimensionReasoningScore

Conciseness

The ~40-line body is lean with no explanations of concepts Claude already knows and a tight JSON example, but the intro paragraph ("After you have modified the skill's source files... you MUST update the `manifest.json`") duplicates step 3 of the procedure, and "The UI will automatically detect this change and refresh" is incidental — minor instances that could be trimmed, matching anchor 4. Not 5 because of that duplicated instruction and the incidental UI note.

4 / 5

Actionability

The manifest update is fully concrete — "Find the entry for the skill ID in the `skills` object", "Set `\"status\": \"installed\"`", "Clear the `\"error\"` field (set to `null` or remove it)" — with a copy-paste-ready JSON example, but the core repair guidance ("analyze them collectively to find the root cause", "Understand the error message provided in the prompt") gives direction without executable method, leaving minor gaps — anchor 4. Not 5 because the fix step, the heart of the workflow, has no concrete procedure or example.

4 / 5

Workflow Clarity

The four-step sequence (Analyze Error → Fix Installed Path → Update Manifest → Verification) is clearly ordered, but "Verification: The UI will automatically detect this change and refresh" is a passive claim rather than an agent-performed checkpoint — no step validates that the fix actually resolved the error before the skill is marked "installed". For a workflow that modifies skill files and the manifest, this missing feedback loop caps the score at 3 per the rubric's destructive/batch guidance. Not 4 because the one validation step that exists is not actionable by the agent.

3 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, and needs no external references (no references/, scripts/, or assets/ exist, and none are required); sections ("Skill Context", "Repair Procedure", "Manifest Example") are well-organized and the manifest example is appropriately inline — meeting the simple-skill exception for a 5. Not below 5 because nothing here warrants splitting into bundle files.

5 / 5

Total

16

/

20

Passed

Description

62%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 targets a genuinely distinct niche (failed skill installations and manifest repair) and states both what it does and the triggering condition, but the imperative "Use this to..." voice, abstract filler ("necessary context and permissions", "surgically"), and missing natural trigger synonyms ("broken", "error") keep it mid-scale. It is well above the vague bad examples yet below the fully explicit good examples that pair third-person capability statements with a concrete "Use when..." clause.

Suggestions

Rewrite in third person with an explicit trigger clause, e.g.: "Fixes and re-installs agent skills whose installation failed, and updates the skill manifest (status, error field) accordingly. Use when a skill reports an installation error, fails to load, or appears broken after install."

Replace the abstract filler "provides the necessary context and permissions to surgically update" with the concrete manifest operations (set status to "installed", clear the error field).

Add natural trigger synonyms users would actually say — "broken skill", "installation error", "failed to install", "skill not loading" — to broaden keyword coverage.

DimensionReasoningScore

Specificity

Names concrete actions — "fix and re-install agent skills that have failed installation" and "surgically update the `manifest.json`" — but "provides the necessary context and permissions" is abstract filler, and the second-person/imperative opening "Use this to..." (rather than third person like "Fixes and re-installs...") incurs the 1-point voice penalty, dropping an anchor-4 fit to 3. Not a 2 because the domain and the manifest-update action are explicitly named.

3 / 5

Completeness

The "what" is clear ("fix and re-install agent skills that have failed installation", "update the `manifest.json`") and the "when" is explicitly stated via "skills that have failed installation" — so the missing-trigger-clause cap does not apply — but the condition is embedded in a purpose statement ("Use this to fix...") rather than an explicit "Use when..." clause, fitting anchor 4 ("'when' could be more explicit or specific"). Not 5 because there is no distinct trigger clause with concrete trigger phrases.

4 / 5

Trigger Term Quality

"fix", "re-install", "failed installation", and "skills" are phrases a user with a broken install would plausibly say, but common variations and synonyms — "broken", "error", "failed to install", "skill not loading" — are absent, matching anchor 3 ("some relevant keywords but missing common variations"). Not 4 because coverage of natural phrasings is thin for the failure/repair vocabulary.

3 / 5

Distinctiveness Conflict Risk

"failed installation", "re-install", and "`manifest.json`" define a clear niche with mostly distinct triggers, but "fix... agent skills" alone could overlap with general skill-editing or skill-debugging requests, giving minor overlap risk with closely related skills — anchor 4. Not 5 because the broad verb "fix" applied to "agent skills" is not uniquely tied to installation repair.

4 / 5

Total

14

/

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

saski/arnesto

Path

.agents/skills/skill-repair/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.