CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

minutes-prep

Interactive meeting preparation — builds a relationship brief and talking points before a call. Use when the user says "prep me for my call with", "I'm meeting with X", "prepare me for", "what should I bring up with", "meeting prep", "get ready for my call", or wants to review history with someone before a meeting.

Quality

83%

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

The canonical home for this skill is minutes-prep in silverstein/minutes

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.

A highly actionable, well-sequenced interactive workflow with strong validation and fallback handling. Its main costs are repetition between the phase instructions and the Gotchas section, and a monolithic single-file structure that inlines deep calendar-detection detail a reference file could carry.

Suggestions

Move the Phase 0 calendar-source detection recipes (Google Calendar MCP, gog, osascript, m365 login flow and field parsing) into a references/calendar-detection.md file, keeping only a short source-priority list in SKILL.md.

De-duplicate the Gotchas section against the phases: the first-name slug rule, m365 login behavior, and all-day/solo-event skipping are each stated twice — keep each detail in one place and cross-reference it.

Add a brief fallback for the `minutes` CLI failing or being unavailable (mirroring the calendar sources' skip-silently pattern) so the core history-search step has the same error recovery as the optional ones.

DimensionReasoningScore

Conciseness

The body is command-dense and mostly assumes Claude's competence, but several things are explained twice — the first-name slug rule, the m365 login flow, and the all-day/solo-event skip all appear both in the phases and again in Gotchas — and the m365 timezone over-fetch rationale runs long. It is mostly efficient but noticeably could be tightened, fitting anchor 3 rather than anchor 4's 'minor instances'.

3 / 5

Actionability

Guidance is copy-paste ready throughout: a fully parameterized gcal_list_events call, exact bash for gog/osascript/m365 with login-state branching, `minutes search`/`minutes get` commands, the learn-cli invocations, and a complete prep-file template with frontmatter and chmod 600. It matches the anchor for fully executable commands covering the common cases; score 4 would require gaps in the executable detail, which are absent.

5 / 5

Workflow Clarity

The Phase 0–5 sequence is clear with explicit validation checkpoints ("require exit status 0", "Only use the result if the command exits with code 0 and returns a non-empty JSON array") and error-recovery branches (no calendar → ask manually; zero meetings → first-meeting flow; m365 logged out → offer login or skip). It falls just short of anchor 5 because there is no handling for the core `minutes` CLI failing or being unavailable, leaving a minor validation gap — so it sits between anchors 4 and 5, closer to 4.

4 / 5

Progressive Disclosure

Section structure is good (phases, per-phase branches, a Gotchas checklist), but the skill is ~230 lines in a single file with no external references, and the five calendar-source detection recipes (including the m365 login flow and JSON field parsing) are exactly the kind of bounded detail that belongs in a one-level-deep reference file. That inline placement of separable content matches anchor 3 rather than anchor 4's 'most content is appropriately placed'.

3 / 5

Total

15

/

20

Passed

Description

90%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: it states what the skill does in concrete terms and provides an exemplary, explicit set of natural trigger phrases. The only slight weakness is that the 'what' clause names just two actions rather than a fuller inventory of capabilities.

DimensionReasoningScore

Specificity

The description names the domain ('Interactive meeting preparation') and exactly two concrete actions ('builds a relationship brief and talking points'), matching the anchor for 1-2 concrete actions but not comprehensive coverage. It is not score 4 because it does not list several distinct specific actions, and not score 2 because the actions named are concrete rather than generic.

3 / 5

Completeness

It explicitly answers both 'what' ("builds a relationship brief and talking points before a call") and 'when' ("Use when the user says...") with concrete quoted trigger phrases, exactly matching the anchor-5 example pattern. Score 4 would require the 'when' clause to be less explicit, which it is not.

5 / 5

Trigger Term Quality

It enumerates natural user phrasings — "prep me for my call with", "I'm meeting with X", "prepare me for", "what should I bring up with", "meeting prep", "get ready for my call", "review history with someone" — giving comprehensive synonym-level coverage of how users would actually ask. It clearly matches the top anchor; no common variation is missing.

5 / 5

Distinctiveness Conflict Risk

The niche (pre-meeting preparation grounded in Minutes meeting history) is distinct and the triggers are highly specific conversational phrases, so it is unlikely to fire for unrelated skills. It fits the clear-niche/minimal-conflict anchor; the only adjacent skill (a debrief counterpart) is not invoked by any of these triggers.

5 / 5

Total

18

/

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

.claude/plugins/minutes/skills/minutes-prep/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.