remix-add-sprite
Generate and add sprites to a Remix game
How do I install this agent skill?
npx skills add https://github.com/farworld-labs/remix-skills --skill remix-add-spriteIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is safe. It facilitates sprite sheet generation for the Remix game platform using an MCP tool. It correctly manages project configuration files and follows secure practices for handling API keys via environment variables.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
Add Sprite to Game Workflow
Overview
This skill guides you through generating sprite sheets for canvas-based games on the Remix platform.
Prerequisites
- The game HTML file must already exist (follow the game-creation workflow first if starting from scratch).
- A game must be created on the Remix platform (you need a game ID).
- The
REMIX_API_KEYenvironment variable must be set.
Steps
1. Check for Existing Game ID
Use gameId from task context or prior tool results when available.
Otherwise, read the nearest .remix-cli.json. Older projects may still use
.remix-mcp.json. If either contains a gameId, reuse it.
Only if none of those sources contain a gameId should you follow the
upload-game workflow to create one.
2. Generate the Sprite Sheet
Prefer MCP generateSpriteSheet:
generateSpriteSheet({
gameId: "<your-game-id>",
prompt: "a pixel-art knight walking, side view, 2D game character",
gridSize: 4
})
The response includes hosted spriteUrl, transparentSpriteUrl, grid metadata,
and any warnings. If you need to write REST calls instead, confirm the exact
schema from the OpenAPI spec first.
3. Integrate the Sprite Sheet into the Game
Use the returned URL with canvas drawImage to render individual frames:
const sprite = new Image();
sprite.src = "https://returned-sprite-url.png";
const frameWidth = 64; // width of a single frame
const frameHeight = 64; // height of a single frame
const totalFrames = 4;
let currentFrame = 0;
sprite.onload = () => {
function animate() {
ctx.clearRect(0, 0, canvas.width, canvas.height);
// Draw the current frame from the sprite sheet
ctx.drawImage(
sprite,
currentFrame * frameWidth, 0, // source x, y in the sprite sheet
frameWidth, frameHeight, // source width, height
player.x, player.y, // destination x, y on canvas
frameWidth, frameHeight // destination width, height
);
currentFrame = (currentFrame + 1) % totalFrames;
requestAnimationFrame(animate);
}
animate();
};
Use transparentSpriteUrl when you need the sprite rendered over other
game elements without a background.
Tips
- Be specific about frame count and action. "4-frame walk cycle" is better than "walking character".
- Specify art style. Include "pixel-art", "hand-drawn", "flat vector", etc. in your prompt.
- Frame layout follows the returned grid metadata. Do not assume a single
horizontal strip; compute frame width and height from the generated sheet and
requested
gridSize. - Use
transparentSpriteUrlfor in-game sprites that need to overlay backgrounds or other elements. - Preload before gameplay. Wait for
onloadbefore starting the game loop.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/farworld-labs/remix-skills/remix-add-sprite">View remix-add-sprite on skillZs</a>