Install the skill

• Generate playable worlds from a premise or an image
• Create talk-to characters (stances, memory, voice)
• Embed worlds correctly (the two-token rule)
• Program a world’s state-machine graph — deterministically or in natural language
• Wire the /v1 endpoints and the @alakazamworld/embed SDK into your app

​

Prerequisites

• An Alakazam API key. Create an app at play.alakazam.gg/?view=developer, mint a secret key (start with sk_test_… — a free, mocked sandbox), and export it in the shell your agent inherits:
  # Add to your shell profile or .envrc — never commit it.
  export ALAKAZAM_SECRET_KEY="sk_test_..."
  
• A supported agent — Claude Code, Codex, Cursor, Windsurf, OpenCode, Gemini CLI, GitHub Copilot, and 50+ others read skill files.
• Node.js to run the npx skills installer (or install manually with curl).

​

Installation

​

Method 1 — Skills CLI (one command, every agent)

npx skills add -g https://docs.alakazam.gg/skill.md

​

Method 2 — Manual install with curl

# Project
mkdir -p .claude/skills/alakazam
curl -fsSL https://docs.alakazam.gg/skill.md -o .claude/skills/alakazam/SKILL.md

# Global (across all projects)
mkdir -p ~/.claude/skills/alakazam
curl -fsSL https://docs.alakazam.gg/skill.md -o ~/.claude/skills/alakazam/SKILL.md

# Project
mkdir -p .agents/skills/alakazam
curl -fsSL https://docs.alakazam.gg/skill.md -o .agents/skills/alakazam/SKILL.md

# Global
mkdir -p ~/.codex/skills/alakazam
curl -fsSL https://docs.alakazam.gg/skill.md -o ~/.codex/skills/alakazam/SKILL.md

# Project
mkdir -p .agents/skills/alakazam
curl -fsSL https://docs.alakazam.gg/skill.md -o .agents/skills/alakazam/SKILL.md

# Global
mkdir -p ~/.cursor/skills/alakazam
curl -fsSL https://docs.alakazam.gg/skill.md -o ~/.cursor/skills/alakazam/SKILL.md

mkdir -p .agents/skills/alakazam
curl -fsSL https://docs.alakazam.gg/skill.md -o .agents/skills/alakazam/SKILL.md

​

Verify it loaded

“Using Alakazam, how do I embed a world in a browser without exposing my secret key?”

​

Next steps