CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-stocktake

Use when auditing Claude skills and commands for quality. Supports Quick Scan (changed skills only) and Full Stocktake modes with sequential subagent batch evaluation.

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 highly actionable, well-sequenced operational skill with executable bash for every phase and genuine validation checkpoints for a batch process. Its main weaknesses are redundancy — resume and cache semantics are explained three times — and modest opportunity to move example/schema detail into a reference file.

Suggestions

Consolidate the resume/`--replace`/mtime-preservation rules into one canonical section; the `.trash` paragraph, the `--replace` paragraph, and 'Resume detection' each restate overlapping semantics.

Move the reason-quality good/bad examples and the results.json schema into a references/ file (e.g., verdicts.md) to slim SKILL.md, keeping the phases at its top level.

De-duplicate the 'Project dir is auto-detected from $PWD/.claude/skills' note, which appears in both the Quick Scan and Phase 1 sections.

DimensionReasoningScore

Conciseness

The body is dense with mostly necessary operational detail (exact bash blocks, script invocations, schemas), but the resume/`--replace`/mtime-preservation semantics are restated in three places (the `.trash` paragraph, the `--replace` paragraph, and the 'Resume detection' paragraph) and 'Project dir is auto-detected' appears twice. This is more than minor trimming, so it fits 'mostly efficient but could be tightened' rather than 'efficient with minor instances'.

3 / 5

Actionability

Fully executable throughout: complete copy-paste bash invocations for scan, save, resume, and completion (including the `jq -e` guard), exact script paths, a concrete results.json schema, and good/bad example strings for every verdict reason. Specific examples cover the common cases, matching the top anchor.

5 / 5

Workflow Clarity

Clear phased sequence (Inventory, Evaluation, Summary, Consolidation) with explicit validation checkpoints for a batch operation: the completion guard errors on unevaluated skills, Quick Scan stops on `[]`, resume detection reconciles state before evaluation, and destructive archive/delete actions require explicit user confirmation. A literal evaluation checklist is included, matching the top anchor.

5 / 5

Progressive Disclosure

The three operational scripts (quick-diff.sh, save-results.sh, scan.sh) are externalized to scripts/ and invoked by name one level deep (all verified present in the bundle), and the body is well-sectioned with headers and tables. Minor gap: the reason-quality good/bad examples and the results-file schema are inlined in SKILL.md and could live in a reference file, keeping it at 'good structure, minor organization gaps' rather than a fully split overview.

4 / 5

Total

17

/

20

Passed

Description

73%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 concise, well-targeted description with an explicit 'Use when' trigger and a distinct niche, weakened only by a vague 'what' — it never concretely states what the audit delivers (verdicts, checklist, consolidation steps) or the natural vocabulary users might use to request it.

Suggestions

State the concrete outputs in the description, e.g., 'Evaluates each skill against a quality checklist and returns Keep/Improve/Update/Retire/Merge verdicts with consolidation guidance.'

Add natural trigger synonyms users would say, such as 'review', 'inventory', or 'take stock of skills and commands'.

Mention that results are cached in results.json so incremental re-scans are discoverable from the description.

DimensionReasoningScore

Specificity

Names the domain ('auditing Claude skills and commands for quality') and 1-2 capabilities ('Quick Scan (changed skills only)', 'Full Stocktake modes'), but never states what the audit produces (verdicts, checklist, consolidation). It lists a couple of concrete actions without comprehensive coverage, matching the anchor for domain + 1-2 concrete actions rather than the several specific actions of the level above.

3 / 5

Completeness

It has both an explicit 'Use when' trigger ('Use when auditing Claude skills and commands for quality') and a what ('auditing ... for quality' with two modes), so it sits above a clear-what-with-weak-when (3). It falls short of 5 because the 'what' is thin — the concrete audit outcomes (checklist, Keep/Improve/Retire verdicts, consolidation) are not stated.

4 / 5

Trigger Term Quality

Natural terms a user would say are present: 'auditing', 'Claude skills', 'commands', 'quality'. Coverage is good but a few natural variations are missing (e.g., 'review', 'take stock of', 'inventory', 'retire stale skills'), placing it at good-coverage-with-gaps rather than comprehensive-with-synonyms.

4 / 5

Distinctiveness Conflict Risk

'Auditing Claude skills and commands for quality' is a clear niche with distinct triggers; very few skills would compete for this invocation, matching the clear-niche anchor.

5 / 5

Total

16

/

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/skill-stocktake/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.