Run any Skill in Manus with one click

spec-render

Stars3

Forks0

UpdatedMay 27, 2026 at 20:25

Extract every PlantUML block from docs/specs/<slug>.md and render each to SVG under docs/specs/_rendered/<slug>/, with an index.md listing them in order. Run this before /approve-spec so the reviewer sees pictures instead of raw PlantUML.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

friedbotstudio

friedbotstudio/baseline

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

2 files

SKILL.md

readonly

name	spec-render
owner	baseline
description	Extract every PlantUML block from docs/specs/<slug>.md and render each to SVG under docs/specs/_rendered/<slug>/, with an index.md listing them in order. Run this before /approve-spec so the reviewer sees pictures instead of raw PlantUML.
disable-model-invocation	true

spec-render — render a spec's diagrams for review

User-invokable only. This skill has side effects (writes SVGs and an index). Claude does not invoke it autonomously.

Invocation

/spec-render <slug> — where <slug> corresponds to docs/specs/<slug>.md.

Prerequisites

java on PATH (JDK 8+) + the pinned plantuml.jar at .claude/bin/plantuml.jar (fetched at install time; SHA-verified). The render script invokes java -jar .claude/bin/plantuml.jar -tsvg ... and exits 2 with a named remedy if either dep is missing.
The spec at docs/specs/<slug>.md exists and passes spec_diagram_presence_guard + plantuml_syntax_guard — otherwise rendering will surface the same errors.

Steps

Validate the slug: docs/specs/<slug>.md must exist.
Run the render script:
```
node .claude/skills/spec-render/render.mjs <slug>
```
The script:
- Reads docs/specs/<slug>.md.
- Extracts every plantuml fenced block in source order.
- For each block: classifies it by marker (c4_context / c4_container / c4_component / sequence / class / dependency_graph / state / other), writes docs/specs/_rendered/<slug>/<NN>_<kind>.puml, then renders to <NN>_<kind>.svg.
- Writes docs/specs/_rendered/<slug>/index.md with section titles and image links in order.
Report the output path and a short per-kind count to the user.
If any block fails to render, surface the offending index + first line + stderr tail, and exit non-zero. Do not silently skip broken blocks.

Output

docs/specs/_rendered/<slug>/<NN>_<kind>.svg — one per diagram block.
docs/specs/_rendered/<slug>/<NN>_<kind>.puml — source kept next to the SVG for easier diffs.
docs/specs/_rendered/<slug>/index.md — markdown index with embedded images.

Notes

The render directory is a build output. Add docs/specs/_rendered/ to .gitignore if you don't want the SVGs in the repo; the PlantUML sources in the spec are the source of truth.
For offline review without Java + the pinned jar, use the plantuml MCP server from .mcp.json — it talks to a PlantUML renderer over HTTP. This skill prefers the local java -jar path because it's faster, keeps renders self-contained, and uses the SHA-pinned jar (so the version a consumer renders against matches what this baseline was tested with).

More from this repository

same repository

marketing-psychology

friedbotstudio/baseline

Cialdini 7 principles applied to global marketing — reciprocity, scarcity, authority, social proof, liking, commitment, unity. Universal psychology with international examples (Apple, Tesla, Patagonia, Spotify). Trigger: 'marketing psychology', 'Cialdini', 'persuasion principles', 'consumer psychology', 'behavioral marketing'.

2026-06-203

code-structure

friedbotstudio/baseline

MANDATORY skill for ALL code generation. Enforces top-down composition, consistent abstraction layers, and proper module hierarchy. Apply every time you write or modify code — in any language — no exceptions.

2026-06-203

simplify

friedbotstudio/baseline

Workflow Phase 7 — Mechanical cleanup pass over the branch diff, followed by a `code-structure` review pass and a `verify` re-stamp. Shadows the global `simplify` skill at project scope; the cleanup pass is performed inline rather than via Skill self-call.

2026-06-203

brainstorm

friedbotstudio/baseline

PM-mode brainstorm helper. Captures the requirement via Socratic dialogue before any entry phase (`/intake`, `/spec`, `/tdd`) drafts its artifact. Stage 0 skip-check, Stage 1 gap-analysis, Stage 2 probe-loop, Stage 3 confirm-and-persist. Output lives at `docs/brief/<slug>.md`. Never proposes solutions — Stage 2 dialogue discipline is structurally enforced via `discipline.mjs`.

2026-06-163

integrate

friedbotstudio/baseline

Workflow Phase 9 — Integration and Verification. Runs the full test suite, stamps the binding verdict at .claude/state/last_test_result, optionally runs a cross-engine smoke check, and writes harness_state so the harness auto-continues or yields. No subagent delegation.

2026-06-163

security

friedbotstudio/baseline

Workflow Phase 8 (optional) — OWASP-aligned security review of pending code changes. Produces a prioritized findings report (Critical/High/Medium/Low) mapped to OWASP Top 10 and CWE IDs. Output at `docs/security/<slug>-<date>.md`. Read-only.

2026-06-163

name	spec-render
owner	baseline
description	Extract every PlantUML block from docs/specs/<slug>.md and render each to SVG under docs/specs/_rendered/<slug>/, with an index.md listing them in order. Run this before /approve-spec so the reviewer sees pictures instead of raw PlantUML.
disable-model-invocation	true

spec-render — render a spec's diagrams for review

User-invokable only. This skill has side effects (writes SVGs and an index). Claude does not invoke it autonomously.

Invocation

/spec-render <slug> — where <slug> corresponds to docs/specs/<slug>.md.

Prerequisites

java on PATH (JDK 8+) + the pinned plantuml.jar at .claude/bin/plantuml.jar (fetched at install time; SHA-verified). The render script invokes java -jar .claude/bin/plantuml.jar -tsvg ... and exits 2 with a named remedy if either dep is missing.
The spec at docs/specs/<slug>.md exists and passes spec_diagram_presence_guard + plantuml_syntax_guard — otherwise rendering will surface the same errors.

Steps

Validate the slug: docs/specs/<slug>.md must exist.
Run the render script:
```
node .claude/skills/spec-render/render.mjs <slug>
```
The script:
- Reads docs/specs/<slug>.md.
- Extracts every plantuml fenced block in source order.
- For each block: classifies it by marker (c4_context / c4_container / c4_component / sequence / class / dependency_graph / state / other), writes docs/specs/_rendered/<slug>/<NN>_<kind>.puml, then renders to <NN>_<kind>.svg.
- Writes docs/specs/_rendered/<slug>/index.md with section titles and image links in order.
Report the output path and a short per-kind count to the user.
If any block fails to render, surface the offending index + first line + stderr tail, and exit non-zero. Do not silently skip broken blocks.

Output

docs/specs/_rendered/<slug>/<NN>_<kind>.svg — one per diagram block.
docs/specs/_rendered/<slug>/<NN>_<kind>.puml — source kept next to the SVG for easier diffs.
docs/specs/_rendered/<slug>/index.md — markdown index with embedded images.

Notes

The render directory is a build output. Add docs/specs/_rendered/ to .gitignore if you don't want the SVGs in the repo; the PlantUML sources in the spec are the source of truth.
For offline review without Java + the pinned jar, use the plantuml MCP server from .mcp.json — it talks to a PlantUML renderer over HTTP. This skill prefers the local java -jar path because it's faster, keeps renders self-contained, and uses the SHA-pinned jar (so the version a consumer renders against matches what this baseline was tested with).