What problem does it solve? Adding notes to a structured knowledge base requires consistent placement, tagging, and cross-referencing, which is error-prone when done manually. This Skill splits the work: a bundled helper handles the mechanical write (atomic file creation, tag canonicalization, taxonomy updates) while the agent handles judgment calls like folder selection, Diátaxis labeling, and cross-references. ## Core Features & Use Cases - Confirm-by-default capture flow: Proposes KB destination, folder, Diátaxis label, title, tags, and body for user review before writing, with an --auto escape hatch for unattended capture. - Taxonomy-aware placement: Surveys the destination KB's declared domains and on-disk folders, flags undeclared folders as drift, and records new domains as provisional when unconfirmed. - Guardrailed writes: The helper refuses invalid titles, never overwrites existing files, canonicalizes known tag aliases, and reports structured JSON results with error codes like collision and no-kb-resolvable. - Use Case: After a debugging session, ask the agent to capture the resolution as a how-to note; it surveys the KB, cross-references related notes via kb-retrieve, proposes placement under the right domain, and writes the note atomically after your confirmation. ## Quick Start Ask the agent to capture a new knowledge-base note about your topic, for example: "Use kb-add to save a how-to note about configuring pnpm workspaces."
