Skip to main content
skill CX Codex

ingest — Claude Code skill: what it does and how to install

This Claude Code skill turns call transcripts, messages, and meeting notes into decisions and action items. Run /ingest to also file GitHub issues and draft a reply.

MIT 134 installs ★ 932 updated 2026-10-22

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add coreyhaines31/makerskills --skill ingest -a claude-code
Open on GitHub

What ingest does

ingest parses pasted transcripts, messages, and meeting notes into decisions, tasks for each side, bugs, feature requests, unanswered questions, and facts to keep. It classifies the input as a call, message, email, or voice note. Voice notes produce captures and action items, not a reply draft.

The skill routes items to projects through people.yaml, saves captures to a vault, and checks for duplicate issues before creating GitHub issues. Replies stay as drafts and are never sent. Creating issues requires the gh command; routing uses the config, and an unknown sender is identified through a question.

What it helps with

  • extract decisions and each person's tasks from a call transcript
  • file separate GitHub issues for bugs and feature requests
  • save useful facts and decisions to a vault
  • draft a reply to a message or email

Example prompts for the agent

  • /ingest — pull the decisions and action items out of this transcript
  • Process this message from Jane: “...”
  • Sort these meeting notes and draft a reply

How to install ingest

1Skills CLI (Vercel)

npx skills add coreyhaines31/makerskills --skill ingest -a claude-code

2Manually: put the files in place

~/.claude/skills/ingest/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ingest/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about ingest

How do I install ingest in Claude Code?

Run npx skills add coreyhaines31/makerskills --skill ingest -a claude-code. The skill file is placed at ~/.claude/skills/ingest/SKILL.md.

What does ingest do?

It extracts decisions, action items, bugs, feature requests, questions, and useful facts from calls, messages, and notes. It can save captures to a vault, file GitHub issues, and draft—but never send—a reply.

What does ingest need to work?

The gh command is needed to create GitHub issues. Project routing uses people.yaml, and captures are saved to a vault.

Source text

SKILL.md · MIT
---
name: ingest
description: When you paste raw human input — a call transcript (Grain, Zoom, Granola, Fathom), a text or email from a client/partner/friend, a voice-memo dump, or meeting notes — and want it converted into structured work. Extracts decisions, action items (yours vs theirs), bugs/feature requests, and facts worth keeping; files GitHub issues in the right repo, captures to the second-brain vault, and drafts (never sends) the reply. Triggers on "/ingest", "ingest this", "here's my call with X," "here's the transcript," "this is from [person]," "[person] asked me this," "from [person]:", a pasted transcript with speaker labels, or a forwarded client message that clearly expects processing. Person→project routing lives in a private config; unknown senders get asked about once, then remembered.
metadata:
  version: 0.1.1
---

# /ingest — Raw human input → structured work

You are a relay hub: clients text you, partners email you, calls get transcribed. Each of these carries decisions, action items, bugs, and facts — and processing one by hand means re-explaining the same routine every time. This skill is that routine, written down.

**The contract:** internal, reversible outputs (vault captures, filed issues) happen without ceremony. Outward-facing outputs (replies) are always **drafted, never sent**.

## Files

| Path | What |
|---|---|
| `${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/ingest/people.yaml` | Person → project/repo/vault-page/reply-channel routing (private, gitignored) |
| `<vault>/raw/call-<slug>.md` / `<vault>/raw/message-<slug>.md` | Captures, in second-brain's schema |
| `references/people.yaml.example` | Config schema with a worked example |

`<vault>` is `${SECOND_BRAIN_VAULT:-$HOME/Documents/SecondBrain}`.

## Step 0 — Get the input and classify it

In order: content in the prompt → clipboard (`pbpaste` on macOS, `wl-paste` / `xclip -o` on Linux; skip on agents without one) → ask.

Classify by shape, not by what the user called it:

| Shape | Type |
|---|---|
| Speaker labels + timestamps, or a Grain/Zoom/Granola/Fathom URL or header | **call** |
| "from X:" / forwarded text or DM, first-person, short | **message** |
| Email headers or greeting/sign-off structure | **email** (treat as message with formal tone) |
| Unstructured first-person stream ("okay so I was thinking…") | **voice-note** (no reply draft; capture + actions only) |

Long transcripts arrive truncated in chat sometimes — if the content visibly cuts off mid-sentence, say so and ask for the file (or a path) rather than processing a fragment.

## Step 1 — Identify who and which project

Read `people.yaml`. Match participants/senders against `name` and `aliases`.

- **Matched** → you now have the repo, vault page, reply channel, and tone notes. Say which routing you're using in one line ("Routing: Jane → acme-app").
- **Unmatched** → ask once: "Who is this and what project does it belong to?" Then offer to append them to `people.yaml` so the question never repeats. If the user declines to add them, process the input with explicit destinations instead of routed defaults.
- **Multiple projects in one call** (common on partner calls) → split extraction by project; route each piece separately.

## Step 2 — Extract

Read the whole input first. Then pull out, with a short verbatim quote or paraphrase anchoring each:

