write:insight

What problem does it solve?

This skill helps teams capture a single, reusable insight from a conversation and persist it as a concise learning note under docs/learnings, ensuring knowledge is discoverable and reusable.

Core Features & Use Cases

• Capture one concrete insight from the chat and write it to docs/learnings/<slug>.md.
• Maintain provenance by including sources (PRs, commits, files) and update the index in docs/learnings/README.md.
• Enforce routing rules to keep content in the appropriate documentation spaces and decline topics that belong in other docs areas (docs/technic/, docs/standards/, claude/skills/).
• Support hint-driven candidates to anchor the note and avoid re-asking the user for context.

Quick Start

Invoke /write:insight with an optional hint to draft a new learning note from this chat.