minutes-lint
minutes-lint runs a consistency check across stored meeting records to identify decision conflicts, stale commitments, and contradictions in action items. Use it when users ask to audit their meetings for conflicts, check for overdue action items, verify decision consistency, or review their commitment history across multiple meetings.
git clone --depth 1 https://github.com/silverstein/minutes /tmp/minutes-lint && cp -r /tmp/minutes-lint/tooling/skills/sources/minutes-lint ~/.claude/skills/minutes-lintskill.md
# /minutes-lint
Run a consistency check across all meetings to find decision conflicts and stale commitments.
## How to run the lint
1. **Run the consistency check**:
```bash
minutes consistency --stale-after-days 14
```
Optional filters:
- `--owner <name>` — limit to commitments assigned to a specific person
- `--stale-after-days <N>` — change the staleness threshold (default: 7)
2. **Parse the JSON output** and present it as readable markdown.
## Formatting the report
### Decision Conflicts
For each conflict, show:
```
**Topic: {topic}**
- Latest: "{latest decision text}" — *{meeting title}* ({date})
- Prior: "{prior decision text}" — *{meeting title}* ({date})
- **Status**: These decisions may contradict each other.
```
**Frontmatter v2: resolved supersessions.** When the `resolution` field is
present on a conflict, the newer decision has a `supersedes:` entry in its
frontmatter. Treat this as informational, not a red flag. Format as:
```
**Topic: {topic}** ✓ Resolved
- Current: "{latest decision text}" — *{meeting title}* ({date})
- Superseded: "{prior decision text}" — *{meeting title}* ({date})
- **Status**: {resolution text}
```
If the latest decision also carries an `authority` field (`high`/`medium`/`low`),
surface it next to the title. Authority is optional — when absent, omit the tag.
### Stale Commitments
For each stale item, show:
```
- [ ] **@{who}**: {task} (due {due_date}, {age_days} days overdue)
- Last discussed: *{meeting title}* ({date})
```
### Clean bill of health
If no conflicts and no stale commitments, say: "No decision conflicts or stale commitments found across your meetings. Everything looks consistent."
## When to suggest next steps
- If there are decision conflicts: suggest running `/minutes-debrief` on the most recent conflicting meeting, or `/minutes-search "{topic}"` to review the full decision history
- If there are stale commitments: suggest the user update the action item status in the meeting file, or bring it up in the next meeting with that person
- If the user wants to dig deeper into a specific person's commitments: suggest `minutes commitments --person "{name}"`
## Gotchas
- **The consistency check uses graph.db** — if it seems stale, suggest `minutes people --rebuild` to refresh the index
- **Stale != forgotten** — some action items are intentionally deferred. Don't alarm the user; present the data and let them decide
- **Decision conflicts are topic-based** — two meetings discussing "pricing" with different conclusions will flag, even if the later decision intentionally superseded the earlier one. Context matters.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.
Manage old recordings — find large files, archive old meetings, delete processed originals. Use when the user says "clean up recordings", "how much space are meetings using", "delete old recordings", "archive meetings", "manage meeting storage", or asks about disk space from minutes.
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.
Cross-meeting entity graph — query who/what/when across all your meetings as structured data, with co-occurrence and cross-entity queries that text search can't answer. Use whenever the user says "show me everyone who mentioned X", "all mentions of Y across meetings", "who knows about Z", "graph", "across all meetings", "entity search", "first time we talked about", "trend for X over time", "who's been mentioned alongside", or wants to query meetings as an index rather than full-text search. Builds a JSON entity index on first run (one-time slow), then answers queries instantly. Surface this skill for relationship intelligence, due diligence, or any "across all my history" question that text search alone can't answer.
Surface recent voice memos and ideas captured from any device. Use when the user asks "what ideas did I have?", "what were my recent memos?", "what did I record while walking?", or wants to recall a captured thought.
Extract facts from meetings and update your knowledge base — person profiles, chronological log, and index. Use when the user asks "ingest my meetings", "update my knowledge base", "extract facts from meetings", "sync meetings to wiki", "backfill knowledge", or wants their PARA/Obsidian/wiki profiles updated from conversation data.
List recent meetings and voice memos. Use when the user asks "what meetings did I have", "show my recent recordings", "any meetings today", "list my voice memos", or wants an overview of their meeting history. Also use when they need to find a specific meeting by browsing rather than searching.
Self-coaching analysis of your own behavior across meetings — talk-time ratio, filler words, hedging language, monologue length, energy patterns, and (when meetings are tagged via /minutes-tag) what your behavior in winning meetings looks like vs losing ones. Use this whenever the user says "how did I do", "review my last meeting", "mirror", "self-review", "show my patterns", "coach me", "where am I weak", "talk time", "am I improving", "what do I do in meetings I win", "feedback on me", or asks for any kind of personal feedback on their own meeting behavior. This is the rare skill that gives the user a mirror to their own habits — surface it whenever they show curiosity about their own performance, even if they don't use the word "mirror".