Skip to content
Back to search

watercolour-brush

MarketplaceWorks with Claude CodeGitHub

Pencil-and-wash watercolour illustration for Claude, painted as code.

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hanlianlu--watercolour-brush/badge.svg)](/listings/hanlianlu--watercolour-brush)

HTML

<a href="/listings/hanlianlu--watercolour-brush"><img src="/api/listings/hanlianlu--watercolour-brush/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Claude Code (plugin):**

/plugin marketplace add hanlianlu/watercolour-brush
/plugin install watercolour-brush@watercolour-brush

**As a plain skill:** copy `skills/watercolour-brush/` into `~/.claude/skills/` (Claude Code), or zip that folder and upload it under Customize → Skills on claude.ai (code execution must be on).

Then ask Claude for something like *"paint this sketch as a watercolour portrait"* or *"add three more portraits that match these watercolours"*.

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.

.claude-plugin/marketplace.json · Manifest · 15 lines
  1. {
  2. "name": "watercolour-brush",
  3. "description": "Pencil-and-wash watercolour illustration for Claude, painted as code.",
  4. "owner": {
  5. "name": "hanlianlu",
  6. "url": "https://github.com/hanlianlu"
  7. },
  8. "plugins": [
  9. {
  10. "name": "watercolour-brush",
  11. "source": "./",
  12. "description": "Watercolour picture-book illustration painted as code: paper, glazes, wet edges, dry brush, pencil."
  13. }
  14. ]
  15. }
README.md · README · 76 lines
  1. # watercolour-brush
  2. An [Agent Skill](https://docs.claude.com/en/docs/agents-and-tools/agent-skills) for Claude that paints **pencil-and-wash watercolour illustrations as code**: portraits, figures, clothes and small spot art, in a quiet picture-book look.
  3. ![two portraits painted with the skill](docs/portraits.jpg)
  4. Each picture is a sheet of cold-press paper and a stack of layers: transparent washes that multiply over each other, wet sessions of brush strokes that melt into one another inside a hard outer edge, graded washes, dry brush, granulation, blooms, lifted lights and broken graphite lines. The same drawing file always paints the same pixels, so a set stays in one hand and any stroke can be adjusted by editing a number. No image model is involved.
  5. The skill is two parts, kept apart on purpose:
  6. - **The brush system** (`references/engine/`): paper, pigment, water and strokes as deterministic Python (numpy + OpenCV). It does exactly what it is told.
  7. - **The painter's guide** (`SKILL.md`, `references/`): how Claude studies a source picture, blocks in the values, decides region by region where the darks and the dry paper go, paints faces and hands by hand, and compares the result with the source until it holds up. A good picture comes from those decisions, not from defaults, so there is no one-click mode.
  8. ## Examples
  9. Both examples ship with the skill, with their source pictures and the full painting files. Left: the source; right: the painting.
  10. ![a man in a moss-green cable cardigan, source and painting](docs/cardigan.jpg)
  11. ![a girl in a navy padded jacket and a blue-grey scarf, source and painting](docs/winter.jpg)
  12. Paint them yourself. The engine and the examples live in Markdown code blocks, so the plugin holds only text and images. Claude
  13. saves them the first time it paints in a project; by hand:
  14. 1. Make a folder (say `watercolour/`) and save the code block of each file in `skills/watercolour-brush/references/engine/`
  15. (`wash.md`, `regions.md`, `look.md`, `selftest.md`), unchanged, as `wash.py`, `regions.py`, `look.py` and `selftest.py` in it.
  16. 2. Install `numpy` and `opencv-python-headless` as their own pages say ([numpy](https://pypi.org/project/numpy/), [opencv-python-headless](https://pypi.org/project/opencv-python-headless/); the engine was tested with numpy 2.5.5
  17. and opencv-python-headless 5.1.0.95).
  18. 3. Copy an example's folder from `skills/watercolour-brush/references/examples/` (`cardigan/`, `winter/`) into `watercolour/examples/`,
  19. and save its code block (`cardigan.md`, `winter.md`) as `cardigan.py` or `winter.py` inside that copy. The persimmon has no data:
  20. save `persimmon.md`'s block as `watercolour/examples/persimmon/persimmon.py`.
  21. Then, from `watercolour/`:
  22. ```bash
  23. python3 wash.py examples/cardigan/cardigan.py examples/cardigan/out
  24. python3 wash.py examples/winter/winter.py examples/winter/out
  25. python3 wash.py examples/persimmon/persimmon.py out/ # a small persimmon, every kind of mark once
  26. python3 selftest.py
  27. ```
  28. ## Install
  29. **Claude Code (plugin):**
  30. ```
  31. /plugin marketplace add hanlianlu/watercolour-brush
  32. /plugin install watercolour-brush@watercolour-brush
  33. ```
  34. **As a plain skill:** copy `skills/watercolour-brush/` into `~/.claude/skills/` (Claude Code), or zip that folder and upload it under Customize → Skills on claude.ai (code execution must be on).
  35. Then ask Claude for something like *"paint this sketch as a watercolour portrait"* or *"add three more portraits that match these watercolours"*.
  36. ## What's inside
  37. ```
  38. skills/watercolour-brush/
  39. SKILL.md when to use it, the brush system, the painter's guide step by step
  40. references/engine/wash.md the engine, wash.py as one code block: paper, washes, brush sessions, knit, graphite, water effects
  41. references/engine/regions.md regions.py: proposes areas from a source picture and builds the underdrawing
  42. references/engine/look.md look.py: looking tools: values, edges, tones, differences against the source
  43. references/engine/selftest.md selftest.py: checks the engine end to end
  44. references/style.md the measured style rules (values, edges, faces, hair, ground)
  45. references/*.md starting values, dark cloth, winter clothes, the worked examples
  46. references/examples/ the two examples above: source, areas.json, finished pictures, and the painting file as a code block
  47. references/examples/persimmon/ a minimal drawings file, as a code block
  48. ```
  49. ## What it runs
  50. Only local Python 3 scripts, saved from the code blocks and run with `python3`. They need two libraries, [numpy](https://pypi.org/project/numpy/) and [opencv-python-headless](https://pypi.org/project/opencv-python-headless/), installed the way those pages describe (tested with numpy 2.5.5 and opencv-python-headless 5.1.0.95). The scripts read and write image files in the folders you give them. They make no network requests and send nothing anywhere; no hooks, nothing runs when the plugin is installed.
  51. ## License
  52. [MIT](LICENSE), code, docs and example pictures alike. Pictures you paint with it are yours.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.