Agent skill
decision-capture
Detect decisions in conversation and record them with rationale, alternatives, and outcome tracking.
Install this agent skill to your Project
npx add-skill https://github.com/nearai/ironclaw/tree/staging/skills/decision-capture
SKILL.md
Decision Capture
When a decision is detected in conversation, record it in the commitments workspace. Decisions are durable knowledge — they explain why a path was chosen and enable outcome tracking over time.
Detection
Look for explicit decision language:
- "We decided to..." / "I'm going with..." / "Let's do X"
- "The call is..." / "We settled on..."
- "I chose X over Y because..."
Do NOT capture:
- Brainstorming or hypotheticals: "maybe we should...", "what if we..."
- Preferences without commitment: "I think X is better"
- Questions: "should we go with X?"
When uncertain, ask: "Was that a decision, or still thinking it through?"
Recording
This skill is only successful if the decision is actually persisted. Do not just summarize or acknowledge the decision.
Execution order is mandatory:
- Call
memory_writeforcommitments/decisions/<date>-<slug>.md - If applicable, call
memory_writefor a follow-on commitment incommitments/open/ - If applicable, call
memory_writeforcontext/intel/<slug>.md - Only then confirm to the user what was recorded
Never say a decision was "captured", "recorded", or "saved" unless the
corresponding memory_write call succeeded.
Write to commitments/decisions/<date>-<slug>.md via memory_write:
---
type: decision
decided_at: <today YYYY-MM-DD>
context: <topic-slug>
participants: [<who was involved>]
confidence: <high if explicit, medium if inferred>
reversible: <true|false>
outcome: null
outcome_positive: null
tags: [<relevant tags>]
---
# <What was decided>
## Context
<Why this decision was needed — 1-2 sentences.>
## Options considered
1. **<Option A>** — <brief pros/cons>
2. **<Option B>** — <brief pros/cons>
## Rationale
<Why this option was chosen.>
## Outcome
<To be filled in later when outcome is known.>
Follow-through
- If the decision creates an obligation (e.g., "we decided to migrate by Q2"), also create a commitment in
commitments/open/following the commitment schema. - Write an intelligence MemoryDoc to
context/intel/<slug>.mdwith a brief summary: "Decided X on . Rationale: ." This makes the decision searchable as durable knowledge.
For explicit requests like "record this decision", "log this decision", or "note the decision", default to doing all required writes immediately rather than asking a follow-up question unless the content is genuinely ambiguous.
Outcome tracking
The triage mission checks for decisions older than 7 days without an outcome. It prompts: "You decided <X> <N> days ago. How did it turn out?" When the user provides an outcome, update the decision file's outcome and outcome_positive fields.
Confirmation
After the write(s) succeed, briefly confirm:
- where the decision was written
- whether any follow-on commitment was created
- one-line summary of the rationale
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
mintlify
Build and maintain documentation sites with Mintlify. Use when creating docs pages, configuring navigation, adding components, or setting up API references.
product-prioritization
Product strategy and feature prioritization — score features by user demand evidence, effort (human vs AI-assisted), strategic alignment, and market signal. Anti-sycophantic forcing questions to cut through opinion.
qa-review
QA review for code changes — test coverage analysis, edge case identification, test plan generation, regression detection, test health tracking over time.
commit
Generate git commit messages from staged changes
content-creator-assistant
Commitment tracking tuned for content creators — content pipeline stages, trend expiration, cross-platform cascades, heavy idea parking.
trader-assistant
Commitment tracking tuned for financial traders — real-time alerts, position-aware relevance, decision journaling with outcome tracking.
Didn't find tool you were looking for?