CtrlK
BlogDocsLog inGet started
Tessl Logo

ambaba/skill-retirer

Delete or retire a Tessl skill: unpublish, remove dependencies, delete directory, re-install.

90

Quality

90%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong skill description that concisely covers specific actions (unpublish, remove dependencies, delete directory, clean topology, re-install), provides explicit trigger terms via a 'Use when' clause, and occupies a clear niche. It uses third person voice appropriately and avoids vague language or unnecessary verbosity.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: unpublish/delete from registry, remove dependencies, delete directory, clean topology references, re-install. These are detailed, actionable steps.

3 / 3

Completeness

Clearly answers both 'what' (fully delete a Tessl skill with specific steps) and 'when' (explicit 'Use when' clause with quoted trigger phrases).

3 / 3

Trigger Term Quality

Includes natural trigger terms users would actually say: 'delete skill', 'retire skill', 'remove skill', 'nuke skill'. These cover common variations of how a user would express wanting to fully remove a skill.

3 / 3

Distinctiveness Conflict Risk

Very specific niche: fully deleting/retiring a Tessl skill with registry and topology cleanup. The combination of 'Tessl skill' + 'delete/retire' + specific cleanup steps makes it highly distinct and unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Implementation

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a strong, well-structured skill with excellent actionability and workflow clarity. The step-by-step process is clearly sequenced with concrete commands, validation checkpoints, error recovery paths, and a comprehensive retirement checklist. Minor weaknesses include some redundancy between the HARD RULES, Notes, and Steps sections, and the file is somewhat long but not egregiously so.

Suggestions

Remove the 'Notes' section as its points are already covered by the HARD RULES and the steps themselves, reducing redundancy.

DimensionReasoningScore

Conciseness

The content is mostly efficient but has some redundancy — the 'Notes' section repeats points already covered in the steps (e.g., 'Always confirm with user before deleting' is already a HARD RULE and Step 1). The 'Common issues' section adds useful but slightly verbose edge cases. Overall reasonably tight but could be tightened.

2 / 3

Actionability

Every step includes concrete, executable bash commands with specific file paths and tool invocations. The registry removal shows a clear fallback chain (unpublish → delete → archive). The retirement checklist provides copy-paste-ready verification commands.

3 / 3

Workflow Clarity

The 7-step workflow is clearly sequenced with logical ordering (check dependencies first, then registry, then local, then references). Explicit validation in Step 7 with verification commands, a comprehensive retirement checklist, and a dedicated error recovery section with feedback loops (unpublish fails → try delete → try archive) make this exemplary.

3 / 3

Progressive Disclosure

The content is well-structured with clear sections and headers, but it's a fairly long single file. The batch retirement, common issues, and error recovery sections could potentially be split into a separate reference file. However, for a skill of this complexity, keeping it in one file is defensible — it's just on the edge of being too much inline content.

2 / 3

Total

10

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Reviewed

Table of Contents