CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

config-gc

Garbage collection for your Claude Code configuration. Periodically scans ~/.claude (skills, memory, hooks, permissions, MCP servers, caches) for redundant, stale, orphaned, or low-value items, then walks the user through a confirm-each-deletion cleanup. Use when the user says "clean up my config", "config GC", "too many skills", "audit my setup", "my .claude is bloated", or asks for a periodic config review.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 high-quality, self-contained instruction skill: concrete executable commands with portability and undo considerations, a clearly sequenced confirm-each-deletion workflow, and well-organized sections. The main weaknesses are mild repetition of the human-in-the-loop rule and a missing post-edit validity check after the jq-based settings rewrite.

Suggestions

Add a verification step after the jq permission-removal example (e.g., 'jq empty ~/.claude/settings.local.json' before considering the edit done) so a failed rewrite cannot silently truncate or corrupt the live settings file.

Consolidate the human-in-the-loop rule, which currently appears in Design Philosophy (#4 and #5), Workflow step 3, and Anti-Patterns, into one authoritative statement to trim repeated tokens.

Consider moving per-channel detection snippets into a reference file (e.g., references/channels.md) so SKILL.md stays a lean overview of the workflow and signals where channel detail lives.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence (channels table, executable commands, no basic concept explanations), but the human-in-the-loop rule is stated three times (Design Philosophy #4/#5, Workflow step 3, Anti-Patterns 'Bulk approval') and the Related Skills section adds marginal tokens. Not 3: padding is minor, not pervasive; not 5: some repetition and the Related Skills list could be trimmed.

4 / 5

Actionability

Copy-paste-ready executable bash covering the common cases: orphaned-hook detection loop, duplicate/shadowed permission detection with jq, du -k cache sizing, soft-delete with undo logging, and backup-then-remove of a permission entry via jq. Not 4: the commands are complete and directly runnable, with the macOS/BSD portability choice even justified inline.

5 / 5

Workflow Clarity

The six-step workflow (Scan, Rank, Confirm one-by-one, Soft-delete, Log, Report) has an explicit validation checkpoint (per-candidate '[y/n/skip]' with the user able to stop) and undo paths (`.disabled`, `_gc_trash/<date>/`, `.bak`), so the destructive-operation cap of 3 does not apply. Not 3: validation is present; not 5: the jq permission-removal example lacks a post-edit verification that the rewritten JSON is valid before it replaces the live settings file.

4 / 5

Progressive Disclosure

No bundle files exist; the skill is a single well-sectioned document with a clear channels table and organized sections, and it needs no external references. Not 3: structure is good and nothing is buried; not 5: at ~113 lines with eight channels, some per-channel detection logic could be split into reference files, and the under-50-line simple-skill exception does not strictly apply.

4 / 5

Total

17

/

20

Passed

Description

95%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: it enumerates the scanned channels and the confirm-each-deletion workflow, and supplies a rich set of natural user trigger phrases. The only blemish is the second-person 'your Claude Code configuration' phrasing, which costs it a point on specificity under the rubric's voice rule.

DimensionReasoningScore

Specificity

The description lists multiple concrete, comprehensive actions ('Periodically scans ~/.claude (skills, memory, hooks, permissions, MCP servers, caches) for redundant, stale, orphaned, or low-value items, then walks the user through a confirm-each-deletion cleanup'), but 'Garbage collection for your Claude Code configuration' uses second-person voice, which the rubric penalizes by one point. Not 3: action coverage is comprehensive rather than partial; not 5: the second-person penalty applies.

4 / 5

Completeness

Both 'what' (scan channels for redundant/stale/orphaned items, then confirm-each-deletion cleanup) and 'when' ('Use when the user says ... or asks for a periodic config review') are explicit and concrete. Not 4: the 'when' clause enumerates specific trigger phrases rather than being merely adequate.

5 / 5

Trigger Term Quality

'clean up my config', 'config GC', 'too many skills', 'audit my setup', 'my .claude is bloated', and 'periodic config review' comprehensively cover the natural phrases a user would say, including slang ('bloated') and the skill's own nickname ('config GC'). Not 4: no common variation is missing.

5 / 5

Distinctiveness Conflict Risk

A clear niche (garbage-collecting the Claude Code configuration under ~/.claude) with distinct triggers ('config GC', 'my .claude is bloated') minimizes conflict with other skills. Not 4: the scope and paths named leave essentially no ambiguity about which skill should fire.

5 / 5

Total

19

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

Path

skills/config-gc/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.