scenario
Use when connecting an AI agent to Scenario (scenario.com) through MCP, or when a task involves generating images, video, 3D, audio, sprites, textures, or game assets.
Install / Use
npx skills add scenario-labs/skills --skill scenarioInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OtherSupported Platforms
Our assessment of scenario
scenario scores 86/100 on our quality scale, 179th of 329 Other skills we index.
Its SKILL.md is 18 KB long, well organised into 8 sections and no code examples: a thorough specification that gives an agent plenty to work with.
With 1,048 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 29 days ago, so scenario is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-10. Automated pattern scan on 2026-11-10. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
scenario compared with similar skills
All 4 of these similar skills score higher than scenario; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| scenario (this skill)by scenario-labs | 86 | 1.0k | 29d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
Frequently asked questions
- How do I install scenario?
- Run
npx skills add scenario-labs/skills --skill scenario. The install tabs above show the steps for each supported agent. - Which AI agents does scenario work with?
- It is written for Claude Code and Cursor, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is scenario safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is scenario still maintained?
- The repository was last updated 29 days ago, so scenario is actively maintained.
Skill content
View source on GitHubname: scenario description: Use when connecting an AI agent to Scenario (scenario.com) through MCP, or when a task involves generating images, video, 3D, audio, sprites, textures, or game assets. Also when picking a Scenario model, running a LoRA, refining a generation prompt, uploading reference images, waiting on generation jobs, checking credits or quota, hitting Scenario auth, scope, or Forbidden errors, or setting up mcp.scenario.com in Claude Code, Cursor, VSCode, or another agent. license: MIT
Scenario
Overview
Scenario generates images, video, 3D, and audio across 500+ models, plus custom training.
Setup
- Endpoint:
https://mcp.scenario.com/mcp(Streamable HTTP). Prefer OAuth: no credentials pass through the conversation. - Client config, headless API-key setup, and per-client re-authentication: references/setup.md.
- Never ask an agent to collect, encode, or echo a secret.
- A previously authenticated connection now failing: re-authenticate before debugging.
diagnostics_runnames the layer (auth,tenant-scope,api-unreachable, orhealthy).
Two tool kinds:
- Direct: the loop below, plus
asset_get,job_get,jobs_list, andmodels_list.?toolsets=fullexposes everything. - Catalog: the rest (collections, tagging, analysis, training, members, keys).
scenario_tools_searchtakes onlyquery(tool name or keywords) andlimit; returns schema and lane.scenario_tool_execute_read/write/deletetake a requirednameandparameters, which holds every input, scope ids anddry_runincluded:{"name": "collection_add_assets", "parameters": {"team_id": "…", "project_id": "…", "collection_id": "…", "asset_ids": ["…"]}}.plan_generationtakes onlydescription.- Direct tools take scope, and
model_runitsdry_run, at top level. Never route them through an executor. - The executor drops a misplaced key silently:
argumentssurfaces as a false scope error, and a top-leveldry_runruns the job, billed. - The lane is the result's own
permission, not the verb:asset_analyzeis write-class, since it starts a billed job.
Scope first
- Resolve scope first, then pass
team_idandproject_idon every call. - A team is the organization, the company or studio account; its projects sit inside it. "My organization" or "my studio" names the team.
teams_listreturns the teams with their projects.projects_listneeds ateam_id.- Confirm the pair with the user: a guess writes into someone else's project. Unattended, take the pair from the task; if it names none, stop and list the choices.
- The server fills scope only for read-only tools with one candidate, so an omission fails once a second team or project appears. The error names the wrong half.
Quick reference
| Step | Tool | Notes |
| ----------------- | ---------------------------------------- | ---------------------------------------------------------------------------- |
| Resolve scope | teams_list, then projects_list | Once per session; pass the ids on every call |
| Find a model | search or recommend | Free; recommend for a capability, search for a name |
| Get the schema | model_schema_get | Always before model_run; check runs_as and caps |
| Generate | model_run | Schema-conformant parameters; dry_run for cost |
| Wait | jobs_wait | Whenever model_run returns a job_id without assets; never loop job_get |
| View / save | asset_display / asset_download | Never paste raw asset URLs; format converts images, meshes |
| Inspect an asset | asset_get | Free; dimensions, duration, firstFrame / lastFrame ids |
| Upload inputs | upload_asset + upload_asset_complete | Local files become asset_ids |
| Refine a prompt | prompt_spark | Advisory rewrite; needs model_id |
| Quota / debugging | usage, diagnostics_run | CU consumption; diagnose MCP prompt |
| Saved preferences | memory_recall | OAuth only; before generating in a project, again after switching |
- Multi-step request ("product video with voiceover", "concept to 3D"): catalog
plan_generation(read lane). Plain words indescription, ordered steps out, each naming a tool and an optional model hint. It runs nothing. A single step goes torecommend. - Stated preference ("always 9:16"): catalog
memory_set(delete lane),scopeproject_user_memory(user_memoryacross projects). It replaces the whole layer:memory_getand merge first.
Worked example
Generating a stylized game prop image:
- Discover the model:
recommendwith the user's own words aspromptfor a capability. Unscoped, it ranks models the team cannot run.searchrequirestarget(models,assets,workflows); for a known name:target="models",query="<model name>",public=true. It ranks by keyword and itsfiltershold no capability key, so a capability-worded query can rank the wrong output type first.- The user's own trained models: omit
publiconsearch(it has no private flag); passinclude_private_models: trueonrecommend. - Re-discover ids each time: availability differs per team.
model_schema_geton the pick: exact field names, types, required flags, defaults, and caps.- Overrunning a cap such as the prompt's
max_lengthis a 400, never a trim. - File fields take asset ids, even when named
...Url. cost_impact: trueflags the fields that move the price.
- Overrunning a cap such as the prompt's
- If the schema carries
runs_as("lora"or"composition"), never send that model's id tomodel_run. Itsrun_with.required_argumentsholds the real call:model_idthere is the base model, and itsparameters(thelorasormodelIdwiring) merge with your inputs from the same schema.required_argumentsalone discards your prompt. - Optional:
prompt_sparkrewrites a thin prompt into an on-model one. Pass the discovered id (a LoRA's own, not its base) and the draftprompt. Skip deliberate prompts. model_runwithmodel_idand schema-conformantparameters.- Unless the user says cost does not matter, price first with
dry_run: true, top level besidemodel_id. No job is created, andcreativeUnitsCostis this exact payload's price. - A
recommendquote assumes defaults;cost_impactfields move the real number. - Run: inline assets (
status: success) need no wait; otherwise passjob_idtojobs_wait. - Unfinished status:
in_progressafter a timed-out wait; withwait=false,queued,in-progress, orwarming-up. All needjobs_wait. - A 429: stop launching and find its class under Errors and recovery before the next call. Re-sending the same payload at once never clears it.
- Unless the user says cost does not matter, price first with
jobs_waitwithjob_ids=[...](up to 32).- Each completed row carries
assetIdsandcuCost: nojob_getfollow-up. - On timeout (
in_progress), re-call withpending_job_idsasjob_ids; never re-run or cancel. No timeout argument exists. - Failed jobs are reimbursed, except xAI generations stopped by moderation.
- Each completed row carries
asset_displayshows the asset inline. Itsformatpicks the rendering:display(default): inline image, links, viewer data; does not disable the host widget.viewer: lighter payload for hosts rendering the interactive widget.json,markdown: metadata and links.
asset_downloadreturns a file URL, one call per asset; save it withcurl -L(it may redirect).formatconverts images (png,webp,jpg;gifkeeps an animated GIF animated, while thepngdefault flattens it to one frame) and meshes (glb,fbx,obj). Omit it for video and audio, or it fails with 400Invalid target format.curlfailing withhost_not_allowedorCONNECT tunnel failed, response 403while MCP calls work points at the host's egress policy. A CDN 403 alone does not: fetch a fresh URL first.- Sandbox network access names the setting. On some hosts it is an organization allowlist the user may not control.
- Meanwhile hand over
asset_display'sapp_url. The user downloads there and, for a mesh, picks an export formatasset_downloaddoes not offer. - The signed URL expires: a last resort, never the deliverable.
Local inputs go up with upload_asset:
- Always
file_name,content_type, andkind(image,audio,video,3d), plus exactly one offile_sizeordata. Without either it fails withEither 'file_size' … or 'data' is required. - Prefer
file_size(exact bytes on disk) and omitdata; the reply carries presigned part URLs andinstructions. - PUT each part's raw bytes to its URL with no added headers: a checksum header makes the store
answer 403. Check every PUT returned 200, then
upload_asset_completewith theupload_id. - Inline base64
dataonly under 100KB, and only when no shell can PUT parts. It returns the asset directly, with no complete step; a larger file is rejected, naming the cap. - Both calls take scope and nothing else: no parts list, no etags.
- Inline
datais decoded insideupload_asset: a decode error there (libpng read error,Corrupt JPEG data,unable to read pixels) means the base64 string broke, not the file.- The agent retypes every character of
data; a 57K-character string broke that way. - Re-sending it repeats the error. With a shell, switch to the
file_sizepath, even when the user asked for inline, and say why.
- The agent retypes every character of
- On the
file_sizepath the server decodes at completion:Upload upl_… failed:withCorrupt JPEG data,premature end of data segment,bad Huffman code, orlibpng read errormeans it could not.- Check for a corrupt source, a truncated or re-encoded body, a missing part, or a wrong
file_size. - Confirm the local file opens under its declared content type, then start over with a fresh
upload_assetand raw PUTs. Never re-complete the sameupload_id.
- Check for a corrupt source, a truncated or re-encoded body, a missing part, or a wrong
- A phone's HEIC photo uploads as is (
content_type: "image/heic"): do not convert it.Unhandled image formatlists whatkind: "image"accepts; convert any other type locally. - Without a shell, the user uploads at app.scenario.com; continue from the asset id.
Filing is part of delivering, not a tidy-up:
collection_createtakes a name and the scope pair only.asset_idssent there is silently ignored, so adding is always a second call:collection_add_assets.- It accepts any number of ids, batches by 49, and skips duplicates. Results separate
already_present_asset_idsfromadded_asset_ids. - After a failure, resend the whole list: duplicates are skipped.
- Confirm from that reply:
searchfilters={"collection_ids": [...]}lags on a fresh write. asset_add_tagsis additive, oneasset_idper call. A tag the asset already carries returns 400Duplicated tag: readtagsviaassets_get_bulkfirst and send only the missing ones.
Reusable templates and reference content follow the shared asset lifecycle: resolve existing assets, stage new versions, publish only through a supported operation, and verify public ac
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
