scenario-maya-fx
Use when a Maya task involves simulation or procedural effects: nCloth or Nucleus (a cape, skirt, flag or garment on an animated character, cloth through the body, jittery or stretchy cloth), nParticles, Bifrost graphs (Aero smoke, dust puff, mist, fire, liquids, MPM cloth, snow, sand, "Bifrost smok…
Install / Use
npx skills add scenario-labs/skills --skill scenario-maya-fxInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OtherSupported Platforms
Tags
Our assessment of scenario-maya-fx
scenario-maya-fx scores 86/100 on our quality scale, 193rd of 354 Other skills we index.
Its SKILL.md is 21 KB long, well organised into 10 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 35 days ago, so scenario-maya-fx 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.
Automated pattern scan on 2026-11-20. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
scenario-maya-fx compared with similar skills
All 4 of these similar skills score higher than scenario-maya-fx; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| scenario-maya-fx (this skill)by scenario-labs | 86 | 1.0k | 35d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 2mo ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 2mo ago | SKILL.md |
| prospectingby coreyhaines31 | 100 | 60.1k | 11d ago | SKILL.md |
| ad-creativeby coreyhaines31 | 100 | 60.1k | 11d ago | SKILL.md |
Frequently asked questions
- How do I install scenario-maya-fx?
- Run
npx skills add scenario-labs/skills --skill scenario-maya-fx. The install tabs above show the steps for each supported agent. - Which AI agents does scenario-maya-fx work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is scenario-maya-fx safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. 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-maya-fx still maintained?
- The repository was last updated 35 days ago, so scenario-maya-fx is actively maintained.
Skill content
View source on GitHubname: scenario-maya-fx description: 'Use when a Maya task involves simulation or procedural effects: nCloth or Nucleus (a cape, skirt, flag or garment on an animated character, cloth through the body, jittery or stretchy cloth), nParticles, Bifrost graphs (Aero smoke, dust puff, mist, fire, liquids, MPM cloth, snow, sand, "Bifrost smoke"), MASH scattering or motion graphics, sim caches (nCache, Alembic, OpenVDB, file_cache, USD) or FX delivered to lighting or a game engine (flipbook sprites).' license: MIT
Maya FX (Nucleus, Bifrost, MASH, caches)
An expert FX TD fixes scale and inputs before touching a knob, changes few settings one at a time,
never judges a live solve, and proves the result on the cache in numbers (penetration, stretch,
pops, convergence) and in renders from the shot camera. If a sibling skill named here is missing
from your available skills, load it with skill_get (Scenario MCP) or ask the user to install it
(https://github.com/scenario-labs/skills#install); unattended, proceed from tool schemas and flag
the gap.
REQUIRED BACKGROUND: scenario-maya-expert (execution channel, review loop, 2027 version traps).
Status (2026-09-24): Maya 2027 is not installed. The pure-Python layer of
scripts/mx_fx.py passed offline (tests/code/maya-fx/test_fx_offline.py);
every Maya call is not yet run in Maya; names marked [verify] are answered by
job_00_fx_probe.py (python3 tests/code/maya-fx/run_all.py).
Stance (the expert delta)
- Scale before anything. Nucleus and Bifrost compute in meters whatever Maya's unit: Space Scale
and
scene_units_in_meters0.01 in a cm scene, or a 182 cm character is 182 m to the solver (2027 Help; SARKAMARI [00:29:22]; Stamatelos [00:30:21]). MPMdetail_sizeis in meters, so a unit change silently changes resolution (Gast [00:07:29]). - Never simulate the production mesh. Duplicate the skinned body and garment, drive the duplicates with a blend shape at weight 1, hide the originals (SARKAMARI [00:10:04]).
- Give the solver a clean start. Hold 25 frames, blend 25 frames into the first pose, action at 0, Nucleus start -50 (SARKAMARI [00:05:26]); Julan: A-pose at 0, walk by 24.
- Substeps before stiffness. Collision iterations below the substep count do nothing; high stretch resistance at low substeps cannot converge (2027 Help, Tips). SARKAMARI's remaining penetration vanished at 30 substeps and 35 iterations, with Space Scale moved to 0.25 in the same pass [00:29:22] [00:29:57].
- Cache, judge the cache, render the cache. nCache before every playblast; the render scene holds Alembics only (SARKAMARI [00:19:32], [00:40:07]).
- Bifrost fails silently. Unpulled outputs are never computed, empty arrays are valid data, mismatched arrays truncate (Jason E3aOt5wuvoo [00:22:49]; Nordenstam [00:38:11]; graph doc). A sim solves only forward from its own start frame: default 1, and it must exist in the timeline (sim guide; Nordenstam [00:56:23]).
- Do not simulate what you do not need. Start a snowball at the collider with its impact velocity (Gast [00:55:18]); layer garments through Alembic colliders (SARKAMARI [00:32:06]); coarse background sources (Stamatelos [00:21:25]).
- One change per run, logged (Jason cd3HgvM8sXg [00:21:43]);
mx_fx.set_attrsreturns the log.
Establish first
| Input | Why it changes the plan | Default when silent |
| ----------------------------- | ---------------------------------------------------------------- | -------------------------------------------------------- |
| Shot range, fps, action start | pre-roll, cache range, handles | 24 fps, pre-roll 50 frames before the action |
| Character delivery | sim duplicates need a skinned or cached body | referenced rig or Alembic from scenario-maya-animation |
| Linear unit and real size | solver scale | cm, real size checked with mx_fx.scale_report |
| Destination | film (Arnold, VDB, Alembic) vs game (sprites, baked meshes, USD) | Arnold film |
| Camera and motion blur | what penetration is acceptable | shot camera, blur on |
| Fabric or material | preset, stiffness | cape: heavy denim values [added pick]; dust: Aero smooth |
| Budget | substeps, resolution, sim time per frame | first pass 10/12, detail 0.1; final 30/35 |
Workflow
-
Scale and inputs.
mx_fx.scale_report(meshes, expected_size_m=...); if the model is not real size, fix the asset (Julan [00:02:02]). Record any deliberate non-physical scale (SARKAMARI's 0.25 on a 182 cm character) withart_choice=True. GATE: no error line. -
Pick the system (options keyed to the brief):
| Effect | Default | Alternative and when | | ------------------------------------------ | -------------------- | ---------------------------------------------------------------------------------------------------------------------- | | Cape, garment on a character | nCloth | Bifrost MPM cloth when it must tear, live in a Bifrost graph, or go to a game via USD (Jason hmuWr2nWSms, yo6y7cANfX0) | | Dust puff, smoke, mist | Bifrost Aero | add MPM sand or snow for dirt clumps; nParticles for grit (doc-level only) | | Snow, sand, mud impact | MPM granular | none in the sources | | Scatter, crowds of copies, motion graphics | MASH (Repro) | Instancer for speed; Bifrost
scatter_pointsfor USD point instancers | | Liquids |basic_liquid_graph| legacy Bifrost Fluids is gone | -
Prepare cloth inputs. Topology gate
mx_fx.cloth_topology_verdict(mx_audit.audit(garment), expected_border_loops=1): evenly spaced quads (cross links need quads), manifold, single-sided, holes sealed (SARKAMARI [00:03:05]). Pre-rollmx_fx.add_preroll(ctrls, action_start, rest=bind_pose); duplicates at the bind frame withmx_fx.sim_duplicate. GATE: verdict clean, the duplicate follows the original within 0.01 cm. -
Build.
- nCloth:
mx_fx.build_cloth_rig(garment_SIM, body_SIM, action_start, preset=...): one nucleus, Space Scale for the unit, start at the pre-roll, first pass substeps 10 / iterations 12, preset values, thin cloth and collider. Pin a cape collar with an input-attract lock map (value 1 plus Input Attract Method "Lock values of 1.0 or greater", Collide Last Threshold 1.0, [added] recipe from the doc) or Point to Surface with Exclude Collisions (SARKAMARI [00:23:40]), members on the input mesh (output-mesh members risk a DG loop, doc;point_to_surface(..., cloth=)rewrites them). GATE:rig["verdict"]has no error. - Bifrost: start from
basic_*_graphand Explode (Stamatelos [00:39:07]); script it withmx_fx.BifrostGraph(logs every VNN call) or reuse a GUI Echo All Commands log. Hide what you bring in (Jason). Open or flat emitters (ring, ground patch) need Shell, closed ones Solid (Stamatelos [00:10:40]). Set the sim's start frame. GATE:aero_source_verdict(...)onemitter_facts(mesh)andsim_range_verdict(...)clean; every output pulled; point or voxel count above 0 on every frame. - MASH:
mx_fx.mash_network(sources, geometry="Repro")[verify MASH.api]; unit-size sources (Waters). GATE:mx_fx.mash_cache_reasons(mx_fx.mash_inventory(waiter))read.
- nCloth:
-
First pass cheap, then cache. Low resolution (Aero detail 0.1, cloth first pass), frames evaluated in order from the start frame (
mx_fx.run_sim,step_frames), every frame played in the GUI. After ageo_detail_sizeortime_step_sizechange, or a compound created or exploded, re-run from the start (sim guide). GATE: nothing non-finite, no empty frame. -
Measure and look.
rep = mx_fx.sim_report(cloth_out, body_SIM, start, end, action_start=..., thickness=...),rep["convergence"] = mx_fx.convergence_test(...),mx_fx.sim_verdict(rep, budget_spf=...)(adds the doc's Timing Output gate: solve seconds per frame against the brief). Then look: headlessmx_review.review([cloth_out, body_SIM], out, views=("side","back","threequarter"), modes=("clay",), focus=fixed)at the action start, the peak and the last frame; GUImx_review.playblastfrom the shot camera; volumes withmx_fx.volume_review(Arnold, tricubic). Judge withreferences/critique.md. -
Triage in this order (never stiffen first): scale; start state (pre-roll, Push Out, Crossover Push with Trapped Check); substeps with iterations above; thickness down, Self Collide Width Scale up; stretch and compression together (SARKAMARI [00:24:50]); Bend Solver High Quality for flips; Collide Last Threshold 1.0 when attract or rigidity drags cloth through; lower Strength on popping constraints; "frame change too large" means play from the start or cache (2027 Help). Leftover pokes: a sculpted corrective on the cached mesh, or accepted under blur (SARKAMARI [00:37:12]). Aero detail: 2027 sharpening (
aero_refinement_settings, low amount), adaptivity bounds, orpost_refine_aeroon the cache (frames in order, original sources and colliders) before lowering detail size everywhere (sim guide). -
Final cache and deliver. Final pass settings, nCache from the nucleus start (
ncache_verdict: mcc stops at 2 GB, use mcx; positions only, so the cloth transform must stay still), disable the nucleus, Alembic of cloth and body over the shot range with UVs and color sets (mx_fx.alembic_export); Bifrostfile_cachewith only the properties the renderer needs; a cache-only render scene. GATE:mx_fx.alembic_checkandfile_sequence_reportclean, a look at the cache.
Numbers
| Value | Relative to | Source |
| --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | --------------------- |
| Space Scale, scene_units_in_meters 0.01 | cm scene | 2027 Help; Stamatelos |
| Nucleus 3 / 4 (presets), 10 / 12 first pass, 30 / 35 final | substeps / max collision iterations | doc; SARKAMARI |
| Pre-roll hold 25 + blend 25, start -50 | action at 0 | SARKAMARI |
| Trousers friction 0.1, stretch 80, compression 20, damp 0.4 then 0.2, mass 0.8 | T-shirt preset 0.3 / 35 / 10 / 0.8 / 0.6 | SARKAMARI; doc |
| Loose shirt stretch 40, compression 15, m
Truncated for display — read the full file on GitHub.
Related Skills
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
prospecting
60.1kWhen the user wants to find and qualify prospects for outbound, or asks who to target first, which signal to prioritize, or where to spot buyers with the problem: buying signals, enrichment, verification, account research.
ad-creative
60.1kWhen the user wants to write or judge ad creative, or asks which ad, hook, or angle to run or kill: headlines, primary text, and variations for Google, Meta, LinkedIn, and TikTok, fresh angles when creative fatigues. Test hypotheses name the metric, comparison, and expected direction.
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.
