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

scripts/lib/cli.mjs

View on GitHub
// SPDX-License-Identifier: Apache-2.0
import { readFile, writeFile } from "node:fs/promises";
import path from "node:path";
import { parseMarkdown } from "./markdown-input.mjs";
import { starter, templates, profiles } from "./templates.mjs";
import { validateReport, writeReport } from "../render-report.mjs";
import { currentRevision, publishRevision, history } from "./report-store.mjs";
import { serveReport } from "./preview.mjs";

export async function readInput(filename) {
  const input = await readFile(path.resolve(filename), "utf8");
  if (/\.md$/i.test(filename)) return parseMarkdown(input);
  if (!/\.json$/i.test(filename)) throw new TypeError("Input extension must be .json or .md");
  return validateReport(JSON.parse(input));
}
const usage = `Visual Reports
  --templates
  --starter TYPE --profile PROFILE --id ID [--output NEW_FILE.json]
  --input MODEL.json|MODEL.md --output NEW_DIRECTORY
  --create STORE --input MODEL.json|MODEL.md
  --update STORE --input MODEL.json|MODEL.md --base REVISION
  --current STORE | --history STORE
  --preview STORE [--port NUMBER]
  --gallery NEW_DIRECTORY | --extract REPORT.html [--section ID]
All writes are explicit. Preview binds loopback and stops with Ctrl-C.`;
export async function runCli(args) {
  if (args.length === 1 && args[0] === "--help") {
    console.log(usage);
    return;
  }
  if (args.length === 1 && args[0] === "--templates") {
    console.log(JSON.stringify({ templates, profiles }, null, 2));
    return;
  }
  if (args.length === 2 && ["--current", "--history"].includes(args[0])) {
    console.log(
      JSON.stringify(
        await (args[0] === "--current" ? currentRevision : history)(path.resolve(args[1])),
        null,
        2,
      ),
    );
    return;
  }
  const flags = {};
  for (let i = 0; i < args.length; i += 2) {
    if (
      !args[i].startsWith("--") ||
      args[i + 1] === undefined ||
      args[i + 1].startsWith("--") ||
      Object.hasOwn(flags, args[i])
    )
      throw new Error(usage);
    flags[args[i]] = args[i + 1];
  }
  const only = (allowed) => {
    if (Object.keys(flags).some((k) => !allowed.includes(k))) throw new Error(usage);
  };
  if (flags["--starter"]) {
    only(["--starter", "--profile", "--id", "--output"]);
    const report = validateReport(
      starter({ type: flags["--starter"], profile: flags["--profile"], id: flags["--id"] }),
    );
    const data = JSON.stringify(report, null, 2) + "\n";
    if (flags["--output"]) await writeFile(path.resolve(flags["--output"]), data, { flag: "wx" });
    else process.stdout.write(data);
    return;
  }
  if (flags["--preview"]) {
    only(["--preview", "--port"]);
    const preview = await serveReport(path.resolve(flags["--preview"]), {
      port: flags["--port"] === undefined ? 0 : Number(flags["--port"]),
    });
    console.log(preview.url);
    for (const signal of ["SIGINT", "SIGTERM"])
      process.once(signal, () => {
        preview.close().catch((e) => {
          console.error(e.message);
          process.exitCode = 1;
        });
      });
    return;
  }
  if (flags["--create"] || flags["--update"]) {
    only(flags["--create"] ? ["--create", "--input"] : ["--update", "--input", "--base"]);
    if (!flags["--input"] || (flags["--update"] && !flags["--base"])) throw new Error(usage);
    const result = await publishRevision(
      await readInput(flags["--input"]),
      path.resolve(flags["--create"] ?? flags["--update"]),
      { expected: flags["--base"] ?? null },
    );
    console.log(JSON.stringify(result, null, 2));
    return;
  }
  only(["--input", "--output"]);
  if (!flags["--input"] || !flags["--output"]) throw new Error(usage);
  await writeReport(await readInput(flags["--input"]), path.resolve(flags["--output"]));
  console.log(`Report written: ${flags["--output"]}`);
}
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