Query writeback
Claude Code skill bundle for building auditable research wikis from papers with independent QA, safe writeback, and validation.
npx -y skills add AIwork4me/open-llm-wiki --skill query-writebackAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Answer cross-source questions about an open-llm-wiki vault and optionally write reusable synthesis back into concept pages. Use when the user asks a wiki question that requires comparing, connecting, or tracing multiple source/concept pages. By default answer first and propose writeback; modify files only when the user explicitly asks for writeback, pre-authorizes wiki growth, or approves the proposed changes.
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
5.1 KB, as published. Nobody here has run it
Query Writeback
Use the wiki to answer synthesis questions, then preserve high-value synthesis only when file changes are authorized.
Runtime Tools
Use deterministic scripts when available:
wiki_search.pyto find relevant source and concept pageswiki_claims.pyandclaims/claims.jsonlto inspect normalized durable claimswiki_normalize_metrics.pywhen comparisons depend on units, baselines, or protocolswiki_semantic_qa.pywhen the answer depends on claim-level evidence qualitywiki_science_review.pywhen a high-stakes synthesis needs human or second-LLM reviewwiki_writeback.pyto produce a reviewable diff before changing fileswiki_lint.pyafter approved writeback
Example:
uv run python scripts/wiki_search.py "<vault>" "<query>" --limit 8
uv run python scripts/wiki_claims.py "<vault>"
uv run python scripts/wiki_normalize_metrics.py "<vault>" --in-place
uv run python scripts/wiki_writeback.py "<vault>" --target concepts/<page>.md --query "<query>" --body-file <draft.md>
Trigger Boundary
Use this skill for questions that require cross-source synthesis:
- relationships between concepts
- comparisons across papers
- timelines or evolution paths
- recurring questions that would benefit from a reusable concept note
Do not use it for simple factual lookup, casual chat, non-wiki topics, or questions where a single source page already gives the answer.
File-Safety Boundary
- Read from the resolved wiki vault only.
- Answering is read-only by default.
- Writeback requires explicit user approval unless the current instruction has already authorized automatic wiki growth.
- Before writing, show the target files and a short summary of the proposed additions.
- Never rewrite a whole concept page when a targeted insertion is enough.
- Never update
sources/or QA reports from this skill. Usewiki-ingestfor source changes. - Always append a
log.mdentry for approved writeback.
Workflow
1. Resolve Scope
Read SCHEMA.md, index.md, and relevant concept/source pages. Identify:
- concepts involved
- source pages cited
- relationships being tested
- gaps or missing evidence
2. Assess Coverage
Use this decision table:
| Verdict | Condition | Action |
|---|---|---|
FULL | wiki has enough cited material | answer from wiki |
PARTIAL | related pages exist but evidence is incomplete | answer with caveats and list gaps |
NONE | wiki lacks relevant material | say what is missing and suggest ingest |
Do not trigger ingestion automatically. If new sources are needed, propose a
separate wiki-ingest run.
3. Answer
Answer in normal prose and cite wiki pages with [[LLM-NNNN]] or
[[concept-name]]. Label inference when a relationship is not explicitly stated
by a source.
4. Decide Whether Writeback Is Valuable
Propose writeback when at least one is true:
- the answer cites three or more source pages
- the answer contains a comparison table or timeline
- the answer connects two concepts not currently linked
- the question is likely to recur
- the answer identifies a durable gap or contradiction marker
Single-source details and speculative answers usually should not be written back.
5. Self-Check Before Writeback
Check every relational claim:
- explicit in source: write as fact with citation
- explicit in
claims/claims.jsonl: prefer the normalized claim and preserve its evidence anchor - implied but not stated: label as inference
- guessed from chronology or similarity: do not write as a claim
Every paragraph added to a concept page needs at least one citation. Do not write unsupported synthesis.
6. Execute Approved Writeback
When writeback is approved:
- Prefer updating an existing concept page.
- Create a new concept page only when no existing concept fits.
- Add frontmatter for new concept pages using
templates/concept-template.md. - Add bidirectional links when useful.
- Update
index.mdif a new concept page is created. - Append to
log.md:[YYYY-MM-DD HH:MM] query-writeback | concepts/<page>.md | agent | query: "<original question>"
Mark writeback-derived sections with:
query-derived: YYYY-MM-DD
If wiki_writeback.py is available, use it to produce the diff first. Apply
only after approval or pre-authorization.
Completion Criteria
Finish with:
- direct answer to the user's question
- citations used
- whether writeback was skipped, proposed, or completed
- changed files if writeback happened
- lint result after writeback when runtime tools are available
- remaining gaps that require future ingest