CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

minutes-recap

Generate a daily digest of today's policy-authorized meetings and voice memos — key decisions, action items, and themes across available recordings. Use when the user asks "recap my day", "what happened in my meetings today", "daily summary", "what did I discuss today", "any action items from today", or wants a consolidated view of the day's conversations.

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

71%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 provides concrete, executable commands with a well-sequenced workflow and unusually good error-recovery guidance in the Gotchas section. Its main weaknesses are a dangling reference to a nonexistent templates/daily-recap.md file, unspecified recovery on command failure, and a few motivational sentences that could be trimmed.

Suggestions

Fix the dangling reference in step 3: either add templates/daily-recap.md to the skill bundle or inline the template's section structure directly in SKILL.md so Claude can actually follow it.

Add a brief recovery instruction for failed commands (e.g., what to do when `minutes list` or `minutes get` exits non-zero), which would also raise workflow clarity to the top anchor.

Trim motivational sentences such as "This turns the recap from a passive report into an active reconciliation tool" and "ideas captured on the go are easy to forget" — they add tokens without adding executable guidance.

DimensionReasoningScore

Conciseness

The body is mostly lean and command-driven, but a few rationale sentences earn no tokens for execution: "This turns the recap from a passive report into an active reconciliation tool" and "ideas captured on the go are easy to forget" explain motivation Claude doesn't need. This fits the 4 anchor ("efficient; minor instances of over-explanation that could be trimmed") rather than the 5 anchor's every-token-earns-its-place bar, and is well above the 3 anchor's more substantial padding.

4 / 5

Actionability

Concrete, executable commands are given (`minutes list --limit 50`, `minutes get "<exact path>" --json`) along with a specific AskUserQuestion prompt with options. It falls short of the 5 anchor because the referenced template `templates/daily-recap.md` does not exist in the skill bundle (there is no references/, scripts/, or assets/ directory), and the date filtering ("select entries whose `date` is today") is described but not shown as a runnable command.

4 / 5

Workflow Clarity

The four-step sequence (list → get → synthesize → present) is clearly ordered with explicit checkpoints ("Require exit status 0" for both commands) and a Gotchas section covering empty days, missed memos, unstructured transcripts, and cross-day meetings. It stops short of the 5 anchor because there is no recovery guidance when a command exits non-zero — the checkpoint is stated but the feedback loop (what to do on failure) is missing, matching the 4 anchor's "minor validation gaps".

4 / 5

Progressive Disclosure

Sections are well-organized with clear headers, but step 3 points to `templates/daily-recap.md`, which is not present in the bundle (no references/, scripts/, or assets/ directories exist) — a dangling reference Claude cannot follow. This fits the 3 anchor ("references present but not clearly signaled" / organizational gaps): the fix is either shipping the template file or inlining the template structure.

3 / 5

Total

15

/

20

Passed

Description

100%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 exemplary: it states what the skill does and when to use it in third person, with concrete deliverables and an extensive set of natural trigger phrases. It closely matches the rubric's good overall examples with no over-claims or padding.

DimensionReasoningScore

Specificity

"Generate a daily digest of today's policy-authorized meetings and voice memos — key decisions, action items, and themes" names the domain, the concrete action, and multiple specific deliverables (decisions, action items, themes, consolidated view), which is comprehensive coverage for this skill. It matches the 5 anchor ("multiple specific concrete actions; comprehensive coverage") and exceeds the 4 anchor because there are no meaningful gaps in what the skill produces.

5 / 5

Completeness

The first sentence explicitly answers "what" (generate a daily digest of meetings and voice memos with decisions, action items, themes) and the second sentence explicitly answers "when" with concrete trigger phrases ("Use when the user asks..."). This mirrors the 5 anchor's example structure; the 4 anchor would apply only if the 'when' were less explicit.

5 / 5

Trigger Term Quality

Five quoted natural phrases users would actually say ("recap my day", "what happened in my meetings today", "daily summary", "what did I discuss today", "any action items from today") plus the broader "consolidated view of the day's conversations" give comprehensive coverage with synonyms. This matches the 5 anchor's bar for natural-term coverage including variations.

5 / 5

Distinctiveness Conflict Risk

"policy-authorized meetings and voice memos" plus recap-specific triggers ("recap my day", "what did I discuss today") carve out a clear niche with minimal overlap risk against generic note-taking or document skills. "daily summary" is slightly broad, but in context it stays anchored to the day's conversations, so it fits the 5 anchor rather than the 4 anchor's "minor overlap risk".

5 / 5

Total

20

/

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

silverstein/minutes

Path

tooling/skills/goldens/claude/minutes-recap/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.