CtrlK
BlogDocsLog inGet started
Tessl Logo

minutes-debrief

Post-meeting debrief — analyzes what happened, compares outcomes to your prep intentions, tracks decision evolution. Use when the user says "debrief", "what just happened in that meeting", "what did we decide", "debrief that call", "post-meeting", "what changed", or right after stopping a recording.

73

Quality

89%

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

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

This is a highly actionable, well-sequenced interactive workflow: concrete commands, exact user-facing prompts, explicit validation gates, and thoughtful edge-case handling (sensitive meetings, stale preps, speaker attribution). The only meaningful improvements are de-duplicating the presentation-focus instructions and moving some inline reference material into a separate file to tighten the main body.

Suggestions

De-duplicate the presentation-focus check: state the node get-presentation-focus command and the three ordering rules once (e.g., in a shared step before Phase 4) instead of repeating them in both Phase 4a and Phase 4b.

Move the decision-evolution classification rubric (STABLE/VOLATILE/CONFLICTING/NEW) and the presentation-preference ordering rules into a one-level-deep reference file to keep SKILL.md a leaner overview.

Tighten Phase 2a: the "do not edit the meeting path" and "Sensitivity is binding, not advisory" bullets restate the same restriction three times; consolidate into a single clear rule.

DimensionReasoningScore

Conciseness

The body is dense with instructions, exact commands, and templates rather than concept explanations — it assumes Claude's competence throughout. Minor trimming is possible: the "check for a learned debrief presentation preference" block with its node CLI call is repeated nearly verbatim in Phase 4a and Phase 4b, and parts of the Phase 2a sensitivity discussion ("Sensitivity is binding, not advisory") restate the same constraint twice. Not a 3 because the padding is incidental, not systematic.

4 / 5

Actionability

Every phase gives copy-paste-ready commands (`minutes list --limit 5`, `minutes get "<exact path>" --json`, the `minutes-learn-cli.mjs` calls, `minutes search "<topic>" --limit 10`) plus exact AskUserQuestion wording and literal output templates. Specific examples cover the common cases (prep-connected vs. standalone, multi-recording, no-recording).

5 / 5

Workflow Clarity

The six phases are clearly sequenced with explicit branching and validation checkpoints: require exit status 0 on `minutes get`, a hard stop when no recording exists ("Don't proceed without a recording to debrief"), the capture:none alternative path, 48-hour staleness rule for preps, and user confirmation when multiple recordings or preps match. Error-recovery paths (no recording, no prep, unattributed speakers) are all handled explicitly.

5 / 5

Progressive Disclosure

There are no bundle files (references/, scripts/, assets/ all absent), so the skill is a single well-organized file with clear phase and Gotcha sections and no nested references — good structure with nothing misfiled. It falls short of 5 because at ~230 lines some cohesive-but-separable material (the presentation-focus preference logic, the decision-evolution classification rubric) is inlined where a one-level-deep reference file would keep the overview leaner.

4 / 5

Total

18

/

20

Passed

Description

91%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 that clearly states what the skill does and provides an unusually rich set of natural trigger phrases, including question forms and a temporal trigger. The only weakness is the generic "analyzes what happened" action and the slightly over-broad "what changed" trigger.

DimensionReasoningScore

Specificity

The description lists three concrete actions — "analyzes what happened", "compares outcomes to your prep intentions", "tracks decision evolution" — of which the latter two are specific and distinctive. It falls just short of a 5 because "analyzes what happened" is generic and there is no mention of concrete outputs (e.g., decisions, action items).

4 / 5

Completeness

It explicitly answers both questions: what ("analyzes what happened, compares outcomes to your prep intentions, tracks decision evolution") and when ("Use when the user says 'debrief', ... or right after stopping a recording") with concrete trigger phrases. It cannot score below 5 since both elements are present and explicit.

5 / 5

Trigger Term Quality

Trigger coverage is comprehensive and phrased as natural user utterances: "debrief", "what just happened in that meeting", "what did we decide", "debrief that call", "post-meeting", "what changed", "right after stopping a recording". These include synonyms, question forms, and a timing-based trigger, matching the top anchor.

5 / 5

Distinctiveness Conflict Risk

The meeting-debrief niche is clear and most triggers ("debrief", "post-meeting") are distinct, but "what changed" is broadly generic and the skill family (minutes-prep, minutes-weekly) creates minor overlap risk with closely related skills — the exact anchor-4 description rather than the minimal-conflict anchor 5.

4 / 5

Total

18

/

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
silverstein/minutes
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.