SkillAgentSearch skills...

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-fx

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

86/100

Category

Other

Supported Platforms

Universal

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.

Substance
30/30
Structure
13/20
Description
15/15
Adoption
13/20
Freshness
15/15

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 found

Our 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.

SkillScoreStarsUpdatedFormat
scenario-maya-fx (this skill)by scenario-labs861.0k35d agoSKILL.md
algorithmic-artby anthropics100177.9k2mo agoSKILL.md
pptxby anthropics100177.9k2mo agoSKILL.md
prospectingby coreyhaines3110060.1k11d agoSKILL.md
ad-creativeby coreyhaines3110060.1k11d agoSKILL.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.

name: 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_meters 0.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]). MPM detail_size is 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_attrs returns 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

  1. 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) with art_choice=True. GATE: no error line.

  2. 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_points for USD point instancers | | Liquids | basic_liquid_graph | legacy Bifrost Fluids is gone |

  3. 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-roll mx_fx.add_preroll(ctrls, action_start, rest=bind_pose); duplicates at the bind frame with mx_fx.sim_duplicate. GATE: verdict clean, the duplicate follows the original within 0.01 cm.

  4. 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_*_graph and Explode (Stamatelos [00:39:07]); script it with mx_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(...) on emitter_facts(mesh) and sim_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.
  5. 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 a geo_detail_size or time_step_size change, or a compound created or exploded, re-run from the start (sim guide). GATE: nothing non-finite, no empty frame.

  6. 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: headless mx_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; GUI mx_review.playblast from the shot camera; volumes with mx_fx.volume_review (Arnold, tricubic). Judge with references/critique.md.

  7. 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, or post_refine_aero on the cache (frames in order, original sources and colliders) before lowering detail size everywhere (sim guide).

  8. 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); Bifrost file_cache with only the properties the renderer needs; a cache-only render scene. GATE: mx_fx.alembic_check and file_sequence_report clean, 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

View on GitHub
GitHub Stars1.0k
CategoryOther
Updated1mo ago
Forks129

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions