CtrlK
BlogDocsLog inGet started
Tessl Logo

ambaba/skill-retirer

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

94

Quality

94%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

SKILL.md

name:
skill-retirer
description:
Fully delete a Tessl skill: unpublish/delete from registry, remove dependencies, delete directory, clean topology references, re-install. Use when: "delete skill", "retire skill", "remove skill", "nuke skill".

Skill Retirer

Fully remove a skill from the Tessl ecosystem.

HARD RULES

ONLY publish to ambaba workspace. All tessl tile commands MUST use --workspace ambaba. NEVER lose content during retirement merges. Verify target has all source knowledge first. NEVER delete without explicit user confirmation. Present what will be removed and wait for "yes".

Steps

1. Check inbound synapses

Read ~/.claude/memory/brain-topology.md "Synapses IN". If other skills delegate to target, warn and list callers.

2. Remove from registry

tessl tile list --workspace ambaba | grep <skill-name>
tessl tile unpublish --tile ambaba/<skill-name>@<version>   # 2-day window
tessl tile delete --tile ambaba/<skill-name>                # if unpublish fails
tessl tile archive --tile ambaba/<skill-name>               # fallback

If never published (local-only), skip.

3. Remove dependency from ~/.tessl/tessl.json

4. Remove source directory

rm -rf ~/.claude/skills/<skill-name>

5. Clean topology references

Remove from tables, add to Prune Log with date/name/action/reason.

6. Clean references in other skills

grep -rl '<skill-name>' ~/.claude/skills/*/SKILL.md — warn if found.

7. Re-install and verify

tessl install --global

Confirm skill gone from registry, tessl.json, skills dir, topology, and other skills.

Delegatetessl__skill-retirer-checklist for retirement checklist, error recovery, and batch mode.

SKILL.md

tile.json