Turn a vague pixel-art request into a written brief — size, palette, view, light, outline style — and confirm it with the user before any pixel is drawn.

MITAuto-check passedGame Development

Install Brief

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

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

GitHub CLI
$ gh skill install with-pebbly/aseprite-ai-artist brief --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/brief .claude/skills/brief && 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
brief
GitHub stars
172
Token cost
~833 tokens
SKILL.md length
450 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

Turn a vague pixel-art request into a written brief — size, palette, view, light, outline style — and confirm it with the user before any pixel is drawn.

  • Works in 6 steps: preflight. If not ready, stop and tell… → Read what already exists. If a sprite is… → Draft the brief. Fill the table above… → …
  • The request is open-ended (make me a knight) rather than a specific edit
  • SKILL.md covers What you need to know, Procedure, Then and Related
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Brief is an agent skill from with-pebbly/aseprite-ai-artist. Turn a vague pixel-art request into a written brief — size, palette, view, light, outline style — and confirm it with the user before any pixel is drawn. Use when the request is open-ended ("make me a knight") rather than a specific edit.

Its SKILL.md is about 830 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

  • The request is open-ended (make me a knight) rather than a specific edit
  • Tasks that involve Sprites and pixel art

Example prompts

  • “make me a knight”
  • “/brief”

Workflow steps

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

  1. preflight. If not ready, stop and tell the user — nothing below works
  2. Read what already exists. If a sprite is open, sprite_info it. The
  3. Draft the brief. Fill the table above from what the user said plus the
  4. Put it to the user in one message, as decisions rather than questions
  5. Ask only what genuinely blocks you. If the sprite is for a specific game
  6. Record the brief in your working notes and hold to it. Every later

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

Brief loads about 833 tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 450 words of instructions outside code blocks.

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

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). 450 words, ~833 tokens.

Download SKILL.mdSave it as .claude/skills/brief/SKILL.md (or your agent's skills folder).
name
brief
description
Turn a vague pixel-art request into a written brief — size, palette, view, light, outline style — and confirm it with the user before any pixel is drawn. Use when the request is open-ended ("make me a knight") rather than a specific edit.
title
Plan a sprite before drawing it

Plan a sprite before drawing it

A request like "draw me a knight sprite" contains none of the decisions that determine whether the result is usable. Guessing them and drawing anyway wastes the user's time and yours. Five questions, one answer, then draw.

What you need to know

DecisionWhy it cannot be deferredReasonable default
Canvas sizeDetermines how much can be shown at all32×32 for a character
PaletteChoosing it later means repaintingPICO-8 (16 colours)
ViewSide-on, top-down and 3⁄4 are different drawings3⁄4
Light directionMust be fixed before any shadingUpper-left
OutlineChanges every edge in the spriteSelective, dark-coloured
DestinationA game engine wants tags and a sheetAsk

Procedure

  1. preflight. If not ready, stop and tell the user — nothing below works without a live Aseprite.

  2. Read what already exists. If a sprite is open, sprite_info it. The user's existing canvas size and palette usually answer half the questions, and matching an existing project's style is almost always what they want.

  3. Draft the brief. Fill the table above from what the user said plus the defaults. Do not ask about things you can reasonably infer — "a Game Boy style knight" has already told you the palette and the size range.

  4. Put it to the user in one message, as decisions rather than questions:

    32×32, PICO-8 palette, 3⁄4 view, light from upper-left, selective dark outline. Knight in plate with a sword, facing camera. Say if any of that is wrong — otherwise I'll start.

    One round trip, not five. If they said nothing about a detail, they probably do not care about it.

    When the request is something new — a character, a prop, an animation — aseprite:concept follows, and its offer goes in this same message: the decisions above, then the image-model prompt in one code block, then the choice between sending references and continuing without. The user answers once. If they correct a decision, fix the prompt to match before they copy it.

  5. Ask only what genuinely blocks you. If the sprite is for a specific game and you do not know its tile size, that one is worth asking. Light direction is not.

  6. Record the brief in your working notes and hold to it. Every later decision either follows from the brief or is a mistake.

Show full SKILL.md (62 more words)Show less

Then

aseprite:concept for anything drawn from scratch — its offer is already in the message above. Then aseprite:new to create the document, or aseprite:draw if a suitable sprite is already open.

rules://00-core-principles for what the sizes buy you. rules://03-silhouette-and-form for view and proportion. rules://30-proportions-by-size and rules://14-readability-and-scale for what each canvas size can hold; rules://90-platform-styles when the user names a console or era.

© 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/brief of with-pebbly/aseprite-ai-artist.

Open the folder on GitHubat commit f51fe69

Compare with similar skills

Brief 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.

Brief compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Brief this skillwith-pebbly/aseprite-ai-artist172—~833Automated 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 today
    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 yesterday
    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 Brief

What does Brief do?

Turn a vague pixel-art request into a written brief — size, palette, view, light, outline style — and confirm it with the user before any pixel is drawn. Brief is an agent skill from with-pebbly/aseprite-ai-artist. Turn a vague pixel-art request into a written brief — size, palette, view, light, outline style — and confirm it with the user before any pixel is drawn.

When should I use Brief?

Brief fits situations like: the request is open-ended (make me a knight) rather than a specific edit; tasks that involve Sprites and pixel art.

How do I install Brief in Claude Code?

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

How do I install Brief in Codex?

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

Can I use Brief 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 brief -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/brief, .gemini/skills/brief, .github/skills/brief and .opencode/skills/brief in your project.

What does Brief need to run?

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

Does Brief 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 Brief 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 Brief use?

Brief 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 Brief use?

About 833 tokens (SKILL.md is roughly 3.3k 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 Brief?

Skills that share tags, products or a category with Brief: 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 Brief?

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.