Docs / MCP
The Artifex Studio Agent Skill
5 minute read · Updated 2026-09-12
Connecting the MCP server gives an agent the tools. The skill gives it the judgement: which tool to reach for, how to poll a render instead of claiming it finished, and when to stop and ask before spending credits. One bundle, built to the open Agent Skills standard — it works in Claude, ChatGPT and Codex, Cursor, Gemini CLI and every other compatible client, unmodified.
Why a skill on top of the tools
Tool descriptions tell a model what a tool accepts. They do not tell it that a cover image must be previewed and accepted before it is saved, that a job id is not a result, or that the run_*_inline pipelines are the right ones to use on a multi-artist workspace.
That knowledge is what the skill carries. It loads only when the conversation is actually about Artifex Studio, so it costs nothing the rest of the time.
- The sync-versus-job distinction, and a polling loop that reports progress instead of going silent.
- The two-step cover art accept, so nothing is saved without the user seeing it.
- Which pipeline tool fits which request — studio, lyric, quick video, clip assembly, YouTube.
- Credit awareness: confirm before launching several renders in a row.
- The failure modes, and what each error actually means.
One skill, every agent
Agent Skills is an open standard: a folder containing a SKILL.md file with YAML frontmatter and markdown instructions. It was developed by Anthropic, released as an open specification in December 2025, and has since been adopted across the ecosystem — ChatGPT and Codex, Cursor, Gemini CLI, GitHub Copilot and VS Code, JetBrains Junie, Goose, Kiro, Mistral Vibe and dozens more.
So there is no Claude version and ChatGPT version of this skill. There is one bundle. The same bytes load in any compatible client, and agents load it progressively — name and description at startup, the full instructions only once a task matches.
Install it
- 01
Connect the MCP server first
The skill drives the tools; without the connection it has nothing to call. See Connect a client.
- 02
Download and unzip into your agent’s skills directory
The archive contains a single artifex-studio/ folder, so unzip it directly into the directory your client scans.
Most agents — the shared .agents convention curl -LO https://app.artifexstudio.app/downloads/artifex-studio-skill.zip mkdir -p ~/.agents/skills unzip artifex-studio-skill.zip -d ~/.agents/skills/ - 03
On Claude Code, use its own directory
Claude Code reads ~/.claude/skills/ and does not scan ~/.agents/skills/. Everything else about the bundle is the same.
bash mkdir -p ~/.claude/skills unzip artifex-studio-skill.zip -d ~/.claude/skills/ - 04
Confirm your agent can see it
The skill announces itself when a conversation mentions Artifex Studio, lyric videos, cover art, or a render job.
text "Using Artifex Studio, find my song 'Midnight' and make a lyric video from the chorus."
Where each client looks
| Client | Personal (all projects) | Project-scoped |
|---|---|---|
| Claude Code / Claude | ~/.claude/skills/ | .claude/skills/ |
| ChatGPT & Codex | ~/.agents/skills/ | .agents/skills/ |
| Cursor | ~/.agents/skills/ or ~/.cursor/skills/ | .agents/skills/ or .cursor/skills/ |
| Gemini CLI | ~/.agents/skills/ or ~/.gemini/skills/ | .agents/skills/ or .gemini/skills/ |
| Everything else | See the client list at agentskills.io/clients | — |
~/.agents/skills/ is the convention the ecosystem is converging on — Codex, Cursor and Gemini CLI all read it, and Cursor additionally falls back to ~/.claude/skills/ for compatibility. Claude Code is the notable exception: it reads only its own directory.
Project-scoped installs put the skill in the repository instead of your home directory, so it travels with the project and every collaborator gets it.
What is in the bundle
| File | Contents |
|---|---|
| artifex-studio/SKILL.md | The instructions themselves — workflows, rules, failure modes. |
| artifex-studio/references/tool-reference.md | Every tool with its mode and description, generated from the live registry. |
You can read SKILL.md before installing anything — it is served as plain markdown, and it is short enough to skim in a couple of minutes.
curl -s https://app.artifexstudio.app/downloads/SKILL.md | lessIf your agent has no skill support
SKILL.md is plain markdown with a small YAML header. If you are building on a framework with no skills concept, paste the body into your system prompt and ship the tool reference alongside it — nothing in the guidance depends on a particular vendor.
The frontmatter carries a compatibility note recording what the skill needs: a connected Artifex Studio MCP server and a Pro or Studio workspace token.
Keep going