Skip to content
Skills Library
Design & UX · Tool integration

excalidraw-cli

/excalidraw-cli

Create, inspect, update, and locally render Excalidraw scenes with the Excalidraw CLI. Use when a task needs an editable diagram or an Excalidraw+ workspace scene.

Repository
dotfiles ↗
Licence
MIT
Last repository change
25.10.2026

Assessment and security

95/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content30 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Create, inspect, update, and locally render Excalidraw scenes with the Excalidraw CLI. Use when a task needs an editable diagram or an Excalidraw+ workspace scene.

Original author description

Create, inspect, update, and locally render Excalidraw scenes with the Excalidraw CLI. Use when a task needs an editable diagram or an Excalidraw+ workspace scene.

How it works

  1. Local diagrams
  2. Excalidraw+ workspace
Original SKILL.md headings · 56 lines, 293 words
SKILL.md preview
---
name: excalidraw-cli
description: Create, inspect, update, and locally render Excalidraw scenes with the Excalidraw CLI. Use when a task needs an editable diagram or an Excalidraw+ workspace scene.
compatibility: portable
---

# Excalidraw CLI

Use `excalidraw` for editable diagrams. The managed binary is pinned at
`@excalidraw/cli@0.2.0`; inspect its current interface with
`excalidraw --help` or the relevant subcommand's `--help` before using an
unfamiliar option.

## Local diagrams

Treat a local `.excalidraw` file as the source of truth. Render it locally for
review without credentials:

```bash
excalidraw render architecture.excalidraw --out architecture.png
```

Use `--scale`, `--theme`, `--transparent`, or `--frame-id` only when the
requested output needs them. The CLI needs an installed Chrome, Chromium, Edge,
or Firefox; pass `--browser-path` or set `EXCALIDRAW_BROWSER_PATH` if automatic
detection fails. Images in a scene must be embedded, not linked by URL.

Inspect the rendered PNG before reporting a visual result. Keep local diagrams
and previews in the repository's appropriate documentation or artifact path;
do not overwrite an existing diagram without authorization.

## Excalidraw+ workspace

Workspace reads and writes require an API key. Prefer the injected
`EXCALIDRAW_API_KEY` environment variable; never request, print, or put a key
in source control. `excalidraw login` writes a user-local credential and is an
interactive alternative when the user explicitly authorizes it.

Read-only discovery is safe after credentials are available:

```bash
excalidraw whoami
excalidraw collections list
excalidraw scenes list --limit 20
excalidraw scenes content get <scene-id> --out scene.excalidraw
```

Creating, renaming, moving, pinning, trashing, or replacing workspace scenes is
an external write. Confirm the target workspace, collection, scene, and intended
content with the user before those operations. `scenes content put` replaces a
scene wholesale; use `scenes content patch` only when the user has authorized a
precise partial update. Render a workspace scene for review with:

```bash
excalidraw scenes render <scene-id> --out scene.png
```

The CLI emits JSON by default. Preserve parseable stdout in scripts and use
stderr for progress or errors. Use `-o table` only for human-readable list
output.

Versions

The database has no other skills named excalidraw-cli.

Database snapshot: 13.11.2026 · package version 9957553d9e5a (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 95excalidraw-diagram
    Create Excalidraw diagram JSON files that make visual arguments. Use when the user wants to visualize workflows, decisions, or system behavior as editable .excalidraw files.
  • 95excalidraw-diagram
    Create Excalidraw diagram JSON files that make visual arguments. Use when the user wants to visualize workflows, architectures, or concepts.
  • 95excalidraw-diagram
    Create Excalidraw diagram JSON files that make visual arguments. Use when the user wants to visualize workflows, architectures, or concepts.
  • 100excalidraw-diagrams
    Use when asked to create or update Excalidraw diagrams. Provides guidance on Excalidraw best practices.
  • 100excalidraw-diagram
    Generate Excalidraw diagrams from text content. Supports three output modes - Obsidian (.md), Standard (.excalidraw), and Animated (.excalidraw with animation order). Triggers on "Excalidraw", "diagram", "standard excalidraw", "animate".
  • 100excalidraw-diagram
    Create Excalidraw diagram JSON files that make visual arguments. Use when the user wants to visualize workflows, architectures, or concepts.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.