skylights-kb

Ask the Skylights NW knowledge base a question. Returns a synthesized markdown answer with citations.

Compile new raw/ content into wiki/ articles. Run after every interview, or rely on the nightly /schedule routine.

Run the golden Q&A evaluation against the current wiki. For each question in tests/golden-qna.md, ask the KB and judge the answer in-conversation. Writes vault/meta/golden-qna-report.md.

Pull static-source material into vault/raw/. Subcommands - "website" (crawl skylightsnw.com), "pdf <path>" (parse and store a supplier PDF), "inbox" (archive processed inbox files).

Run a voice-driven interview with the owner. Loads the protocol from interviews/<topic>.md, triggers the kb-running-an-interview skill, and writes the session directory to vault/raw/interviews/. Detects prior sessions and offers to resume.

Decides how a single raw vault doc should update the wiki — picks a trunk, drafts a new article OR updates an existing one OR flags a conflict OR skips. Returns a structured JSON action that the /kb-compile workflow applies via tools/compile.py. Used by /kb-compile.

Audits vault/wiki/ for stale dates, orphan articles, missing canonical articles, contradictions across articles, and duplicate concepts. Writes vault/meta/lint-report.md. Never edits articles. Used by /kb-lint, invoked via Claude's Task tool from /kb-lint.

Answers questions against the Skylights NW knowledge base. Reads the wiki, synthesizes a markdown answer with citations, and admits when the wiki doesn't have the answer. Used by /kb-ask — this persona is loaded by /kb-ask directly in the current session (no Task dispatch); Claude reads the context produced by tools/ask.py and answers in-session.

Use when answering a question about Skylights NW operations from the wiki — for `/kb-ask` invocations and for natural-language queries like "what is our standard markup", "do we have notes on contractor pricing", "look up our install procedure", "what's in the wiki about Velux". Reads `vault/meta/index.md` and the matching `vault/wiki/` articles, synthesizes a markdown answer with explicit citations, and admits clearly when the wiki doesn't have the answer.

Use when running a voice-based knowledge-harvest interview with the owner — for `/kb-interview <topic>` invocations and for natural-language requests like "start an interview about pricing", "let's capture what I know about install", "harvest knowledge on accounts", "I want to do an interview". Loads the protocol from `<repo-root>/interviews/<topic>.md`, applies confirmation patterns, number/SKU verification, decline/suggestion handling, document-upload handshakes, and pause-and-resume; writes transcript, structured summary, session state, and feedback files under `vault/raw/interviews/` and `vault/meta/`.

Use whenever working in the Skylights NW knowledge-base vault — defines trunk taxonomy, frontmatter schema, citation patterns, raw/wiki/meta boundaries, and the read-only invariant for agents. Triggers on any task that reads or writes files in vault/, runs /kb-* commands, or asks questions about the KB.

2 hooks across 2 events