# Minutes Weekly

Weekly meeting synthesis, themes, decision arcs, stale commitments, and what deserves...

- Repository: https://github.com/silverstein/minutes (1583 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add silverstein/minutes --skill minutes-weekly -g -a claude-code -y`
Codex: `npx skills add silverstein/minutes --skill minutes-weekly -g -a codex -y`
Cursor: `npx skills add silverstein/minutes --skill minutes-weekly -g -a cursor -y`
Gemini CLI: `npx skills add silverstein/minutes --skill minutes-weekly -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add silverstein/minutes`

## Description

Weekly meeting synthesis, themes, decision arcs, stale commitments, and what deserves your attention next week. Use when the user says "weekly review", "what happened this week", "weekly summary", "recap my week", "any outstanding items", "week in review", or at the end of a work week.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## Skill Path

Before running helper scripts or opening bundled references, set:

```bash
export MINUTES_SKILLS_ROOT="$(git rev-parse --show-toplevel)/.agents/skills/minutes"
export MINUTES_SKILL_ROOT="$MINUTES_SKILLS_ROOT/minutes-weekly"
```

# /minutes-weekly

Synthesize a week of policy-authorized normal meetings and voice memos into a
forward-looking brief, themes, decision arcs, stale commitments, and what
deserves attention Monday. Restricted history is excluded by default.

## How it works

This is a synthesis skill, not a command wrapper. It reads across the normal
meetings authorized by Minutes, cross-references decisions and action items,
and produces an intelligence brief. Restricted meetings are excluded from this
agent workflow by default and must never be treated as absent facts.

### Phase 1: Gather this week's recordings

```bash
minutes list --limit 50
```

Filter to recordings from the last 7 days by checking the `date` field in each result's frontmatter. Do NOT use `minutes search` with a date string as the query, that searches file content, not dates.

For each selected recording, run `minutes get "<exact path>" --json`, require
exit status 0, and use only the returned content. List/search paths are hints,
not retained capabilities; never reopen them with the host `Read` tool.

**If zero recordings this week:**
Say: "No recordings found for the past 7 days. Nothing to synthesize."
Offer: "Want me to look at the past 2 weeks instead?"
Do NOT hallucinate a weekly summary.

**If only 1-2 recordings:**
Still produce the brief, it's shorter but still valuable. Note: "Light week, only [N] recordings."

### Phase 2: Theme extraction

Identify the 3-5 dominant themes across the authorized normal meetings this week. A theme is a topic that appeared in 2+ meetings.

For each theme:
- Which meetings discussed it
- How the conversation evolved across meetings
- Whether a resolution was reached

Present as:

```
## This Week's Themes

The rest: https://github.com/silverstein/minutes/blob/HEAD/.agents/skills/minutes/minutes-weekly/SKILL.md