Skip to content

stark-ai-de/agent-skills / plugins/stark-ai-developer/skills/visual-reports

visual-reports

Verified

Create and update visual reports with optional native interaction, one guided topic at a time, useful diagrams, concise points, joint comparisons and complete offline HTML/Markdown/JSON exports. Use when richer output helps an authorized answer or the user asks for a visual report; keep small answers in chat. Not production application UI or clinical advice.

FileKindSize
SKILL.mdskill md11.5 KB
agents/openai.yamlconfig779 B
assets/completion-example.mdmarkdown3.2 KB
assets/graphite-grain/configurator.htmlother17.7 KB
assets/graphite-grain/configurator.mjsscript6.9 KB
assets/graphite-grain/relaxed.cssother4.2 KB
assets/openai-icon.pngbinary10.3 KB
assets/openai-icon.svgother318 B
assets/preview.jsscript3.4 KB
assets/report-recipes.mjsscript19.2 KB
assets/report-runtime.cssother16.4 KB
assets/report-runtime.jsscript23.9 KB
assets/report-shell.htmlother14.1 KB
references/comparisons.mdmarkdown4.8 KB
references/filesystem-handoff.mdmarkdown4.7 KB
references/managed-reports.mdmarkdown5.2 KB
references/markdown-input.mdmarkdown3.9 KB
references/model-v2.mdmarkdown10.1 KB
references/renderer.mdmarkdown24.5 KB
references/report-contract.mdmarkdown33.1 KB
references/selection.mdmarkdown4.8 KB
scripts/benchmark.mjsscript2.2 KB
scripts/cache_icon.pyscript9.2 KB
scripts/export-assets.mjsscript4.1 KB
scripts/lib/blocks-v2.mjsscript21.7 KB
scripts/lib/cli.mjsscript3.7 KB
scripts/lib/export-path.mjsscript1.6 KB
scripts/lib/generator-entry.mjsscript472 B
scripts/lib/markdown-input.mjsscript9.8 KB
scripts/lib/preview.mjsscript4.9 KB
scripts/lib/report-state.mjsscript13.4 KB
scripts/lib/report-store.mjsscript7.0 KB
scripts/lib/templates.mjsscript4.7 KB
scripts/render-report.mjsscript40.0 KB
tests/browser-delivery.mjsscript25.4 KB
tests/browser-smoke.pyscript15.5 KB
tests/browser-topics.mjsscript21.1 KB
tests/cache-icon.test.mjsscript5.0 KB
tests/export-assets.test.mjsscript5.5 KB
tests/render-report.test.mjsscript14.3 KB
tests/report-state.test.mjsscript11.7 KB
tests/topics.test.mjsscript6.4 KB
tests/v2.test.mjsscript21.1 KB

references/markdown-input.md

View on GitHub
# Optional Markdown input

Use JSON for complex adapters or existing source models. Use the bounded Markdown
form for short authoring. Both pass through `validateReport` and the same renderer.
Remark, GFM and Directives are bundled; no package installation occurs per report.
No MDX, JSX, imports, expressions or HTML executes.

Start from [the complete runnable example](../assets/completion-example.md).
Outer and inner directive attributes must be on one line. The outer report uses
four colons; contained blocks use three. GFM tables require a separator row.

```markdown
::::report{id="brief" type="overview" profile="software"}

# What changes

::takeaway[The new option is ready for review.]
::next[Compare the evidence before deciding.]
::caveat[One source remains unverified.]
::source{id="spec" label="Approved specification" state="documented"}

:::bullets{id="summary" title="Key points" sources="spec" icon="info"}

- The main behavior is documented.
- The open point remains visible.
  :::
  ::::
```

Required report attributes: `id`, `type`, `profile`; optional `style`, `goal`,
`presentation` (`topics`, `reading` or `slides`). Omitted v2 presentation uses
guided topics. To group adjacent sections, add ordered leaf directives:

```markdown
::topic{id="overview" title="Overview" short="Start" sections="flow,summary"}
::topic{id="comparison" title="Options" sections="options"}
```

Every section must appear once, in its existing order. `short` is optional. Without
topic directives each section is a topic. Group a meaningful graphic with its short
explanations, and keep comparisons on one topic.
There is exactly one title, takeaway and next action. Repeat `caveat` and `source`
when necessary. Source attributes are `id`, `label`, `state`, optional `url`, `asOf`.

All section directives require `id`, `title`; optional `sources` is a comma-separated
ID list and `icon` a bundled name. The supported shorthand blocks:

| Directive       | Attributes and body                                                                    |
| --------------- | -------------------------------------------------------------------------------------- |
| `bullets`       | One flat bullet list                                                                   |
| `diagram`       | `description`; one `mermaid` code fence                                                |
| `chart`         | `type`, `unit`, `context`, `direction`, `series="id:Label,id:Label"`; optional `xUnit` |
| `timeline`      | Table: `id,label,owner,start,end,progress,dependsOn`                                   |
| `statusHistory` | `context`; table: `at,status,sources,note`                                             |
| `model`         | No attributes; one `json` code fence containing a complete canonical section           |

Chart table columns: `id,label,series,value,state,sources,note`, optionally `x,role`.
Supply one row per observation/series pair. All series must be present; missing
observations use `null` with state `unknown`. Repeated observation IDs must agree
on label, x and role. Empty source/note cells are explicit empty values.
Numeric cells accept finite decimals/scientific notation or literal `null`; units
belong in attributes, not numeric cells. Timeline `dependsOn` names predecessor IDs.
Timeline dates are either all ISO calendar dates or all UTC timestamps with seconds
(optional three-digit milliseconds), ending in `Z`. Keep intraday times exact;
use `progress: null` for unknown progress. Do not infer a percentage from dates.

`model` is the escape hatch for every v1 block, additional details, logos and
extension fields. It still uses the common validator; it is not executable code.
Ordinary inline colons (including UTC timestamps) remain literal text. Inline
code and emphasis preserve text only; bold does not mean measured, healthy or best.
Links/HTML, nested lists, unknown attributes/directives, extra prose and malformed
tables produce diagnostics. Reader Markdown exports are not this input language.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall