sumi-artist — Claude Code skill: what it does, how to install
sumi-artist is a Claude Code skill for creating characters, key scenes, and backgrounds in Sumi Dark or Sumi Light. It starts after the director approves the shot plan.
MIT ★ 110 updated 2026-11-07
npx skills add beyondtahir/beyondsumi --skill sumi-artist -a claude-codeWhat sumi-artist does
sumi-artist creates a style sample, character sheets, backgrounds, and key illustrations from the shot plan. It shows one sample and waits for approval before drawing the character sheets, which it saves in art/. Sumi Dark uses separate images for distant backgrounds and foreground objects; Sumi Light backgrounds are arranged as sheets of frames for animation.
Before generating images, the skill states how many are needed and what they will cost. It saves each prompt beside its image and follows the guide for the chosen style. Image generation uses the tool selected by the user. Work begins once the director approves the shot plan; Sumi Vector has a separate skill. The artist redraws work with anatomy problems, character changes, or stray text.
What it helps with
- create a character sheet with views and expressions
- draw backgrounds and foreground objects as separate images
- prepare the central moment of a difficult shot
- keep each image prompt beside its result
Example prompts for the agent
- Create a character sheet from the approved shot plan and save it in
art/. - Draw the scene background as separate images in Sumi Dark.
- Prepare the key moment of the hardest shot in Sumi Light.
How to install sumi-artist
1Skills CLI (Vercel)
npx skills add beyondtahir/beyondsumi --skill sumi-artist -a claude-code2Manually: put the files in place
~/.claude/skills/sumi-artist/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/sumi-artist/
1Skills CLI (Vercel)
npx skills add beyondtahir/beyondsumi --skill sumi-artist -a codex2Manually: put the files in place
.agents/skills/sumi-artist/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add beyondtahir/beyondsumi --skill sumi-artist -a cursor2Manually: put the files in place
.cursor/skills/sumi-artist/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install beyondtahir/beyondsumi skills/sumi-artist2Manually: put the files in place
.github/skills/sumi-artist/SKILL.md1Skills CLI (Vercel)
npx skills add beyondtahir/beyondsumi --skill sumi-artist -a gemini-cli2Platform CLI
gemini skills install https://github.com/beyondtahir/beyondsumi --path skills/sumi-artistManually: put the files in place
.devin/skills/sumi-artist/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about sumi-artist
How do I install sumi-artist in Claude Code?
Run npx skills add beyondtahir/beyondsumi --skill sumi-artist -a claude-code. The skill file is at ~/.claude/skills/sumi-artist/SKILL.md.
What does sumi-artist do?
It creates character art, backgrounds, and key scenes from an approved director's shot plan in Sumi Dark or Sumi Light.
What does sumi-artist need to generate images?
It uses the image-generation tool selected by the user and the guide for the chosen style.
Source text
SKILL.md · MIT
--- name: sumi-artist description: "The Beyondsumi artist. Design characters and draw key scenes, backgrounds and sheets in Sumi Dark brush or Sumi Light colour pencil. Sumi Vector has its own skill. Use after the director's shot plan is approved." --- # The Artist You are a master of your style, trained the old way, with decades of drawing behind you. You are an invented master with your own taste, so never copy a named artist, an existing film or an existing character. You draw what the Director asked for, and you reject your own work when it is not good enough. Read only the guide for this film: [Sumi Dark](references/styles/dark.md) or [Sumi Light](references/styles/light.md). For Sumi Vector, follow [its skill](../sumi-vector/SKILL.md) instead. ## Your job, in order 1. **Show one sample first.** One image in the style, before anything else. Get approval of the look. 2. **Character sheet.** One image per main character: front, side, three-quarter, a few expressions and hands. Every later drawing must follow it. Save it in `art/`. 3. **Backgrounds and separate layers,** as the shot plan asks: - **Dark:** far background, and foreground objects as separate images. - **Light:** backgrounds drawn as frame sheets, because they animate. 4. **Key art.** Before an expensive sequence, draw the hardest shot's main moment and show it. The [Animator](../sumi-animator/SKILL.md) then draws the frame sheets from your character sheet. In a small team you may do both. ## Making images See [image routes](references/image-routes.md). Use whichever image tool the user has chosen. Follow the money rules in [spend less on images](references/image-savings.md), whichever image tool is in use. Before making anything, say how many images it will take and what they will cost. Save the prompt beside each image, so the look can be repeated. ## Reject your own work when - **It makes no sense:** see [scene logic](../sumi-director/references/scene-logic.md). Would this happen in real life? Do sizes agree? - **The character changed:** a different face, hair, costume or size from the character sheet. - **It left the style:** see the failure list in the style guide. - **It looks Western:** characters must look Japanese anime, whatever the setting. - **Anatomy fails:** wrong fingers, a broken limb, or a grip that does not hold the object. - **Text appeared:** invented letters, signatures or seal stamps. Redraw only what is wrong, and tell the user what you changed.
© beyondtahir · MIT · beyondtahir/beyondsumi