# Minutes Ingest

Extract facts from meetings and update your knowledge base, person profiles...

- 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-ingest -g -a claude-code -y`
Codex: `npx skills add silverstein/minutes --skill minutes-ingest -g -a codex -y`
Cursor: `npx skills add silverstein/minutes --skill minutes-ingest -g -a cursor -y`
Gemini CLI: `npx skills add silverstein/minutes --skill minutes-ingest -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add silverstein/minutes`

## Description

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.

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

# /minutes-ingest

Process meetings through the knowledge extraction pipeline to update person profiles, append to the knowledge log, and maintain the index.

## Prerequisites

The `[knowledge]` section must be configured in `~/.config/minutes/config.toml`:

```toml
[knowledge]
enabled = true
path = "/path/to/knowledge/base"
adapter = "wiki"  # or "para", "obsidian"
engine = "none"   # or "agent" for LLM extraction
min_confidence = "strong"
```

If not configured, explain what's needed and offer to help set it up.

## How to run

### Single meeting
```bash
minutes ingest ~/meetings/2026-04-03-strategy-call.md
```

### All normal meetings (backfill)
```bash
minutes ingest --all
```

### Preview without writing (recommended first time)
```bash
minutes ingest --all --dry-run
```

## What it does

1. **Reads** each meeting's YAML frontmatter (decisions, action_items, entities, intents)
2. **Extracts** structured facts with confidence levels and source provenance
3. **Updates** person profiles in the knowledge base (adapter-dependent format)
4. **Appends** to `log.md` with a timestamped entry for each ingested meeting
5. **Skips** facts that already exist (deduplication) or are below the confidence threshold
6. **Excludes** meetings designated `sensitivity: restricted` from automated knowledge-base ingestion

## Safety guarantees

- **`engine = "none"` (default)**: Only extracts from parsed YAML frontmatter. No LLM involved, zero hallucination risk.
- **Confidence thresholds**: Facts below `min_confidence` are counted as "skipped" but never written.
- **Provenance**: Every fact records which meeting it came from and when.
- **Deduplication**: Facts whose text already appears in a person's profile are skipped.
- **Dry-run**: Always suggest `--dry-run` first if the user hasn't used ingest before.

## Interpreting the output

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