Add light and shadow with proper hue shifting, one step at a time, so the sprite gains form without gaining the flat-luminance look that marks generated pixel art.

MITAuto-check passedGame Development

Install Shade

skills CLI
$ npx skills add with-pebbly/aseprite-ai-artist --skill shade -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install with-pebbly/aseprite-ai-artist shade --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/with-pebbly/aseprite-ai-artist.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/shade .claude/skills/shade && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
shade
GitHub stars
172
Token cost
~662 tokens
SKILL.md length
333 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

Add light and shadow with proper hue shifting, one step at a time, so the sprite gains form without gaining the flat-luminance look that marks generated pixel art.

  • Works in 7 steps: Fix the light direction and state it.… → Confirm the flat art is right first.… → One shadow step. Select the region away… → …
  • Flat art needs volume
  • SKILL.md covers The rule, Procedure, Ramps and Dithering, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Shade is an agent skill from with-pebbly/aseprite-ai-artist. Add light and shadow with proper hue shifting, one step at a time, so the sprite gains form without gaining the flat-luminance look that marks generated pixel art. Use when flat art needs volume.

Its SKILL.md is about 660 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Game Development, covering Sprites and pixel art. It works with Model Context Protocol. The repository describes itself as: Your coding agent paints pixel art in the Aseprite window you already have open. MCP server + skills for Claude Code, omp, Codex, Gemini CLI and Cursor — draws, looks at its…. The licence is MIT.

When your agent uses it

  • Flat art needs volume
  • Tasks that involve Sprites and pixel art

Example prompts

  • “/shade”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Fix the light direction and state it. Upper-left is the safe default. It
  2. Confirm the flat art is right first. look op preview. Shading a bad
  3. One shadow step. Select the region away from the light, then
  4. Look. look op="preview". Does it read as volume, or as a stain? A
  5. One light step, on the side facing the light: amount=0.2.
  6. Look again. Most sprites are finished here.
  7. Only if it needs it: a deep shadow (amount=-0.4) in occluded crevices,

What it can do on your machine

Read from SKILL.md and the folder at commit f51fe69. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Shade loads about 662 tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 333 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~50
When it runs · the whole SKILL.md, loaded when a task matches
~662

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from with-pebbly/aseprite-ai-artist at commit f51fe69, republished under its MIT licence (© with-pebbly). 333 words, ~662 tokens.