1. **Decisions made** — anything settled, including "we're NOT doing X."
2. **Action items — mine** — things the user owes someone. Include any stated deadline.
3. **Action items — theirs** — things owed to the user (these become the follow-up section of the reply, not issues).
4. **Bugs & feature requests** — anything that should become a GitHub issue. One issue per item, never a grab-bag.
5. **Questions to answer** — asked but unanswered in the input.
6. **Facts worth keeping** — durable context (pricing mentioned, a person's situation, a tool they use) → vault; a genuinely reusable reference → Keep note (only if the `keep` CLI is authed; skip silently otherwise).

**Name verification rule:** transcripts mishear proper nouns constantly (brand names, people, tools). Before a name lands in an issue title, vault page, or reply, verify the spelling against the routing config, the repo, or a quick search — never trust the transcript's spelling of a name you can check.

## Step 3 — Show the routing plan

One compact table before acting:

| # | Item | Destination |
|---|---|---|
| 1 | "Bulk-export button on the reports page" | Issue → `myorg/acme-app` |
| 2 | Decision: monthly billing default | vault `Projects/Acme.md` |
| 3 | Reply to Jane | draft below |

Then **proceed without waiting** — everything in the table is internal or a draft. Pause for confirmation only when routing is ambiguous (two plausible repos, an unmatched person) or the input includes something sensitive (credentials, legal/financial commitments).

## Step 4 — Execute

**Issues** — search for duplicates first (`gh issue list --search`), then file with `gh issue create` in the mapped repo. Title = imperative summary; body = context quote from the source, what was asked, and who asked. Apply `issue_labels` from config if set. Never assign anyone but the user.

**Vault capture** — one file per ingest, second-brain raw schema:

```markdown
# message-jane-bulk-export (2026-09-04)
source: text message from Jane
project: Acme App

## Summary
…

## Decisions
…

## Action items
- [ ] mine: …
- [ ] theirs: Jane to …

## Filed
- myorg/acme-app#123 — Bulk-export button on the reports page
```

Slug: `call-` or `message-` + person + topic. Follow the vault's auto-commit convention (semantic commit per session).

**Todos** — action items of "mine" also land wherever the person's `vault_page` tracks tasks, if one is configured.

**Reply draft** — in the user's voice for that channel (config `tone` + channel norms: text = brief and casual; email = fuller). Structure when it fits: acknowledge → what I'm doing about it → what I need from you → when they'll hear back. End with the draft in a paste-ready block (compose with `/paste` rules for the channel — e.g. no URLs in an X post body). **Never send it.**

## Step 5 — Report

Close with a compact recap: TLDR of the input (2–3 sentences), decisions, both action-item lists, links to filed issues, the vault file path, and the reply draft. This recap is the deliverable — someone who never saw the input should understand what happened and what's next.

## Composes with

- `second-brain` — captures land in its `raw/` schema for later compile
- `paste` — channel formatting for the reply draft
- `deep-research` — when an extracted question needs real research before it's answerable
- `project-manager` — when a call produces enough work to deserve a project card, not just issues

## Notes on quality

- The most common failure is **flattening**: summarizing the input instead of extracting work from it. The test: could the user act on your output without rereading the source?
- Second most common: **issue grab-bags**. "Improvements from call with Jane" is not an issue. One item, one issue, one clear title.
- "Theirs" action items are as valuable as "mine" — they're the follow-up ledger. Don't drop them because no tool call captures them.
- A voice-note ingest with zero action items is fine: capture it, say so, stop. Not every input contains work.

© coreyhaines31 · MIT · coreyhaines31/makerskills

Similar skills

All skills for Notes, tasks and projects →

From the same set20

The whole set →
slide-deck Builds React/Next.js slide decks: draft from a brief, edit an existing deck, convert PPTX, export to HTML, PDF or a Vercel URL. CX Codex +1 392installs maker-council maker-council convenes a simulated board of nine well-known founders and operators, from Jason Fried to Naval Ravikant, to stress-test a real business decision. Money, hiring, pricing and kill-or-keep questions are its lane. CX Codex +1 384installs skillify skillify — a skill for Claude Code, Codex, and Cursor that scaffolds, adapts, updates, and evaluates agent instructions directly from conversations, notes, or recordings. CX Codex +1 384installs loopify loopify turns "this task should run periodically" into a working loop, picking the pacing and adding idempotency plus a bail-out. CX Codex +1 383installs paste paste strips ANSI codes, box-drawing chars, and terminal prompt artifacts from clipboard content, then reformats for Slack, Notion, Twitter, LinkedIn, email, GitHub, or plain text. CX Codex +1 380installs toolify toolify is a Claude Code skill that asks about an integration and writes its client wrapper, environment variables, and webhook handler. It connects Stripe, Supabase, or an MCP server to a project. CX Codex +1 380installs pm pm keeps a kanban board per business or project and sorts the backlog with the Eisenhower matrix. Useful when several boards compete for your attention. CX Codex +1 365installs unstuck unstuck — a skill that fires when a task hits a wall: it classifies the kind of "no" you ran into, then pushes it through lateral-thinking techniques until real workarounds appear. CX Codex +1 332installs

Project sponsors

Companies that keep this analytics open