Skip to content
Skills Library
Management & product · Planning

intake

/intake

The planning front-door. Captures feature ideas and bugs as graded rows in the root INTAKE.md ledger. Use it when the user says "log an idea", "capture a bug", "add to the backlog", "note this down", "track this feature", or invokes `/intake`. Opens with one prompt ("What are you trying to build?"), infers the rest from a light scan of the project's docs, PRDs and ledger, and asks only when something is unclear. Splits pasted lists and oversize ideas into discrete in-scope rows, flags duplicates, and grades every idea in a single-turn banded judgment (complexity / sequencing). Feeds `plan-pm`,

Repository
msg ↗
Licence
MIT
Last repository change
19.10.2026

Assessment and security

87/ 100Class: good
Format20 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability17 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
6
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 19.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

The planning front-door. Captures feature ideas and bugs as graded rows in the root INTAKE.md ledger. Use it when the user says "log an idea", "capture a bug", "add to the backlog", "note this down", "track this feature", or invokes `/intake`. Opens with one prompt ("What are you trying to build?"), infers the rest from a light scan of the project's docs, PRDs and ledger, and asks only when something is unclear. Splits pasted lists and oversize ideas into discrete in-scope rows, flags duplicates, and grades every idea in a single-turn banded judgment (complexity / sequencing). Feeds `plan-pm`,

Triggers from the description

log an ideacapture a bugadd to the backlognote this downtrack this featureWhat are you trying to build?

Arguments

/intake [--update | --delete | --health | --brainstorm [on|off]] <idea text | #n change>
Original author description

The planning front-door. Captures feature ideas and bugs as graded rows in the root INTAKE.md ledger. Use it when the user says "log an idea", "capture a bug", "add to the backlog", "note this down", "track this feature", or invokes `/intake`. Opens with one prompt ("What are you trying to build?"), infers the rest from a light scan of the project's docs, PRDs and ledger, and asks only when something is unclear. Splits pasted lists and oversize ideas into discrete in-scope rows, flags duplicates, and grades every idea in a single-turn banded judgment (complexity / sequencing). Feeds `plan-pm`,

How it works

  1. Usage
  2. Mode dispatch
  3. Brainstorm
  4. Hard rules
  5. References
Original SKILL.md headings · 64 lines, 677 words
SKILL.md preview
---
name: intake
description: >
  The planning front-door. Captures feature ideas and bugs as graded rows in
  the root INTAKE.md ledger. Use it when the user says "log an idea", "capture
  a bug", "add to the backlog", "note this down", "track this feature", or
  invokes `/intake`. Opens with one prompt ("What are you trying to build?"),
  infers the rest from a light scan of the project's docs, PRDs and ledger, and
  asks only when something is unclear. Splits pasted lists and oversize ideas
  into discrete in-scope rows, flags duplicates, and grades every idea in a
  single-turn banded judgment (complexity / sequencing). Feeds `plan-pm`, which
  drafts the PRD.
  Also edits the ledger: use it when the user says "update that idea", "change
  the goal on #4", "drop the search idea", "remove row #4", or "I logged that by
  mistake" (`--update` / `--delete`, or plain language — deletes always warn and
  confirm first). `--health`: use it when the user says "check the backlog",
  "find stale ideas", or "which rows already shipped". `--brainstorm on|off`
  turns related-idea suggestions on or off for the project.
argument-hint: "[--update | --delete | --health | --brainstorm [on|off]] <idea text | #n change>"
allowed_tools:
  - AskUserQuestion
  - Read
  - Edit
  - Write
  - Bash
---

# intake

The front-door of the msg planning pipeline. Ideas and bugs enter here and become graded rows in the root `INTAKE.md` ledger. `plan-pm` reads those rows and drafts the PRD.

```
intake (capture + grade → INTAKE.md rows) → plan-pm (drafts the PRD, stamps in-progress + prd) → … → merge --production (stamps completed)
```

## Usage

- `/intake [<idea text>]` — capture one or more ideas or bugs. No text → intake asks "What are you trying to build?".
- `/intake --update [<text>]` — edit a `backlog` row's `idea` / `goal` / `type`. NL: "change the goal on #4".
- `/intake --delete [<#n | text>]` — remove a row after a warning pass and a confirm. NL: "drop the search idea".
- `/intake --health` — list stale, errant, shipped-but-open and duplicate rows; offer to fix wrong statuses.
- `/intake --brainstorm` — suggest related ideas for this run only. `--brainstorm on` / `--brainstorm off` (or "turn brainstorm off") — save the setting for the project.

## Mode dispatch

Resolve the mode once, at entry, then read exactly one protocol. No `devkit/` ⇒ setup runs by itself first (`/msg --init`, then this command — `../shared/refs/setup-first.md`).

1. **Flag.** `--update` or `--delete` → edit; `--health` → health. `--sub-row <n>.<m>` (sent only by `plan-pm --sub`) → capture of one sub-PRD row at that id (`protocol-intake.md` § Sub-PRD rows). Strip the flag from the text. Two mode flags at once → ask which.
2. **Plain language with no flag.** Text that asks to change or remove an existing row (a `#n`, or "change / drop / remove / rename … the <idea> idea") → edit, with the action it names. A remove always gets delete's warning pass and confirm. A "change or remove?" doubt is an edit (`principles.md` 8). Anything else → capture.
3. **Brainstorm.** `--brainstorm on|off` or a plain-language toggle → write the switch, report it, and stop (unless idea text follows, which is then captured):

   ```bash
   .claude/scripts/script-policy-set.py --file devkit/policy.json --set policies.intake.brainstorm=<true|false>
   ```

   No `devkit/policy.json` (a project set up before the file existed) → say `/msg --update` adds it, and use the value for this run only. Bare `--brainstorm` → on for this run, nothing written.

| Mode | Protocol |
|------|----------|
| capture (default) | `refs/protocol-intake.md` — context scan, one prompt, inference, splits, duplicates, suggestions, grade, write |
| update · delete | `refs/protocol-edit.md` — find the row, lock gates, update or delete, the update log, the three edit surfaces |
| `--health` | `refs/protocol-health.md` — stale / errant / shipped / duplicate scan, one-confirm status fix |

## Brainstorm

Suggestions run only when brainstorm is on: the bare `--brainstorm` flag for one run, or `policies.intake.brainstorm: true` in `devkit/policy.json`. `/msg --init` seeds `true`. A project with no key reads as off. Suggestions always stay in scope (`principles.md` 2).

## Hard rules

- Never drafts a PRD and never runs a codebase analysis. Reading for context (`protocol-intake.md` § Pre-run) is allowed; planning is `plan-pm`'s.
- Grades are bands only — never a fake-precise estimate (`refs/rubric.md`).
- Asks only what `refs/principles.md` flags as unclear. Capture has no fixed questions.
- Never reads `INTAKE.md` in full — always through `script-intake-stamp.sh --list-rows` filters.
- Never writes `prd`. Writes `status` only in `--health` (behind one confirm) and when a duplicate's PRD has shipped (`completed`).
- Edit and health never scaffold a missing `INTAKE.md`. Capture creates it without asking.
- Delete never renumbers and never proceeds without an explicit confirm.

**Closing message (every mode, every outcome):** end per `../shared/refs/closing-message.md`.

**Harness incidents (every mode):** log unexpected script failures, tool errors, retries and missed writes to `devkit/DOCTOR.md` per `../shared/refs/doctor-logging.md`.

## References

- `refs/protocol-intake.md` · `refs/protocol-edit.md` · `refs/protocol-health.md` — the mode protocols
- `refs/principles.md` — when to ask, how to split, what is a duplicate
- `refs/rubric.md` — the `C:` / `S:` bands, their plain-English labels, the split threshold
- `.claude/scripts/script-intake-stamp.sh` — the one ledger reader and writer: `--list-rows` (filtered read), `--append-row`, `--set-cell`, `--remove-row`, `--status` (health and shipped-duplicate fixes only), `--migrate-log`, `--log-append`
- `.claude/skills/msg/refs/init/templates/TEMPLATE-INTAKE.md` — the ledger template
- `../shared/refs/prd-lifecycle.md` § *INTAKE.md row lifecycle* · `../shared/refs/policy-schema.md` § `policies.intake`
Files in this package (6)
  • SKILL.md 6 KB
  • refs/principles.md 2 KB
  • refs/protocol-edit.md 7 KB
  • refs/protocol-health.md 3 KB
  • refs/protocol-intake.md 7 KB
  • refs/rubric.md 4 KB

Versions

RepositoryScoreLicence
This page · ndisisnd/msg87MIT
skillberry-ai/cap-evolve100Apache-2.0
alecs5am/ralphy100Apache-2.0
lamngockhuong/aiteamkit100MIT
mathews-tom/armory100MIT
alecs5am/ralphy100Apache-2.0
buriedsignals/splash100MIT
vanducng/skills90MIT
yuxqiu/loci90MIT

Database snapshot: 13.11.2026 · package version c904a64342fe (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100plan-intake
    Turn any report (repo-deep-dive output, audit, skill-review, QA findings, design audit) into approved entries in a project's living-plan ledger. Use when the user says "intake this report", "add findings to the plan", "turn this audit into work items", "update the ledger from…
  • 100autopilot-idea
    Capture the owner's quick product ideas in a Linear project without planning them. Each idea becomes one issue in the project's "Ideas (unscheduled)" milestone (label idea, state Backlog) with the owner's words verbatim, a row in PLAN.md's idea backlog and a sourced decision.…
  • 90tasks-intake
    Explicit-only ADLC work intake. Use only when the user invokes $adlc-next:tasks-intake or /adlc-next:tasks-intake to turn ideas, defects, review findings, feedback, or task follow-ups into deduplicated work items with outcomes, done conditions, dependencies, and a proposed…
  • 90nacl-tl-intake
    Triage and decompose user requests with graph-aware classification into features, bugs, and tasks. Use when a request contains multiple changes, unclear work type, graph context is needed, or when the user says `/nacl-tl-intake`.
  • 95intake-desk
    Run the intake-desk — the generic front door of the process desk and the first of four desks in the pipeline (intake-desk → worker-desk → pr-review-desk → verify-desk). Ingests ALL inbound — open GitHub issues, the intake register (docs/streams/intake entries), and any incoming…
  • 90nacl-tl-intake
    Triage and decompose user requests with graph-aware classification into features, bugs, and tasks. Use when a request contains multiple changes, unclear work type, graph context is needed, or when the user says `/nacl-tl-intake`.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.