idea-capture

Installation
SKILL.md

IDEA-CAPTURE — a fleeting idea that is not captured is lost

An idea that arrives mid-work and is not written down is gone by the next session. This skill is the store for raw ideas: one Markdown file per idea, in the project's ideas/ directory, written verbatim and never edited. Calibration is a separate step (idea-calibrate); this skill only makes sure the idea is still there when you are ready for it.

Rules

  • Capture first, calibrate later. When a raw idea arrives, write it down before doing anything else with it — before answering, before coding, before the next message.
  • Verbatim, always — with one exception: capture refuses text that looks like it contains a secret (a key-shaped value) unless --allow-secret is given; with the override the text is still stored verbatim, but the id's slug is built from the redacted form, so no secret fragment lands in the filename. The raw text is the idea as spoken, with the date and who said it. Never edit, improve, or interpret it after capture.
  • The store lives in the project (ideas/), committed with it. A store in /tmp is lost on the next restart; a store in the project survives.
  • A dropped idea is never deleted. Dropping only changes the status and records the reason. The file, the raw text, and the reason stay.
  • Statuses move one way: raw → calibrated → scoped, or any → dropped. A dropped idea never comes back as raw; if it returns, capture it again as a new idea.

Steps, in order

Installs
8
GitHub Stars
1
First Seen
Nov 6, 2026