minutes-brief

Fast non-interactive briefing before any meeting — auto-detects your next calendar event, pulls relationship history, surfaces open commitments, and produces a one-page brief in under 30 seconds. Use this whenever the user says "brief me", "give me a quick brief", "what's coming up", "background on my next call", "who am I meeting next", "brief me on Sarah", "I have a call in 10 min", "quick rundown", or right before walking into a meeting. Different from /minutes-prep — brief is the fast hook-fireable version that doesn't ask questions and doesn't set goals. Use brief when speed matters; use prep when the user wants to think hard about goals first.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

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.

A strong, highly actionable workflow skill with concrete commands, explicit validation, and clear sequencing. Its main weakness is mild verbosity and an inline version marker that would benefit from a deprecated/old-patterns framing.

Suggestions

Move the 'Today (0.8.0)' CLI stream-contract notes into a clearly labeled versioned/old-patterns subsection so future CLI changes don't leave stale time-sensitive detail inline.

Consider extracting the first-name slug rules and the CLI stream-handling contract into a short reference file, keeping SKILL.md as the lean overview.

Tighten the Bad/Good 'Open with' example to one good/bad pair to save tokens while preserving the lesson.

Dimension	Reasoning	Score
Conciseness	Largely lean and actionable with little concept-explanation Claude already knows, but a few sections could be tightened (the Bad/Good 'Open with' block is pedagogically useful yet long) and the inline time-sensitive marker 'Today (0.8.0)' is not isolated in a deprecated/old-patterns section.	4 / 5
Actionability	Fully executable guidance throughout — exact bash commands, the Google Calendar MCP call, the osascript snippet, and a concrete brief template with frontmatter and chmod steps — copy-paste ready with clearly parameterized placeholders.	5 / 5
Workflow Clarity	A clearly sequenced Phase 0–5 pipeline with explicit validation checkpoints ('require exit status 0', 'verify it with live-source search'), feedback loops for nonzero exits, and a Gotchas section that functions as an operational checklist.	5 / 5
Progressive Disclosure	Well-organized into clearly headed sections (Skill Path, How it works phases, Gotchas) with no nested references and no bundle files to navigate, though it is a single ~200-line file where some reference material (e.g., the slug rules or CLI stream contract) could optionally live in a separate file.	4 / 5
	Total	18 / 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.

An exemplary description: third-person voice, concrete capabilities, exhaustive natural-language triggers, and explicit boundary guidance against the sibling /minutes-prep skill. No fluff or over-claims.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'auto-detects your next calendar event, pulls relationship history, surfaces open commitments, and produces a one-page brief in under 30 seconds' — covering the full pipeline comprehensively.	5 / 5
Completeness	Explicitly answers both what (the four briefing actions) and when (a full enumeration of trigger phrases plus the pre-meeting situation), matching the score-5 anchor that requires concrete trigger phrases for both.	5 / 5
Trigger Term Quality	Comprehensive coverage of natural phrases a user would actually say ('brief me', 'give me a quick brief', 'what's coming up', 'who am I meeting next', 'I have a call in 10 min', 'quick rundown') plus the situational trigger 'right before walking into a meeting'.	5 / 5
Distinctiveness Conflict Risk	Explicitly disambiguates from the sibling skill ('Different from /minutes-prep ... Use brief when speed matters; use prep when the user wants to think hard about goals first'), giving it a clear niche with minimal conflict risk.	5 / 5
	Total	20 / 20 Passed

Validation

100%

Warnings & errors only

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
Path: .agents/skills/minutes/minutes-brief/SKILL.md
Commit: 2d8379f

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.