ZenUml/conf-app / .claude/skills/find-macros-on-page
find-macros-on-page
VerifiedList ZenUML (and other) macros on any Confluence page in render order, with their customContentId, type, title, and ADF localId — and fetch a chosen macro's stored body (DrawIO XML / Mermaid / PlantUML / ZenUML DSL / OpenAPI). Two operations, one skill. Use whenever investigating a customer page, locating which macro to inspect/reproduce, correlating "the third diagram on page X" to a specific customContentId, or extracting a stored macro source for rebuild. Triggers on "what macros are on this page", "find the macro at <URL>", "fetch the macro source", "extract macro XML", "rebuild this customer's macro", or any starting step of a customer-page investigation.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.9 KB |
| scripts/fetch-source-snippet.js | script | 2.2 KB |
| scripts/fetch.mjs | script | 3.3 KB |
| scripts/list.mjs | script | 5.3 KB |
| scripts/snippet.js | script | 2.4 KB |
scripts/fetch.mjs
View on GitHub#!/usr/bin/env node
// Fetch a macro's stored body from any Confluence tenant the API token's
// account can read. For tenants where the token doesn't have access (most
// customer sites), use the browser snippet `fetch-source-snippet.js` instead.
//
// Usage:
// node fetch.mjs --site <site> --id <customContentId> [--out <path>] [--field graphXml|code|spec]
//
// Default behaviour: writes the chosen field (auto-detected) to --out, or to
// stdout if --out is omitted. Always prints the parsed body's metadata (type,
// title, diagramType, length) to stderr.
import { writeFileSync } from "node:fs";
import { parseArgs } from "node:util";
const KNOWN = {
"lite-dev": "lite-dev.atlassian.net",
"lite-stg": "lite-stg.atlassian.net",
"zenuml-stg": "zenuml-stg.atlassian.net",
"zenuml": "zenuml.atlassian.net",
};
const { values: args } = parseArgs({
options: {
site: { type: "string" },
id: { type: "string" },
out: { type: "string" },
field: { type: "string" },
json: { type: "boolean" },
},
});
if (!args.site || !args.id) fail("Usage: --site <site> --id <customContentId> [--out <path>] [--field graphXml|code|spec] [--json]");
const host = KNOWN[args.site] || (args.site.includes(".") ? args.site : `${args.site}.atlassian.net`);
const email = process.env.FORGE_EMAIL || process.env.ATLASSIAN_EMAIL;
const token = process.env.FORGE_API_TOKEN || process.env.ATLASSIAN_API_TOKEN;
if (!email || !token) fail("Missing FORGE_EMAIL / FORGE_API_TOKEN. See .env.forge.local.");
const auth = "Basic " + Buffer.from(`${email}:${token}`).toString("base64");
const res = await fetch(`https://${host}/wiki/api/v2/custom-content/${args.id}?body-format=raw`, {
headers: { Authorization: auth, Accept: "application/json" },
});
const text = await res.text();
if (!res.ok) fail(`HTTP ${res.status} on /custom-content/${args.id}\n${text.slice(0, 500)}`);
const j = JSON.parse(text);
const raw = j.body?.raw?.value;
const body = raw ? safeParse(raw) : null;
if (args.json) {
// Emit the parsed body as JSON on stdout — useful for piping to jq.
process.stdout.write(JSON.stringify({ type: j.type, title: j.title, body }, null, 2));
process.exit(0);
}
// Pick which inner field to emit. Auto-detect based on diagramType when --field omitted.
const field = args.field || autoField(body);
if (!field) fail("Could not auto-detect body field; pass --field graphXml | code | spec | <other>");
const value = body?.[field];
if (typeof value !== "string") fail(`Field '${field}' missing or not a string on body. Keys: ${body ? Object.keys(body).join(", ") : "(none)"}`);
console.error(`# type=${(j.type || "").split(":").pop()} title=${JSON.stringify(j.title)} diagramType=${body?.diagramType} field=${field} bytes=${value.length}`);
if (args.out) {
writeFileSync(args.out, value);
console.error(`# wrote ${value.length} bytes -> ${args.out}`);
} else {
process.stdout.write(value);
}
// ---
function autoField(body) {
if (!body) return null;
if (typeof body.graphXml === "string") return "graphXml"; // graph (DrawIO)
if (typeof body.code === "string") return "code"; // sequence / mermaid / plantuml
if (typeof body.spec === "string") return "spec"; // openapi
return null;
}
function safeParse(s) {
try { return JSON.parse(s); } catch { return null; }
}
function fail(msg) { console.error(msg); process.exit(1); }
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |