CtrlK
BlogDocsLog inGet started
Tessl Logo

retire-legacy-distribution-surface

Pattern for safely removing an obsolete package/distribution surface without breaking the surviving release path.

40

Quality

37%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.squad/skills/retire-legacy-distribution-surface/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%

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

This skill provides a reasonable high-level checklist for removing obsolete package surfaces, with a useful concrete example grounding the abstract steps. However, it lacks executable commands or validation checkpoints that would make it truly actionable for a destructive multi-step workflow, and the 'Why' section adds motivational context that Claude doesn't need.

Suggestions

Add explicit validation/verification steps after removal (e.g., 'Run CI pipeline or `grep -r old-package-name .github/` to confirm no stale references remain') to create a feedback loop for this destructive operation.

Replace or supplement the abstract pattern steps with concrete, executable commands (e.g., `git rm -r packages/legacy-dir`, `grep -rn 'legacy-package' .github/workflows/`) to increase actionability.

Remove or significantly trim the 'Why' section — Claude can infer the rationale from the pattern itself, and these tokens don't add actionable guidance.

DimensionReasoningScore

Conciseness

The 'Why' section explains motivations that Claude can infer from the pattern itself, adding some unnecessary context. The 'Context' line is also somewhat redundant given the pattern is self-explanatory. However, the core pattern steps are reasonably lean.

2 / 3

Actionability

The pattern provides a clear ordered checklist and a concrete example section with specific file/directory names, but lacks executable commands or code snippets. The steps are descriptive rather than copy-paste ready — e.g., 'Remove release workflow upload/publish steps' doesn't show how to identify or remove them.

2 / 3

Workflow Clarity

The 7-step sequence is logically ordered and step 6 mentions re-validation of the replacement path, but there are no explicit validation checkpoints or feedback loops (e.g., 'run CI to confirm nothing references the old surface'). For a destructive/removal operation, the lack of a verify-after-removal step caps this at 2.

2 / 3

Progressive Disclosure

For a simple, single-purpose skill under 50 lines with no need for external references, the content is well-organized into clear sections (Context, Pattern, Why, Example) that are easy to scan and navigate.

3 / 3

Total

9

/

12

Passed

Description

17%

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 too abstract and jargon-heavy to serve as an effective skill selector. It lacks concrete actions, natural trigger terms users would use, and an explicit 'Use when...' clause. The phrase 'distribution surface' and 'surviving release path' are unusual terms that would not help Claude match this skill to user requests.

Suggestions

Add a 'Use when...' clause with natural trigger terms like 'remove package', 'deprecate distribution', 'delete obsolete module', 'clean up unused package'.

List specific concrete actions the skill covers, e.g., 'Updates dependency manifests, removes build targets, updates CI pipelines, and cleans up references to the deprecated package'.

Replace jargon like 'distribution surface' and 'surviving release path' with plain language such as 'package', 'release channel', or 'distribution method'.

DimensionReasoningScore

Specificity

It names a domain ('removing an obsolete package/distribution surface') and a general action ('safely removing'), but does not list multiple concrete actions or steps involved in the process.

2 / 3

Completeness

It partially addresses 'what' (removing an obsolete package) but has no explicit 'when' clause or trigger guidance. The absence of a 'Use when...' clause caps this at 2, and the 'what' itself is vague enough to warrant a 1.

1 / 3

Trigger Term Quality

The description uses abstract/technical phrases like 'distribution surface' and 'surviving release path' that users are unlikely to naturally say. It lacks common trigger terms like 'deprecate package', 'remove module', 'delete distribution', or specific tooling references.

1 / 3

Distinctiveness Conflict Risk

The concept of removing an obsolete package/distribution is somewhat specific, but the vague phrasing ('distribution surface', 'release path') could overlap with general refactoring, deprecation, or package management skills.

2 / 3

Total

6

/

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.

Repository
sbroenne/mcp-server-excel
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.