| name | ashfox-operator |
| description | Operate ashfox MCP tools with high reliability for modeling, texturing, animation, validation, and QA reporting. Use when creating or editing Blockbench projects through ashfox, when diagnosing failed mutations, or when generating developer-ready defect reports with full request/response history. |
ashfox Operator
Mission
Run ashfox edits safely, then optimize for visual and behavioral quality with a short, deterministic improvement loop.
Safe Pass
Use strict mutation discipline before any quality tuning.
- Call
get_project_state and capture project.revision.
- Execute exactly one mutation with
ifRevision.
- Validate mutation response and revision transition.
- Re-read state and verify post-conditions.
Rules:
- Always use one mutation per tool call.
- Always pass
ifRevision for mutations.
- Retry once only for
invalid_state_revision_mismatch after refreshing revision.
- Never retry
invalid_payload without correcting payload.
Constraint Pass
Before craft tuning, enforce structural constraints using profile-based rules.
- Load one or more profiles from
../../../common/constraint-profiles/.
- Resolve landmark mapping (face and foot/toe targets) from current snapshot names/ids.
- Evaluate constraints and produce pass/fail with per-rule diagnostics.
- If failed, execute
Repair Pass before any style-level edits.
Hard requirements:
- Prefer bilateral symmetry where profile requires it.
- For face targets, check relative ordering and spacing for eyes, nose, and mouth.
- For feet/toes, check position, direction alignment, and ground-contact coherence.
Repair Pass
Use minimal, deterministic corrections for failed constraints.
- Apply one focused mutation per failed rule.
- Re-evaluate constraints.
- Stop after 2 repair iterations unless user explicitly asks for more.
If constraints remain failing after limit:
- Stop further aesthetic edits.
- Return failure summary with exact violated rules and current measurements.
Craft Pass
After the mutation is safe, improve output quality.
- Select one style profile from
../../../common/style-profiles/.
- Render with
render_preview.
- Score current result with
../../../common/quality-rubric.md.
- Apply one focused improvement mutation.
- Re-render and re-score.
Limits:
- Maximum 2 craft iterations per request unless explicitly asked for more.
- Stop immediately if integrity checks fail.
Shading Ownership
Shading generation belongs to MCP server logic, not this skill.
- Do not duplicate or re-implement shading algorithms in the skill.
- The skill controls only policy and verification:
- choose style profile and shade intent,
- request server-side shading behavior,
- verify visual outcome with rubric and preview.
- If shading quality is poor, adjust inputs/parameters and re-run.
- If behavior seems wrong, report as server issue with evidence.
Quality Rubric
Use ../../../common/quality-rubric.md and report scores for:
- Form and proportions
- UV layout stability
- Texture readability and shading
- Animation readability (if animation is touched)
- Consistency with selected style profile
Style Profiles
Pick one explicit style target and keep it stable for the whole run:
../../../common/style-profiles/minecraft-natural-shade.md../../../common/style-profiles/creature-organic.md../../../common/style-profiles/hard-surface-voxel.md
Output Contract
Always include:
- Mutation sequence with revision chain
- Quality gate outcomes (
validate, read_texture, preview checks)
- Rubric scores before/after craft pass
- Remaining risks and next best improvement
When behavior is wrong or unstable, produce a QA report:
- Include verbatim request/response JSON history.
- Include revision chain and environment versions.
- Include trace paths and evidence.
- Separate observed facts from hypotheses.
Load detailed references as needed:
../../../common/mcp-mutation-contract.md../../../common/texture-quality-gates.md../../../common/error-recovery-playbook.md../../../common/qa-report-template.md../../../common/quality-rubric.md../../../common/constraint-pass-contract.md../../../common/shading-ownership.md../../../common/constraint-profiles/README.md../../../common/constraint-profiles/humanoid-face.yaml../../../common/constraint-profiles/biped-foot.yaml
