Back to search
lanshu-animated-architecture-diagram
SkillGitHub
Premium hand-drawn animated architecture diagram Codex skill
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/cclank--lanshu-animated-architecture-diagram)HTML
<a href="/listings/cclank--lanshu-animated-architecture-diagram"><img src="/api/listings/cclank--lanshu-animated-architecture-diagram/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
git clone https://github.com/cclank/lanshu-animated-architecture-diagram.git cd lanshu-animated-architecture-diagram python3 -m pip install -r requirements.txt python3 scripts/render_animated_diagram.py \ --spec assets/default-spec.json \ --outdir outputs \ --basename sample \ --verify
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 97 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: lanshu-animated-architecture-diagram
- version: 1.0.0
- display_name: 岚叔动态架构图
- display_name_en: Lanshu Animated Architecture Diagram
- description_zh: 创建岚叔风格的高质感黑底手绘架构图和流程图,输出可编辑的 Excalidraw 文件、PNG 预览和带流动高亮效果的 GIF。
- description_en: Create premium black-canvas hand-drawn architecture and process diagrams with editable Excalidraw files, PNG previews, and animated GIFs with moving flow highlights.
- description: Create premium hand-drawn architecture and process diagrams in the Lanshu animated GIF style, with editable .excalidraw files, static PNG previews, and genuinely animated GIFs with moving flow highlights. Use this skill whenever the user asks for 岚叔动态架构图, Excalidraw-like diagrams, DailyDoseOfDS-style black-background sketches, animated architecture/process GIFs, polished flowcharts, visual explanations of articles or system designs, or asks to replicate or improve a reference diagram with hand-drawn animated effects.
- ---
- # Lanshu Animated Architecture Diagram
- Create a polished black-background hand-drawn technical diagram with:
- - Editable `.excalidraw` source
- - Static `.png` preview
- - Animated `.gif` with moving glow points and pulsing module highlights
- Use the bundled renderer for deterministic output. Avoid external icon libraries unless the user explicitly provides audited assets.
- ## Workflow
- 1. Extract the diagram content.
- - For an article or long post, identify the core architecture, actors, stages, data flow, decisions, and final outputs.
- - For a reference image, preserve the visual grammar: title structure, panels, arrows, density, and signature placement.
- 2. Create a spec JSON.
- - Start from `assets/default-spec.json`.
- - Keep labels short. Read `references/spec-format.md` when field details or copy length guidance are needed.
- - Use the user’s language for explanatory labels unless the reference style clearly calls for English titles.
- 3. Render the outputs.
- ```bash
- python /path/to/skill/scripts/render_animated_diagram.py \
- --spec /path/to/spec.json \
- --outdir /path/to/output-dir \
- --basename descriptive-name \
- --verify \
- --check
- ```
- 4. Validate before delivery.
- - Confirm GIF dimensions, FPS, frame count, and duration with `ffprobe`.
- - Use `--verify` output or `--check` to prove the GIF is not static.
- - Confirm `.excalidraw` JSON has unique IDs, text uses `fontFamily: 5`, and `files` is empty. `--check` validates these output contracts automatically.
- - Open the PNG preview visually and fix overlap, cramped text, or weak hierarchy.
- 5. Deliver the three files.
- - Show the GIF preview when the interface supports local images.
- - Link the PNG and `.excalidraw` source.
- ## Style Rules
- - Use a dark canvas with a thin outer rounded frame.
- - Use one highlighted title phrase in a green capsule.
- - Put the author signature in the top-right brand slot unless the user asks otherwise.
- - Prefer clean white main arrows. Use colored motion only in the GIF overlay.
- - Keep static diagrams restrained. Let animation add motion, not clutter.
- - Use short text. If a phrase cannot fit, rewrite it instead of shrinking until unreadable.
- - Use built-in simple icons: `folder`, `file`, `scan`, `shield`, `db`, `hash`, `package`.
- ## Spec Authoring Hints
- Map common content to the fixed layout:
- - `inputs`: source systems, triggers, documents, tools, or user actions
- - `core.cards`: the three main stages of the process
- - `decision`: the quality gate or readiness check
- - `left_panel`: memory/context/source material
- - `center_panel`: internal layers, safeguards, archive stores, or pipeline internals
- - `right_panel`: packaged outputs, reusable assets, generated reports, or agent-facing artifacts
- If the subject has more than three stages, group adjacent steps into three core cards and move details into the lower panels.
- ## Verification Commands
- Use these checks after rendering:
- ```bash
- ffprobe -v error -select_streams v:0 -count_frames \
- -show_entries stream=width,height,r_frame_rate,avg_frame_rate,nb_read_frames \
- -show_entries format=duration \
- -of default=noprint_wrappers=1 output.gif
- ```
- ```bash
- python /path/to/skill/scripts/render_animated_diagram.py \
- --spec spec.json \
- --outdir outputs \
- --basename diagram \
- --verify \
- --check
- ```
- The `--verify` report should show nonzero changed pixels between sampled GIF frames.
- The `--check` report should return `"ok": true`; it exits nonzero on contract failures.
README.md · README · 267 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <div align="center">
- # Lanshu Animated Architecture Diagram
- **岚叔动态架构图: premium hand-drawn animated architecture diagrams for articles, systems, and workflows.**
- [](./SKILL.md)
- [](https://www.python.org/)
- [](https://python-pillow.org/)
- [](https://excalidraw.com/)
- [](./scripts/render_animated_diagram.py)
- [](./LICENSE)
- `JSON spec` -> `.excalidraw` + `.png` + animated `.gif`
- </div>
- <p align="center">
- <a href="#gallery">Gallery</a> ·
- <a href="#quick-start">Quick Start</a> ·
- <a href="#features">Features</a> ·
- <a href="#spec-structure">Spec</a> ·
- <a href="#verification">Verification</a>
- </p>
- `lanshu-animated-architecture-diagram` is a Codex skill and local renderer for creating premium black-canvas technical diagrams with hand-drawn typography, editable Excalidraw output, static PNG previews, and genuinely animated GIFs.
- It is designed for article explanations, system architecture diagrams, process diagrams, and DailyDoseOfDS-style black-background technical sketches.
- ## Gallery
- The default visual system uses a dark canvas, moving flow highlights, pulsing modules, subtle grain, vignette, and a top-right hand-drawn signature.
- <table>
- <tr>
- <td width="50%" align="center">
- <strong>Claude Loops</strong><br />
- <img src="./assets/previews/claude-loops.gif" alt="Claude Loops animated architecture diagram" width="100%" />
- </td>
- <td width="50%" align="center">
- <strong>Memory Pack</strong><br />
- <img src="./assets/previews/memory-pack.gif" alt="Memory Pack animated architecture diagram" width="100%" />
- </td>
- </tr>
- </table>
- ## Features
- - Generates `.excalidraw`, `.png`, and animated `.gif` from one JSON spec
- - Produces real animation with moving glow points and pulsing module highlights
- - Keeps the `.excalidraw` source editable and text-based
- - Uses local Python rendering through Pillow
- - Does not require Excalidraw, browser automation, ImageMagick, remote APIs, or external icon libraries
- - Includes frame-diff verification to prove GIF motion
- - Uses a fixed high-quality layout for clean technical storytelling
- ## Outputs
- Each render produces:
- ```text
- <basename>.excalidraw
- <basename>.png
- <basename>.gif
- ```
- The default canvas is:
- ```text
- 1210 x 1138
- 20 fps
- 41 frames
- 2.05 seconds
- ```
- ## Quick Start
- ```bash
- git clone https://github.com/cclank/lanshu-animated-architecture-diagram.git
- cd lanshu-animated-architecture-diagram
- python3 -m pip install -r requirements.txt
- python3 scripts/render_animated_diagram.py \
- --spec assets/default-spec.json \
- --outdir outputs \
- --basename sample \
- --verify
- ```
- ## Installation
- Place this folder in your Codex skills directory:
- ```bash
- ~/.codex/skills/lanshu-animated-architecture-diagram
- ```
- Typical local install path:
- ```bash
- ${CODEX_HOME:-$HOME/.codex}/skills/lanshu-animated-architecture-diagram
- ```
- Install the runtime dependency:
- ```bash
- python3 -m pip install -r requirements.txt
- ```
- ## Use With Codex
- Invoke the skill by name:
- ```text
- Use $lanshu-animated-architecture-diagram to turn this article into a premium hand-drawn animated architecture GIF.
- ```
- Chinese prompt example:
- ```text
- 用 $lanshu-animated-architecture-diagram 把这篇文章整理成岚叔动态架构图,输出 GIF、PNG 和 Excalidraw。
- ```
- ## CLI Usage
- Start from the bundled template:
- ```bash
- cp assets/default-spec.json work/my-diagram-spec.json
- ```
- Render:
- ```bash
- python3 scripts/render_animated_diagram.py \
- --spec work/my-diagram-spec.json \
- --outdir outputs \
- --basename my-diagram \
- --verify \
- --check
- ```
- The `--verify` flag prints sampled frame differences. Nonzero changed pixels confirm that the GIF is genuinely animated.
- The `--check` flag validates the generated PNG, GIF, and Excalidraw output
- contract and exits nonzero if a required property fails. It checks dimensions,
- GIF frame count and frame duration, sampled GIF motion, unique Excalidraw IDs,
- text font family, and that no external files are embedded.
- ## Spec Structure
- The renderer uses `assets/default-spec.json` as a compact art-directed template.
- Most edits happen in these fields:
- ```text
- signature
- title.prefix
- title.highlight
- title.subtitle
- inputs
- core.cards
- decision
- output
- left_panel
- center_panel
- right_panel
- ```
- Supported icon keys:
- ```text
- folder
- file
- scan
- shield
- db
- hash
- package
- ```
- For details, see [references/spec-format.md](./references/spec-format.md).
- ## Verification
- Validate the skill structure:
- ```bash
- python3 ${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-creator/scripts/quick_validate.py \
- ${CODEX_HOME:-$HOME/.codex}/skills/lanshu-animated-architecture-diagram
- ```
- Validate GIF media parameters:
- ```bash
- ffprobe -v error -select_streams v:0 -count_frames \
- -show_entries stream=width,height,r_frame_rate,avg_frame_rate,nb_read_frames \
- -show_entries format=duration \
- -of default=noprint_wrappers=1 outputs/my-diagram.gif
- ```
- Validate animation:
- ```bash
- python3 scripts/render_animated_diagram.py \
- --spec assets/default-spec.json \
- --outdir outputs \
- --basename sample \
- --verify \
- --check
- ```
- ## Dependencies
- Required:
- - Python 3.9+
- - Pillow 10.0.0+
- Install Python packages with:
- ```bash
- python3 -m pip install -r requirements.txt
- ```
- Optional:
- - `ffprobe` for media inspection
- - Excalidraw web app or editor plugin for manual editing of generated `.excalidraw` files
- ## Project Layout
- ```text
- lanshu-animated-architecture-diagram/
- ├── SKILL.md
- ├── README.md
- ├── LICENSE
- ├── requirements.txt
- ├── agents/
- │ └── openai.yaml
- ├── assets/
- │ ├── default-spec.json
- │ └── previews/
- │ ├── claude-loops.gif
- │ └── memory-pack.gif
- ├── references/
- │ └── spec-format.md
- └── scripts/
- └── render_animated_diagram.py
- ```
- ## Design Notes
- This project intentionally keeps the visual system narrow:
- - Dark canvas
- - Hand-drawn title treatment
- - Top input strip
- - Middle core pipeline
- - Bottom source, layer, and pack panels
- - Top-right signature
- - Clean static diagram with motion added only in GIF overlays
- That constraint keeps outputs consistent and polished across different architecture topics.
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.