stark-ai-de/agent-skills / plugins/stark-ai-developer/skills/visual-reports
visual-reports
VerifiedCreate 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.
scripts/export-assets.mjs
View on GitHubimport { 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}`,
);
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |