maya-dev git:20260520.1a74f36A

Immutable. This exact content never changes and is served at /api/v1/blob/1e5303e495a6242c.

---
name: maya-dev
description: |-
  Pipeline stage — development workflow helpers for authoring Maya tools inside
  a live Maya session. Use to attach a local Python project, hot-reload its
  modules, run entrypoints or scripts, start debugpy, and capture Maya UI
  evidence while iterating with an agent. Not for general scene editing: use
  domain skills first.
license: MIT
allowed-tools: Bash Read
metadata:
  dcc-mcp:
    dcc: maya
    layer: domain
    stage: pipeline
    version: 0.1.0
    tags:
    - maya
    - development
    - debug
    - hot-reload
    - ui-capture
    search-hint: |-
      develop maya tools, attach python project, hot reload modules, run
      project entrypoint, debugpy attach, capture maya ui screenshot, script
      stdout stderr traceback diagnostics
    depends: []
    tools: tools.yaml
    groups: groups.yaml
---
# maya-dev (Pipeline stage)

Development workflow helpers for agents working on Maya Python tools in a
live Maya session. The intended loop is:

1. `attach_project` once for the project root.
2. Edit files in the normal workspace.
3. `run_check` or `reload_modules` + `run_entrypoint`.
4. Inspect stdout, stderr, traceback, and optional UI screenshot.

Set `DCC_MCP_MAYA_DEV_ROOTS` to a path-list of trusted roots when a studio
wants to restrict which local projects can be attached.

## Scripts

- `attach_project` — Add a development project root to Maya's `sys.path`
- `reload_modules` — Purge or reload modules belonging to the attached project
- `run_entrypoint` — Import and call a Python entrypoint from the project
- `run_script` — Run a project-local `.py` script with captured output
- `start_debugpy` — Start a debugpy listener in the Maya process
- `capture_ui` — Capture the Maya main window or a named Qt widget as PNG
- `run_check` — Reload, run an entrypoint, capture diagnostics, optionally grab UI