AI Skills

AI skills are instruction files that teach your coding agent how to use Masko. Once installed, your agent knows all the commands, workflows, credit costs, and best practices - no need to explain anything.

Install for Your Tool

# Copy the skill to your project
cp -r packages/skill/masko .claude/skills/masko

# Or create CLAUDE.md with Masko instructions at project root

Skill Content

Copy this into the file for your tool. For Claude Code, use the full SKILL.md from packages/skill/masko/. For other tools, use this condensed version:

# Masko - AI Mascot Generation

Generate mascots, animations, logos, and interactive canvases via the Masko API.

## Setup

MCP (recommended): claude mcp add --transport http masko "https://masko.ai/api/mcp"
CLI: npx @masko/cli login
API key: https://masko.ai/settings/developer

## CLI Commands

masko credits                    # Check balance
masko styles                     # List 38 art styles
masko mascots create --project ID --prompt "description" --style pixel
masko generate --mascot ID --type image --prompt "waving hello" --wait
masko generate --mascot ID --type animation --prompt "waving" --duration 4 --wait
masko generate --mascot ID --type animation --item ITEM_ID --prompt "breathing" --duration 4 --wait
masko generate --mascot ID --type edit --item ITEM_ID --prompt "add a santa hat" --wait
masko jobs get JOB_ID --wait

## Key Facts

- Animation from scratch: --type animation + --prompt creates image + animates in one step
- Animate existing: --item ITEM_ID auto-resolves the source image
- CDN URLs returned immediately, work as placeholders until ready
- Animations loop by default
- Credits: image=1, animation=5/sec, edit=1, logo=5
- Free: background removal, format conversion, size variants

## API (direct HTTP)

Base URL: https://api.masko.ai/v1
Auth: Authorization: Bearer masko_YOUR_API_KEY
Docs: https://masko.ai/llms-full.txt
OpenAPI: https://masko.ai/api/v1/openapi.json

In the API, mascots are called "collections" (POST /v1/collections).

Cursor-Specific Format

Cursor uses .mdc files with YAML frontmatter. Create .cursor/rules/masko.mdc:

---
description: "Use Masko to generate AI mascots, animations, and interactive canvases"
alwaysApply: false
---

(paste the skill content above)

Setting alwaysApply: false with a description means Cursor's agent will include these rules only when it thinks they're relevant (when you mention mascots, animations, etc.).

VS Code / Copilot Format

For path-specific instructions, create .github/instructions/masko.instructions.md:

---
applyTo: "**/*"
---

(paste the skill content above)

Or add to .github/copilot-instructions.md for always-on instructions.

Kiro Format

Kiro uses a steering directory. Create .kiro/steering/masko.md:

(paste the skill content above)

What the Skill Teaches

Once installed, your agent will know:

  • How to create a mascot from a text description and art style
  • How to generate images with prompts for poses and actions
  • How to animate from scratch or from an existing image
  • How to use the CLI with all flags and options
  • Credit costs so it checks balance before generating
  • CDN URL behavior so it embeds URLs immediately
  • Canvas workflows for interactive state machines
  • All 38 art styles available for generation