Not in the top 1,000 by GitHub stars

himanshu13ps/penciled

Technical diagrams, sketched in pencil. An agent skill and CLI that turns JSON into hand-drawn architecture diagrams. No dependencies.

Engineering

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

`skills/penciled/SKILL.md`

Week of Nov 2, 2026 · +0 / −0 lines

Before Local scripts → After Local scripts

75fd67aa378c → 75fd67aa378c

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Local scripts

First observation → 75fd67aa378c

No earlier version was observed for comparison.

Compare on GitHub

View on GitHub Add to my skills

Verified commit 75fd67aa378cab3f6e88396df8d53b8dbbe0f755

13GitHub stars

0stars in 7 days

1skill in this repository

20commits in 30 days

Heat

1.6

Star growth, last 7 daysNot available
Star growth, last 24 hoursNot available
Rank movement, last 7 daysNot available
Commits, last 30 daysNot available
Accounts asking about it through MCP, last 7 daysNot available
Hot votes this weekNot available

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

30-day change not yet available: not enough history.

Individual skills in this repository

penciled skills/penciled

How it works

penciled

When your agent uses it

Draw architecture and system diagrams that look hand-sketched in graphite pencil on paper (tapered, wobbly strokes, hatched shading, paper grain, handwritten labels), as an SVG, a PNG or a self-contained interactive HTML page. Use this whenever someone wants a hand-drawn, sketchy, whiteboard-style, napkin-sketch or pencil diagram of how a system fits together (services, databases, queues, users, external APIs, pipelines, cloud infrastructure, data flows), or asks you to "sketch" or "draw" an architecture, even if they never say "pencil". Not for charts of numbers, UI mockups, or precise engineering drawings.

What it loads into context

Frontmatter

150 tokens

Always available to the agent

SKILL.md

2,238 tokens

When the skill is activated

Reference documents

1,150 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

Where things are
Workflow
Changing a drawing later

Scripts executed separately

package.json
src/assets.js
src/bundle.js
src/cli.js
src/edges.js
src/geometry.js
src/layout.js
src/paper.js
src/random.js
src/raster.js
src/render.js
src/shapes.js
src/stroke.js
src/text.js
src/validate.js
src/viewer.js

Files

LICENSEasset1,078 bytes
SKILL.mdcore8,485 bytes
SKILL.mdcore8,485 bytes
SKILL.mdcore8,485 bytes
SKILL.mdcore8,485 bytes
SKILL.mdcore8,485 bytes
SKILL.mdcore8,485 bytes
SKILL.mdcore8,485 bytes
SKILL.mdcore8,485 bytes
fonts/OFL.txtdoc4,385 bytes
fonts/caveat-metrics.jsonasset1,993 bytes
fonts/caveat.woff2asset47,116 bytes
package.jsonruns42 bytes
schema/README.mddoc4,112 bytes
schema/architecture.schema.jsonasset7,729 bytes
src/assets.jsruns600 bytes
src/bundle.jsruns2,256 bytes
src/cli.jsruns3,030 bytes
src/edges.jsruns5,795 bytes
src/geometry.jsruns3,565 bytes
src/layout.jsruns14,187 bytes
src/paper.jsruns4,784 bytes
src/random.jsruns595 bytes
src/raster.jsruns7,104 bytes
src/render.jsruns9,117 bytes
src/shapes.jsruns15,518 bytes
src/stroke.jsruns4,984 bytes
src/text.jsruns883 bytes
src/validate.jsruns17,061 bytes
src/viewer.jsruns14,366 bytes

Read SKILL.md


# penciled

penciled turns a small JSON description of a system into a drawing that
looks like someone sketched it with a 2B pencil: boxes whose corners cross,
arrows with a little sag, hatched shading, handwritten labels, paper texture.
It lays the diagram out automatically, checks the input, and writes either a
plain SVG or an HTML page where the reader can redraw, zoom and save.

It needs Node.js 18 or later and nothing else: no install step, no
dependencies, no network.

## Where things are

Everything is relative to this skill's directory (the folder containing this

View the complete source on GitHub

Skills included

penciled

Repository facts

License: MIT
Created: Oct 10, 2026
Last pushed: Oct 11, 2026
Forks: 1
Open issues: 0
Project activity: Active

Before you install

Local scripts

Automated signals, not a guarantee

Checked Nov 5, 2026

Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.

Show 7 notes

skills/penciled/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
skills/penciled/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
skills/penciled/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
skills/penciled/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
skills/penciled/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
skills/penciled/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
skills/penciled/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed

No broad tool permissions
No dangerous shell commands
8 network referencesin 3 files: penciled/fonts/OFL.txt:1 penciled/schema/architecture.schema.json:1 penciled/src/render.js:182
No hidden or obfuscated text
No instruction overrides
16 executable scriptsin 16 files: penciled/package.json:1 penciled/src/assets.js:1 penciled/src/bundle.js:1 and 13 more
No access to secrets
No requests to vote in Hot

Show all 24 signals by file

`skills/penciled/fonts/OFL.txt`

Network accessline 1

