ashfox-operator

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.

1. Call get_project_state and capture project.revision.
2. Execute exactly one mutation with ifRevision.
3. Validate mutation response and revision transition.
4. 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.

1. Load one or more profiles from ../../../common/constraint-profiles/.
2. Resolve landmark mapping (face and foot/toe targets) from current snapshot names/ids.
3. Evaluate constraints and produce pass/fail with per-rule diagnostics.
4. 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.

1. Apply one focused mutation per failed rule.
2. Re-evaluate constraints.
3. 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.

1. Select one style profile from ../../../common/style-profiles/.
2. Render with render_preview.
3. Score current result with ../../../common/quality-rubric.md.
4. Apply one focused improvement mutation.
5. 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