CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

audit-session-metrics

Audit a session-metrics JSON export for token-usage waste and produce a plain-English findings report. Trigger when the user runs /audit-session-metrics, when session-metrics suggests an audit after an HTML export, or when the user asks to audit / review / find waste in a saved session-metrics JSON. Two modes: "quick" (ratios + cache health + top expensive turns/sessions) and "detailed" (adds CLAUDE.md / settings / re-read scan). Supports session, project, and instance JSON scopes. Args: $ARGUMENTS[0] = quick|detailed, $ARGUMENTS[1] = path to a session-metrics JSON export.

Quality

87%

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

78%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 well-engineered operational skill: dispatch, routing, output contract, and write order are fully executable, and the reference bundle is cleanly structured one level deep. The main drag is conciseness — duplicated model/provider rationale and time-sensitive version details sit inline instead of in a trimmer note or reference.

Suggestions

State the /model haiku cost tip once (a single short line) instead of twice, and drop the model-pin history parenthetical — it explains a past design decision, not what to do now.

Move provider-specific Haiku version/window details (time-sensitive numbers) into a reference file or a short 'Provider notes' subsection so the main body stays version-stable.

Add one error-recovery line for the extract helper (e.g., what to do if it exits non-zero or emits an unrecognized digest.scope) to close the workflow's remaining validation gap.

DimensionReasoningScore

Conciseness

The operational core (dispatch, steps, output contract) is lean, but the body carries noticeable non-instructional material: the model-pin history parenthetical ('it no longer pins one — a hard model pin capped the usable context…'), provider-specific Haiku versioning repeated twice (intro and 'Why this is a separate skill'), and time-sensitive version numbers ('Haiku 5.5', '1M window', '200k window') outside any deprecated section. Mostly efficient but could be tightened — matching the 3 anchor; the duplication is more than the 'minor instances' of 4, while the lean operational core keeps it above 2.

3 / 5

Actionability

Fully executable guidance throughout: the exact helper command ('python3 scripts/audit-extract.py $ARGUMENTS[1] --mode $ARGUMENTS[0]'), literal-equality dispatch table, exact accepted file patterns, a verbatim usage message to print, exact sidecar/markdown output paths with field sources, a precise write order, and an explicit tool directive ('Use the Write tool directly… Do NOT generate a Python script'). Copy-paste ready and covers the common cases.

5 / 5

Workflow Clarity

Clear 5-step sequence with explicit validation checkpoints: missing/invalid path argument triggers a verbatim usage message and stop, digest.scope drives reference routing, and config files are capped at ≤500 lines with the violation itself flagged as a finding. It falls short of 5 because there is no error-recovery guidance for helper failure or a malformed digest — no feedback loop — leaving minor validation gaps at the 4 anchor.

4 / 5

Progressive Disclosure

SKILL.md is a genuine overview: routing tables specify exactly which of the five reference playbooks to read per scope/mode, and all five referenced files (quick-audit.md, detailed-audit.md, project-quick-audit.md, project-detailed-audit.md, instance-quick-audit.md) exist in references/ with a when-to-read description each. References are one level deep — playbooks defer to the shipped script, not to further documents — matching the 5 anchor.

5 / 5

Total

17

/

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.

A strong description: concrete capabilities, explicit multi-condition triggers, and mode/scope coverage that makes it both discoverable and distinct. Its only weakness is keyword coverage that stops short of the cost/spending vocabulary users may naturally use alongside 'waste'.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Audit a session-metrics JSON export for token-usage waste and produce a plain-English findings report' with mode-specific sub-actions ('ratios + cache health + top expensive turns/sessions', 'adds CLAUDE.md / settings / re-read scan') and three named JSON scopes — giving comprehensive, specific coverage.

5 / 5

Completeness

Explicitly answers both 'what' (audits a session-metrics JSON export for token-usage waste, produces a plain-English findings report) and 'when' with concrete trigger phrases ('Trigger when the user runs /audit-session-metrics, when session-metrics suggests an audit after an HTML export, or when the user asks to audit / review / find waste in a saved session-metrics JSON'). This matches the 5 anchor exactly; the 'when' clause is fully explicit, not merely present.

5 / 5

Trigger Term Quality

Includes natural trigger phrases users would say ('audit / review / find waste in a saved session-metrics JSON', '/audit-session-metrics', 'after an HTML export'), but omits common synonyms like token usage, cost, or spending that a user might naturally use. Good coverage with a few natural terms missing, matching the 4 anchor rather than the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

Clear niche tied to a specific artifact — session-metrics JSON exports — with distinct triggers; even the generic verbs ('audit / review / find waste') are scoped to that artifact, so overlap risk with other skills is minimal.

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

centminmod/my-claude-code-setup

Path

.claude/skills/audit-session-metrics/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.