Copyright 2014 The Caveat Project Authors (https://github.com/googlefonts/caveat)

Network accessline 3

This Font Software is licensed under the SIL Open Font License, Version 1.1. This license is copied below, and is also available with a FAQ at: http://scripts.sil.org/OFL

Network accessline 5
```
http://scripts.sil.org/OFL
```

`skills/penciled/package.json`

Executable scriptline 1
```
Executable file
```

`skills/penciled/schema/architecture.schema.json`

Network accessline 1

{   "$schema": "https://json-schema.org/draft/2020-12/schema",

Network accessline 2

"$schema": "https://json-schema.org/draft/2020-12/schema",

Network accessline 3

"$id": "https://raw.githubusercontent.com/himanshu13ps/penciled/main/skills/penciled/schema/architecture.schema.json",

`skills/penciled/src/assets.js`

Executable scriptline 1
```
Executable file
```

`skills/penciled/src/bundle.js`

Executable scriptline 1
```
Executable file
```

`skills/penciled/src/cli.js`

Executable scriptline 1
```
#!/usr/bin/env node
```

`skills/penciled/src/edges.js`

Executable scriptline 1
```
Executable file
```

`skills/penciled/src/geometry.js`

Executable scriptline 1
```
Executable file
```

`skills/penciled/src/layout.js`

Executable scriptline 1
```
Executable file
```

`skills/penciled/src/paper.js`

Executable scriptline 1
```
Executable file
```

`skills/penciled/src/random.js`

Executable scriptline 1
```
Executable file
```

`skills/penciled/src/raster.js`

Executable scriptline 1
```
Executable file
```

`skills/penciled/src/render.js`

Executable scriptline 1
```
Executable file
```

Network accessline 182

const { x, y, width: W, height: H } = page;   return `<svg xmlns="http://www.w3.org/2000/svg" width="${W}" height="${H}" viewBox="${r1(x)} ${r1(y)} ${W} ${H}">

Network accessline 183

return `<svg xmlns="http://www.w3.org/2000/svg" width="${W}" height="${H}" viewBox="${r1(x)} ${r1(y)} ${W} ${H}">

`skills/penciled/src/shapes.js`

Executable scriptline 1
```
Executable file
```

`skills/penciled/src/stroke.js`

Executable scriptline 1
```
Executable file
```

`skills/penciled/src/text.js`

Executable scriptline 1
```
Executable file
```

`skills/penciled/src/validate.js`

Executable scriptline 1
```
Executable file
```

`skills/penciled/src/viewer.js`

Executable scriptline 1
```
Executable file
```

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Some files could not be read; the facts below still hold.

Declared and executed: 1 fact

Contacts www.w3.org, which SKILL.md, the README and the plugin manifest do not mentionpenciled/src/render.js:183High confidence

Signal confidence: 21 facts

Network access in prose of documentationpenciled/fonts/OFL.txt:1Low confidence
Network access in prose of documentationpenciled/fonts/OFL.txt:3Low confidence
Network access in prose of documentationpenciled/fonts/OFL.txt:5Low confidence
Executable script in code of a file that runspenciled/package.json:1High confidence
Executable script in a comment of a file that runspenciled/src/assets.js:1Low confidence
Executable script in a comment of a file that runspenciled/src/bundle.js:1Low confidence
Executable script in code of a file that runspenciled/src/cli.js:1High confidence
Executable script in a comment of a file that runspenciled/src/edges.js:1Low confidence
Executable script in a comment of a file that runspenciled/src/geometry.js:1Low confidence
Executable script in a comment of a file that runspenciled/src/layout.js:1Low confidence
Executable script in a comment of a file that runspenciled/src/paper.js:1Low confidence
Executable script in a comment of a file that runspenciled/src/random.js:1Low confidence
Executable script in a comment of a file that runspenciled/src/raster.js:1Low confidence
Executable script in a comment of a file that runspenciled/src/render.js:1Low confidence
Network access in code of a file that runspenciled/src/render.js:182High confidence
Network access in code of a file that runspenciled/src/render.js:183High confidence
Executable script in a comment of a file that runspenciled/src/shapes.js:1Low confidence
Executable script in a comment of a file that runspenciled/src/stroke.js:1Low confidence
Executable script in a comment of a file that runspenciled/src/text.js:1Low confidence
Executable script in a comment of a file that runspenciled/src/validate.js:1Low confidence
Executable script in a comment of a file that runspenciled/src/viewer.js:1Low confidence

Works with

Agent compatibility, from the files in this repository
Agent	Status	Evidence	Install to
Claude Code	Compatible	Standard SKILL.md skills/penciled/SKILL.md	`.claude/skills/<skill-name>/`
Codex	Compatible	Standard SKILL.md skills/penciled/SKILL.md	`.agents/skills/<skill-name>/`
Cursor	Compatible	Standard SKILL.md skills/penciled/SKILL.md	`.cursor/skills/<skill-name>/`
Gemini CLI	Compatible	Standard SKILL.md skills/penciled/SKILL.md	`.gemini/skills/<skill-name>/`
GitHub Copilot	Compatible	Standard SKILL.md skills/penciled/SKILL.md	`.github/skills/<skill-name>/`
OpenCode	Compatible	Standard SKILL.md skills/penciled/SKILL.md	`.opencode/skills/<skill-name>/`

Native The repository ships a manifest, folder or frontmatter field for this agent.
Compatible A standard SKILL.md that this agent can read.
Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.

himanshu13ps/penciled

History

skills/penciled/SKILL.md

Share this page

Heat

Stars over time

Individual skills in this repository

How it works

penciled

Frontmatter

SKILL.md

Reference documents

The playbook

Scripts executed separately

Files

Skills included

Repository facts

Before you install

skills/penciled/fonts/OFL.txt

skills/penciled/package.json

skills/penciled/schema/architecture.schema.json

skills/penciled/src/assets.js

skills/penciled/src/bundle.js

skills/penciled/src/cli.js

skills/penciled/src/edges.js

skills/penciled/src/geometry.js

skills/penciled/src/layout.js

skills/penciled/src/paper.js

skills/penciled/src/random.js

skills/penciled/src/raster.js

skills/penciled/src/render.js

skills/penciled/src/shapes.js

skills/penciled/src/stroke.js

skills/penciled/src/text.js

skills/penciled/src/validate.js

skills/penciled/src/viewer.js