Download SKILL.mdSave it as .claude/skills/shade/SKILL.md (or your agent's skills folder).
name
shade
description
Add light and shadow with proper hue shifting, one step at a time, so the sprite gains form without gaining the flat-luminance look that marks generated pixel art. Use when flat art needs volume.
title
Shade a sprite

Shade a sprite

Flat shading — the same hue, darker — is the clearest signal that a sprite was made by moving a brightness slider. Real shading shifts hue.

The rule

  • Shadows rotate toward blue/purple and desaturate slightly.
  • Highlights rotate toward yellow/orange and saturate slightly.

recolor op shade implements this. Use it instead of choosing darker hex values yourself.

Procedure

  1. Fix the light direction and state it. Upper-left is the safe default. It does not move again — not across the sprite, not across animation frames.

  2. Confirm the flat art is right first. look op preview. Shading a bad silhouette wastes the effort.

  3. One shadow step. Select the region away from the light, then:

    select op="rect" rect={…}
    recolor op="shade" amount=-0.2 selectionOnly=true

    Or draw the shadow shape directly with draw if it needs to follow a form the selection tools cannot describe.

  4. Look. look op="preview". Does it read as volume, or as a stain? A shadow that follows the form's cross-section reads; one that follows the outline does not.

  5. One light step, on the side facing the light: amount=0.2.

  6. Look again. Most sprites are finished here.

  7. Only if it needs it: a deep shadow (amount=-0.4) in occluded crevices, a specular highlight of one or two pixels on the hardest material, or reflected light — a faint cool step on the shadow side's outer edge, which makes metal read as metal.

Ramps

If you will shade a material more than once, put its ramp in the palette:

palette op="ramp" base="#c04030" steps=5

Then draw with ramp entries directly. Reuse the darkest step across materials — it ties a sprite together and costs no palette slots.

Dithering

Only on 32px+ and only in large flat areas. Use bayer4, keep the two colours adjacent in a ramp, and stop if it reads as noise. See rules://02-shading-and-light.

Checks

  • Is the light in exactly one place?
  • Do the shadows hue-shift, or are they the same hue darker?
  • Any banding — long parallel stripes of adjacent steps?
  • Any semi-transparent pixels? (validate will tell you.)

rules://02-shading-and-light, rules://01-palette-and-color, rules://22-materials-hard, rules://23-materials-soft, rules://24-lighting-scenarios, rules://72-3d-forms.

© with-pebbly, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/shade of with-pebbly/aseprite-ai-artist.

Open the folder on GitHubat commit f51fe69

Compare with similar skills

Shade next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Shade compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shade this skillwith-pebbly/aseprite-ai-artist172—~662Automated safety check: PassMIT
Sprite Genaldegad/sprite-gen2.6k—~4.5kAutomated safety check: PassApache-2.0
Fal Assetsrehan-remade/universal-modder5.3k—~2kAutomated safety check: NotesMIT
Game Assetsglifxyz/glif-mcp-server212—~831Automated safety check: PassMIT
Scenario Game Assetsscenario-labs/skills913—~4.5kAutomated safety check: PassMIT
Game Art PipelinePersonalJarvis/PersonalJarvis141—~566Automated safety check: PassApache-2.0

Similar skills

  • Sprite Gen

    aldegad/sprite-gen

    Generates images and game sprites through GPT or Grok with guided provider choices, separate saved defaults, automatic cleanup and optional curation.

    2.6k GitHub stars~4.5k tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • Fal Assets

    rehan-remade/universal-modder

    Generate game assets with fal (fal.ai) through the fal MCP server, the um fal CLI (REST) or fal api.

    5.3k GitHub stars~2k tokensUpdated today
    Game DevelopmentAuto-check: notes
  • Game Assets

    glifxyz/glif-mcp-server

    Make art and media for a game you are building with Glif: character reference sheets, consistent characters, pixel-art sprite sheets with animation cycles, seamless and PBR textures, 3D models, item…

    212 GitHub stars~831 tokensUpdated today
    Game DevelopmentAuto-check passed
  • Scenario Game Assets

    scenario-labs/skills

    A skill your agent uses when creating game art through Scenario MCP: sprites, sprite sheets, icons, props, loot, tilesets and autotile terrain transitions, seamless tiles, isometric buildings…

    913 GitHub stars~4.5k tokensUpdated 2 days ago
    Game DevelopmentAuto-check passed
  • Game Art Pipeline

    PersonalJarvis/PersonalJarvis

    Develop or redesign Personal Jarvis world art, buildings, characters and 3D assets through an authored Blender reference scene, runtime review and controlled asset rollout.

    141 GitHub stars~566 tokensUpdated today
    Game DevelopmentAuto-check passed
  • Pixel Face

    Cotal-AI/Cotal

    Create or improve a 32×32 pixel-art persona face for the Frontier Faces demo (examples/04-frontier-faces/personas.mjs) — the animated agent avatars rendered by face-term.mjs / the browser…

    311 GitHub stars~1.5k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from with-pebbly/aseprite-ai-artist

All 14 skills in this repo
  • Animate

    with-pebbly/aseprite-ai-artist

    Build an idle, walk, run or attack cycle from key poses, set timing that reads as motion rather than a metronome, tag it, and review it as a filmstrip.

    172 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Draw

    with-pebbly/aseprite-ai-artist

    Draw a sprite from silhouette to finished pixels, in the order that catches mistakes while they are still cheap — block in, check the silhouette, shade, outline, verify.

    172 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Export

    with-pebbly/aseprite-ai-artist

    Produce the files an engine actually consumes — spritesheets with atlases, GIFs, scaled PNGs — with the tags and layout the target needs.

    172 GitHub stars~628 tokensUpdated today
    Auto-check passed
  • Fix

    with-pebbly/aseprite-ai-artist

    Change a sprite that already exists — the user's own work or your earlier output — without destroying what is already right.

    172 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • New

    with-pebbly/aseprite-ai-artist

    Create a new Aseprite document with the right canvas size, colour mode, palette and layer structure, so later work does not have to fight the setup.

    172 GitHub stars~555 tokensUpdated today
    Auto-check passed
  • Palette

    with-pebbly/aseprite-ai-artist

    Pick a palette that fits the request, build hue-shifted ramps, or clean up a sprite whose colours have sprawled.

    172 GitHub stars~795 tokensUpdated today
    Auto-check passed

Questions about Shade

What does Shade do?

Add light and shadow with proper hue shifting, one step at a time, so the sprite gains form without gaining the flat-luminance look that marks generated pixel art. Shade is an agent skill from with-pebbly/aseprite-ai-artist. Add light and shadow with proper hue shifting, one step at a time, so the sprite gains form without gaining the flat-luminance look that marks generated pixel art.

When should I use Shade?

Shade fits situations like: flat art needs volume; tasks that involve Sprites and pixel art.

How do I install Shade in Claude Code?

Run `npx skills add with-pebbly/aseprite-ai-artist --skill shade -a claude-code`. Or copy the skill folder (skills/shade in with-pebbly/aseprite-ai-artist) into .claude/skills/shade in your project. Claude Code loads it when a task matches its description.

How do I install Shade in Codex?

Run `npx skills add with-pebbly/aseprite-ai-artist --skill shade -a codex`. Or copy the skill folder (skills/shade in with-pebbly/aseprite-ai-artist) into .agents/skills/shade in your project. Codex loads it when a task matches its description.

Can I use Shade in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add with-pebbly/aseprite-ai-artist --skill shade -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/shade, .gemini/skills/shade, .github/skills/shade and .opencode/skills/shade in your project.

What does Shade need to run?

SKILL.md names no scripts, command-line tools or credentials: Shade is instructions for the agent only.

Does Shade access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Shade safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Shade use?

Shade is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Shade use?

About 662 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Shade?

Skills that share tags, products or a category with Shade: Sprite Gen (aldegad/sprite-gen, 2.6k stars), Fal Assets (rehan-remade/universal-modder, 5.3k stars), Game Assets (glifxyz/glif-mcp-server, 212 stars) and Scenario Game Assets (scenario-labs/skills, 913 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Shade?

with-pebbly (a GitHub organization) maintains it in with-pebbly/aseprite-ai-artist, which has 172 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 8, 2026.

Source: with-pebbly/aseprite-ai-artist on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.