# Craft Observation

> Record a learning or discovery. Compounds knowledge across sessions.

- Skill: `attac-t/craft-observation` (Agent Skill)
- Install (CLI): `npx skillmds@latest add attac-t/craft-observation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/attac-t/craft-observation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: attac-t (https://skillmd.com/u/attac-t)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/attac-t/craft-observation

---


# Skill: Craft Observation

> "The best time to capture a learning is when it happens."

## When

Record an observation when:
- A pattern emerges
- A problem is solved (not just fixed — understood)
- Something unexpected happens
- A key insight crystallizes

## The Standard

1. **Location**: `observations/NNN-topic.md` in branch memory.
2. **Sequence**: Increment NNN from last observation.
3. **Brevity**: Capture the essence. One page max.
4. **Actionable**: Future you should be able to act on it.

## The Protocol

1. **Identify type**: Pattern, problem, solution, or discovery?
2. **Describe what**: What actually happened?
3. **Capture context**: What were you doing?
4. **Extract learning**: What's the takeaway?
5. **Save**: Write to `observations/NNN-topic.md`.

## The Anti-Patterns

| Don't             | Do                 | Why                    |
|-------------------|--------------------|------------------------|
| Wait until later  | Capture now        | Context fades fast     |
| Over-explain      | Distill essence    | Signal over noise      |
| Skip the learning | State the takeaway | That's the whole point |

## Template

See `templates/observation.md`.

## Integration

Observations are reference material, not auto-loaded. Search when relevant context arises.