--- contractVersion: 1 title: agentic-report — polished interactive pages from Markdown description: Give an agent declarative Markdown and get a finished local page for a human reader. language: en localizations: ru: report.ru.md theme: system layout: landing preset: monument scrollProgress: true --- # A page worth handing over. From Markdown. **Give your agent one declarative source. Get a finished interactive report, tutorial, dashboard, or visual story.** No frontend project, hosted editor, or author JavaScript. `agentic-report` compiles locally into one portable HTML file by default, with responsive composition, interactions, localization, and selected-text review already built in. ::::actions{placement="edge"} ::action[Build the first page]{href="#workflow" kind="primary" effect="magnetic"} ::action[Choose a visual direction]{href="#styles" kind="secondary"} ::action[Open live examples]{href="#examples" kind="quiet"} :::: ![A monumental local report scene with sculpted light and strong spatial depth](assets/monument.jpg) _Generated by the ordinary compiler from the public source of this page._ ::::cards :::card{title="One HTML by default"} Use directory output when large local media should remain content-addressed files. ::: :::card{title="Interactive through file://"} The package-owned runtime travels with the artifact; the reader does not start a server. ::: :::card{title="English and Russian"} System language chooses the first view, and the selector appears only when a localization exists. ::: :::: ::::::section{title="Choose the result. Then choose its character." id="styles" nav="Choose a result" recipe="rail" interaction="depth"} :::lead Start from the reader's job. A preset supplies coordinated type, surfaces, spacing, controls, media, and motion; section recipes shape the story without a wall of visual attributes. ::: ![Incident review with impact and causal evidence](assets/incident-review.png) ![Vendor decision with hard gates and weighted evidence](assets/vendor-decision.png) ![Launch readiness with activation evidence and a reversible path](assets/launch-readiness.png) ::::cards :::card{title="Decision report · Monument" href="examples/basic/index.html"} Large-scale hierarchy for evidence, decisions, risks, and accountable next actions. ::: :::card{title="Research brief · Material" href="examples/research/index.html"} Editorial depth for method, sources, comparison, uncertainty, and recommendation. ::: :::card{title="Signal dashboard" href="examples/dashboard/index.html"} High-contrast operational scanning with charts, filters, state, and compact controls. ::: :::card{title="Terminal portfolio" href="examples/terminal-portfolio/index.html"} Mono type, prompt rhythm, scan texture, cursor, and clearly linked work cards. ::: :::card{title="Cinematic story" href="examples/cinematic-story/index.html"} Local imagery drives a staged hero, scroll narrative, media rail, and measured close. ::: :::card{title="Executive brief · Monument" href="examples/executive-brief/index.html"} A decisive opening, broad evidence field, operating path, and finished handoff using the default preset. ::: :::card{title="Motion and depth showcase" href="examples/motion-showcase/index.html"} Scroll progress, reveal, choreography, depth, tilt, and their complete reduced-motion fallback. ::: :::card{title="Landing starter" href="examples/landing/index.html"} A focused product narrative with clear actions, a portable proof, and an explicit boundary. ::: :::: ::::actions{placement="inline"} ::action[Browse the complete visual catalog]{href="examples/visual-catalog/index.html" kind="primary"} ::action[Open the interactive catalog]{href="examples/interactive-catalog/index.html" kind="secondary"} :::: :::::: ::::::section{title="Three steps from an empty folder to a finished page." id="workflow" nav="Build a page" recipe="story"} ![A local incident page prepared for a direct browser handoff](assets/incident-review.png) :::steps{title="The primary author path"} 1. Initialize the page shape closest to the reader's task. 2. Replace the sample Markdown and add confined local assets when they carry meaning. 3. Build and open the real artifact through `file://`. ::: ```sh npx --yes agentic-report init ./my-page --starter research --json npx --yes agentic-report build ./my-page --output ./my-page.html --json ``` :::callout{kind="info" title="Advanced diagnostics stay optional"} `build` validates before writing. Use `validate` or `inspect` only when an agent needs a focused diagnosis. ::: ::::actions{placement="inline"} ::action[Read the agent quickstart]{href="docs/agent/index.md" kind="primary"} ::action[Open the source contract]{href="docs/product/source-contract.md" kind="secondary"} :::: :::::: ::::::section{title="Live pages for different reader jobs." id="examples" nav="Explore examples" recipe="evidence"} All people, organizations, incidents, metrics, and decisions in the showcases are fictional. Each page is compiled independently with equivalent English and Russian authored content. ::::cards :::card{title="Incident command review" href="examples/incident-review/index.html"} Impact curve, causal topology, response timeline, and owned follow-up. ::: :::card{title="Vendor decision" href="examples/vendor-decision/index.html"} Hard procurement gates, weighted evidence, ranking exception, and conditional adoption. ::: :::card{title="Launch readiness" href="examples/launch-readiness/index.html"} Audience value, activation evidence, operating gates, and a reversible rollout. ::: :::card{title="Architecture decision" href="examples/architecture/index.html"} Trust boundary, alternatives, diagram, review checklist, and rollout path. ::: :::card{title="First-page tutorial" href="examples/tutorial/index.html"} A practical build journey with tabs, progressive detail, and a bounded practice control. ::: :::card{title="Visualization atlas" href="examples/visualization-catalog/index.html"} Charts, a flow diagram, sequence, and timeline rendered from validated directives. ::: :::card{title="Executive decision brief" href="examples/executive-brief/index.html"} The default Monument system applied to an evidence-led decision and operating handoff. ::: :::card{title="Motion and depth" href="examples/motion-showcase/index.html"} A direct tour of the visual effects available through ordinary declarative roles. ::: :::: [Report source](examples/basic/report.md) · [Research](examples/research/report.md) · [Architecture](examples/architecture/report.md) · [Tutorial](examples/tutorial/report.md) · [Dashboard](examples/dashboard/report.md) · [Landing](examples/landing/report.md) · [Visual catalog](examples/visual-catalog/report.md) · [Interactions](examples/interactive-catalog/report.md) · [Visualizations](examples/visualization-catalog/report.md) · [Terminal](examples/terminal-portfolio/report.md) · [Cinematic](examples/cinematic-story/report.md) · [Executive brief](examples/executive-brief/report.md) · [Motion showcase](examples/motion-showcase/report.md) :::::: ::::::section{title="Comment where the question lives." id="review" nav="Review in place" recipe="evidence" interaction="depth"} ![A local review handoff with evidence and highlighted discussion](assets/incident-review.png) Select eligible text on the normal page and choose **Create note**. The range remains highlighted; its popover carries the thread, reply, edit, resolve, reopen, and **View thread** actions. The document does not enter a review mode or move aside for a panel. :::callout{kind="success" title="Try it here"} Select any words in this sentence. The contextual surface stays with the selection while the topbar Review control remains a compact list and export surface. ::: ::::actions{placement="inline"} ::action[Open the Review workspace]{href="examples/review-workspace/index.html" kind="primary"} ::action[Open structured Response]{href="examples/response-workspace/index.html" kind="secondary"} :::: :::::: ::::::section{title="Quality lives in the package." id="reasons" nav="Why it works" recipe="metrics"} ::::cards :::card{title="Strong defaults"} Monument is the default. Material, Signal, Terminal, and Cinematic each carry their own composition, typography, surface, media, and motion character. ::: :::card{title="A small public vocabulary"} Authors choose a starter, a preset, and optional section recipes. Detailed overrides remain available for a specific need without becoming prerequisites. ::: :::card{title="One runtime"} Both output formats share semantic HTML, responsive behavior, localization, Review, and Response. ::: :::card{title="A narrow trust boundary"} Markdown, frontmatter, confined partials, and local assets enter. Raw HTML, remote fetching, executable templates, and author browser code stay out. ::: :::: :::::: ::::::section{title="Give the agent the short path." id="agent-skill" nav="Set up an agent" recipe="evidence"} ```sh npx skills add witqq/agentic-report --skill agentic-report ``` Ask for an interactive research handoff, code tour, decision packet, tutorial, dashboard, or landing. The canonical skill teaches one init/edit/build/open loop and reaches advanced syntax only when needed. ::::actions{placement="inline"} ::action[Read the exact skill]{href="skills/agentic-report/SKILL.md" kind="primary"} ::action[Read agent instructions]{href="docs/agent/index.md" kind="secondary"} ::action[Browse packaged examples]{href="examples/manifest.json" kind="quiet"} :::: [Open the packaged landing starter source](source/starter/landing/report.md) :::::: ::::::section{title="Portable by design. Explicit at the boundary." id="boundaries" nav="Know the boundary" recipe="story"} Included: declarative local sources, responsive layouts, local media, package-owned interactions, localization, Review and Response, one-file output, and content-addressed directory output. Outside the source format: remote fetching, raw HTML, executable templates, arbitrary plugins, author scripts, hosted collaboration, print output, and disabled-JavaScript parity. ::::actions{placement="bottom"} ::action[Build the first page]{href="docs/index.html" kind="primary" effect="magnetic"} ::action[Explore every live example]{href="#examples" kind="secondary"} ::action[View the repository]{href="https://github.com/witqq/agentic-report" kind="quiet"} :::: [English source](source/landing/report.md) · [Russian source](source/landing/report.ru.md) · [Public route manifest](website/routes.json) · [Release identity](release.json) ::::::