CtrlK
BlogDocsLog inGet started
Tessl Logo

deepchat-sdd-cleanup

Use only when a developer explicitly asks to clean, prune, tidy, or organize DeepChat SDD documentation after implementation and validation. Scans docs/features, docs/issues, and docs/architecture; prefers multi-agent review when available; removes completed issue docs when a linked GitHub issue is closed or implementation and validation evidence proves the bug no longer exists, drops stale plans and legacy task files from completed feature or architecture goals, and deletes obsolete feature or architecture docs.

75

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is a tight, checklist-style instruction skill: concrete commands, evidence-based deletion rules, an explicit never-delete guard list, and a validation section with runnable checks. Its only weakness is mild underspecification in a couple of workflow steps (what to inspect for, what counts as clear evidence).

Suggestions

In Workflow step 1, state what to look for in `docs/spec-driven-dev.md`, `docs/README.md`, and `git status` (e.g., 'to identify active work and cleanup policy') so the inspection has a defined output.

Define the evidence bar for 'Apply only changes with clear evidence' — e.g., link it to the GitHub closure check and the implementation/validation evidence named in the Cleanup Rules.

Show one concrete example of the keep/delete/update handoff list format so step 4 produces a consistent artifact.

DimensionReasoningScore

Conciseness

Lean and efficient throughout: every section carries concrete rules or commands ('Run `rg -n "plan.md|tasks.md|docs/archives|NEEDS CLARIFICATION" docs AGENTS.md .agents/skills`') with zero background-concept padding. Not 4 because nothing reads as trimmable — the skill assumes Claude's competence.

5 / 5

Actionability

Mostly executable guidance with copy-paste commands (`gh issue view <number> --json state,url,title`, `git status --short`, the validation `rg` command) and concrete file-level rules. Not 5 because 'Inspect `docs/spec-driven-dev.md`, `docs/README.md`, and `git status`' never states what to look for, and 'Apply only changes with clear evidence' leaves the evidence bar abstract; not 3 because the core inventory → review → delete → validate loop is executable.

4 / 5

Workflow Clarity

The 5-step workflow has a clear sequence, an optional verifier pass over proposed deletes (a pre-apply feedback loop), a keep/delete/update handoff list, and an explicit Validation section with runnable commands plus a Never Delete checklist. Not 4 because validation checkpoints are explicit, not implicit — the destructive-batch-operation cap does not apply.

5 / 5

Progressive Disclosure

The ~50-line body is entirely rule and command content with well-organized sections (Rule, Workflow, Cleanup Rules, GitHub Checks, Never Delete, Validation) and no content that belongs in bundle files; no references/scripts/assets exist to verify, so per the simple-skill guideline well-organized sections alone earn the top score. Not 4 because nothing is inlined that should be split out.

5 / 5

Total

19

/

20

Passed

Description

92%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 is a strong example: it states an explicit 'Use only when' trigger, then enumerates concrete actions with precise evidence-based conditions in third-person voice. The only gap is a few missing natural trigger synonyms.

DimensionReasoningScore

Specificity

Lists multiple concrete actions ('Scans docs/features, docs/issues, and docs/architecture', 'removes completed issue docs when a linked GitHub issue is closed', 'drops stale plans and legacy task files', 'deletes obsolete feature or architecture docs') each with explicit conditions, giving comprehensive coverage. Not 4 because no capability area is left uncovered.

5 / 5

Completeness

Explicitly answers both questions: 'Use only when a developer explicitly asks to clean, prune, tidy, or organize DeepChat SDD documentation' (when) followed by a full enumeration of what the skill does (what). Matches the 5 anchor with concrete trigger phrases; not 4 because neither half could be more explicit.

5 / 5

Trigger Term Quality

Good natural trigger terms ('clean, prune, tidy, or organize', 'DeepChat SDD documentation', 'after implementation and validation') that a developer would plausibly say. Not 5 because common variations such as 'clean up', 'remove stale docs', or 'documentation cleanup' are absent.

4 / 5

Distinctiveness Conflict Risk

A clear niche — DeepChat SDD documentation cleanup gated on an explicit developer request — with distinct triggers and no overlap with generic documentation or code skills. Not 4 because the explicit-request gating plus repo-specific paths make accidental triggering very unlikely.

5 / 5

Total

19

/

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
ThinkInAIXYZ/deepchat
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.