answer-from-docs

Answer From Docs

Use this skill when the source material is already in hand and the operator needs one answer that can be checked against it. The corpus is the complete evidence boundary for the run. The skill does not search the web, fetch current documentation, consult private state, or fill gaps from the agent's general knowledge.

The useful result is not merely fluent text. A grounded result binds the corpus through a native digest, names the source for every citation, and preserves an exact quotation that the deterministic finalizer can find in that source. An unsupported result is also useful: it says what evidence is absent instead of turning a plausible guess into product documentation.

Evidence boundary

Supply:

• question: one concrete question.
• corpus: a small, bounded array of source objects. Every source needs a stable id, a human-readable title, and non-empty text.

Keep only material relevant to the question in the corpus. Runner inputs are control data, not a document store. Admit large immutable files with Runx's artifact tools, retrieve the necessary bounded pages, and then call this skill with the resulting small source packet. Use extract first when the material must be cleaned or structured. Use knowledge-router, research, or deep-research when the sources still need to be found.

Source order is not authority. Prefer direct, specific language over a vague summary. If two sources disagree, preserve the conflict and refuse a single unqualified answer unless the corpus itself establishes precedence.

Decision procedure

1. Read the question literally. Do not broaden it to a nearby question the corpus happens to answer.
2. Treat the supplied sources as exhaustive for this run. Outside knowledge can help interpret language, but it cannot support a claim.
3. Find the smallest set of passages that directly supports the answer.
4. Draft a concise answer. Every material statement needs a citation with the source id and an exact quotation copied from that source's text.
5. Use unsupported when the evidence is absent or too weak. Name the missing policy, limit, procedure, or source in kb_gaps.
6. Use conflicted when supplied sources materially disagree. Record the conflict and the evidence needed to resolve it.
7. Let the deterministic finalizer verify corpus shape, source membership, exact quotations, the native corpus digest, and terminal result shape. Invalid evidence cannot seal as a grounded answer.