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/export-assets.mjs

View on GitHub
import { createHash } from "node:crypto";
import { execFileSync } from "node:child_process";
import { mkdir, readFile, writeFile, realpath, lstat } from "node:fs/promises";
import path from "node:path";
import { fileURLToPath } from "node:url";
import { resolveExportTarget } from "./lib/export-path.mjs";

const skill = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
const git = (...args) => execFileSync("git", ["-C", skill, ...args], { encoding: "utf8" }).trim();
const args = process.argv.slice(2);
const destinationIndex = args.indexOf("--destination");
if (
  destinationIndex < 0 ||
  !args[destinationIndex + 1] ||
  args.some((arg, i) => i !== destinationIndex + 1 && !["--destination", "--check"].includes(arg))
) {
  throw new Error("Usage: node scripts/export-assets.mjs --destination <directory> [--check]");
}
const destination = path.resolve(args[destinationIndex + 1]);
const repo = await realpath(git("rev-parse", "--show-toplevel"));
const skillPath = path.relative(repo, skill).split(path.sep).join("/");
let ancestor = destination;
while (true) {
  try {
    ancestor = await realpath(ancestor);
    break;
  } catch (error) {
    if (error.code !== "ENOENT") throw error;
    ancestor = path.dirname(ancestor);
  }
}
if (ancestor === repo || ancestor.startsWith(repo + path.sep))
  throw new Error("Export into a consumer directory outside the skill source repository.");
const inputs = {
  // Keep the original flat entry points for existing consumers.
  "configurator.mjs": "assets/graphite-grain/configurator.mjs",
  "configurator.html": "assets/graphite-grain/configurator.html",
  "relaxed.css": "assets/graphite-grain/relaxed.css",
  "cache_icon.py": "scripts/cache_icon.py",
  "LICENSE.txt": path.relative(skill, path.join(repo, "LICENSE")),
};
// Preserve canonical relative imports so the complete renderer runs offline from the bundle.
for (const input of git(
  "ls-files",
  "--",
  "SKILL.md",
  "agents",
  "assets",
  "references",
  "scripts",
  "tests",
)
  .split("\n")
  .filter(Boolean))
  inputs[input] = input;
for (const required of [
  "scripts/render-report.mjs",
  "assets/report-runtime.js",
  "assets/report-runtime.css",
  "assets/report-recipes.mjs",
  "scripts/lib/report-state.mjs",
  "references/renderer.md",
]) {
  if (!inputs[required]) throw new Error(`Missing committed renderer input: ${required}`);
}
if (git("status", "--porcelain", "--untracked-files=all", "--", "."))
  throw new Error("Uncommitted skill source; commit the complete snapshot before export.");
for (const input of Object.values(inputs)) {
  git("ls-files", "--error-unmatch", "--", input);
  if (git("status", "--porcelain", "--", input)) throw new Error(`Uncommitted source: ${input}`);
  if (!(await lstat(path.join(skill, input))).isFile())
    throw new Error(`Not a regular file: ${input}`);
}
const payloads = await Promise.all(
  Object.entries(inputs)
    .sort(([a], [b]) => a.localeCompare(b))
    .map(async ([file, input]) => {
      const bytes = await readFile(path.join(skill, input));
      return { file, input, bytes, sha256: createHash("sha256").update(bytes).digest("hex") };
    }),
);
const manifest = {
  version: 1,
  generated: true,
  source: {
    repository: "https://github.com/stark-ai-de/agent-skills",
    revision: git("rev-parse", "HEAD"),
    skillPath,
  },
  files: payloads.map(({ file, input, sha256 }) => ({
    file,
    source: path.posix.normalize(`${skillPath}/${input}`),
    sha256,
  })),
};
const outputs = [
  ...payloads,
  { file: "manifest.json", bytes: Buffer.from(JSON.stringify(manifest, null, 2) + "\n") },
];
if (!args.includes("--check")) await mkdir(destination, { recursive: true });
for (const { file, bytes } of outputs) {
  const target = await resolveExportTarget(destination, file, {
    create: !args.includes("--check"),
  });
  if (args.includes("--check")) {
    if (!(await readFile(target)).equals(bytes)) throw new Error(`Bundle differs: ${file}`);
  } else {
    await writeFile(target, bytes);
  }
}
console.log(
  `${outputs.length} files ${args.includes("--check") ? "verified" : "exported"}; ${manifest.source.revision}`,
);
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