Give your findings a page.

Agentic Report turns Markdown into interactive pages a reader can inspect and comment on.

npx skills add witqq/agentic-report --skill agentic-report

From source to page

An authored compilation model: source slabs enter a solid opening core and a structured page emerges

Compilation model, not hardware or a recorded run.

Keep the source. Build the page.

Source sheets, an open compilation core and an emerging structured page in a fixed isometric view

Write what you know

Markdown holds the explanation. Local JSON supplies the figures; assets, shared partials and YAML/JSON theme data stay with the source.

Build from that source

The compiler checks the format and file boundaries before writing the result. The author checks the claims. Custom code enters through explicitly declared extensions.

Give the reader a working page

The default result is one HTML file that opens from disk. Figures have native controls; text can carry review notes. Directory output keeps separate assets when a larger page needs them.

The original source stays in place while its values enter the core and a page emerges.

Open the evidence

This is a native figure built from the data below. Open it, inspect the values, then return to the page.

Failed checkout attemptsFictional OrbitDesk checkout failure rates at five UTC checkpoints.
Failed checkout attemptsFictional OrbitDesk checkout failure rates at five UTC checkpoints. Data: Failure rate, 09:35: 0.6; Failure rate, 09:50: 8.7; Failure rate, 10:05: 18.4; Failure rate, 10:20: 7.2; Failure rate, 10:35: 0.8.0510152009:3509:5010:0510:2010:35UTC checkpointFailed attempts, percent0510152009:3509:5010:0510:2010:35UTC checkpointFailed attempts, percent
  • Failure rate

Source: Five UTC checkpoints from the fictional OrbitDesk incident. Example checkout failure rates, not Report performance metrics. ·

Read the Markdown that builds this figure
::::chart{type="line" title="Failed checkout attempts" description="Fictional OrbitDesk checkout failure rates at five UTC checkpoints." x-label="UTC checkpoint" y-label="Failed attempts, percent"}
:::series{label="Failure rate"}
::point{label="09:35" value="0.6"}
::point{label="09:50" value="8.7"}
::point{label="10:05" value="18.4"}
::point{label="10:20" value="7.2"}
::point{label="10:35" value="0.8"}
:::
::::

Tables, diagrams and local media use the same theme. The original Markdown remains the source for the next revision.

Put the question beside the passage

Select this sentence and choose Create note: every decision should make its supporting evidence possible to check.

Continue the thread, resolve the question, then export review.json when you want to return the discussion to the author. Feedback is not sent automatically. This built page stores local notes; it does not connect to Codex.

Revise with the conversation already doing the work

For a living document, run the local reader from the Codex conversation writing that source:

npx --yes agentic-report@0.21.1 serve ./my-page --human

Open the printed localhost address. Select a passage and choose Ask agent. The reply streams into the chat; source edits rebuild the page and highlight what changed. By default this connects to the current loaded, writable Codex conversation through its compatible local control endpoint.

serve is an opt-in, single-user local reader. It does not publish the conversation as a hosted service. Live discussion controls currently use English. A separate agent requires an explicit choice.

Follow a real task through the page

The organizations and evidence in these maintained examples are fictional. Their page layouts and interactions are actual package output.

Incident review

Impact, contributing causes, recovery checkpoints and follow-up actions share one report.

Vendor decision

Conditions and evidence support a recommendation, including what would change it.

Architecture

A system map sits beside alternatives and the rollout that follows the decision.

The capability tour pairs working techniques with Markdown. The visual catalogue shows complete compositions.

Browse all examples and their sources

These are real captures of maintained examples in both colour schemes.

Incident review with impact and causal evidence

Vendor decision with hard gates and weighted evidence

Launch readiness with activation evidence and a reversible path

Reader task Working page Authored source
Decision report Open Markdown
Research Open Markdown
Architecture Open Markdown
First-page tutorial Open Markdown
Dashboard Open Markdown
Landing starter Open Markdown
Visual catalogue Open Markdown
Interactive catalogue Open Markdown
Visualization atlas Open Markdown
Terminal portfolio Open Markdown
Cinematic story Open Markdown
Executive brief Open Markdown
Motion and depth Open Markdown
Run report from data Open Markdown
Capability tour Open Markdown
Incident review Open Markdown
Vendor decision Open Markdown
Launch readiness Open Markdown
Code review Open Markdown
A question to answer Open Markdown
Presentation Open Markdown
Open questions Open Markdown

Review workspace · Review source · Prior review example · Structured Response · Packaged example manifest

Give your agent the material

Install the skill with the command at the top, then give your agent the real notes and evidence.

Use agentic-report to turn these incident notes into a report. Show the timeline and the evidence behind the decision. Let me comment on passages, and inspect the finished page on mobile and desktop.

Build directly from the command line

Use Node.js 24.18.0 or newer. The first invocation needs access to the npm registry.

npx --yes agentic-report@0.21.1 init ./my-page --starter document --json
npx --yes agentic-report@0.21.1 build ./my-page --output ./my-page.html --json

Edit my-page/report.md between the commands. Open the resulting HTML directly from disk; it needs no development server. build validates the source before writing the result.

The source contract describes the authoring boundary. The agent guide explains the page-making workflow.

Keep the source within reach

Human guide · Agent quickstart source · Exact skill · Landing starter source · Public route manifest · Release identity

The ordinary source format keeps remote fetching, raw HTML and implicit code execution outside its boundary. Declared extensions carry their own trust contract. Hosted collaboration, PDF export, pagination and disabled-JavaScript parity are outside the product.

Download this page's complete source graph

The two namespaces expose the same original files. Preserve the relative paths when saving an entry, its Russian variant, local data, images and the declared extension. The model code carries its MIT notice.

File Source namespace Canonical namespace
report.md Download Download
report.ru.md Download Download
data/incident.json Download Download
assets/compile-core.svg Download Download
assets/compile-core-dark.svg Download Download
assets/social-preview.png Download Download
assets/incident-review.png Download Download
assets/incident-review-dark.png Download Download
assets/vendor-decision.png Download Download
assets/vendor-decision-dark.png Download Download
assets/launch-readiness.png Download Download
assets/launch-readiness-dark.png Download Download
assets/screenshots.json Download Download
extensions/execution-core/extension.yaml Download Download
extensions/execution-core/effect.mjs Download Download
extensions/execution-core/README.md Download Download
extensions/execution-core/LICENSE Download Download
extensions/execution-core/example-report.md Download Download
extensions/execution-core/example-decision.md Download Download
extensions/execution-core/assets/compile-core.svg Download Download
extensions/execution-core/assets/compile-core-dark.svg Download Download

Review workspace

Review this report

No discussion threads yet