tipoli5890/unity-dev-skills

game-character-pipeline

START HERE for a rigged game character made from an image or turnaround: stage order from views to Unity, each stage's owner and gate.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/tipoli5890/unity-dev-skills --skill game-character-pipeline

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

game-character-pipeline — one character, image to Unity, in order

A rigged character crosses ten skills. Each owns its stages and their method; this skill owns only the order, the gate between stages and what each stage leaves on disk for the next. It ships no scripts and copies no method: every row points at the file that does the work.

Start here — the request, and where it is answered

The requestGo to
Starting a character from an image, a turnaround sheet or a generated model; what comes nextG0, then the stages in order
The quality target (camera distance, the shots, the parts that must hold up), the parts tierG0 steps 1 and 4; reference/start-gate.md
Which route: rig locally onto the humanoid contract, or fit the mesh to one clip pack's skeletonG0 step 2; reference/routes.md
Preview, ship or upgrade track (a cloud mesh after the demo, chosen by a person)G0 step 3
Which skill owns a stage, what it enters with and leaves on disk, its gatethe stages, S0–S13
The generated texture is dull, blotchy or off the concept artS3b, mesh-texture-paint
Something upstream changed; a worked example (the Runner with a Mallet)reference/upstream-changes.md
A 2D character, a prop, moving the character in the gameScope
The preview-track rig is not the shipping rig. The preview track rigs the dense generated mesh as it is and never ships. The ship track picks the budget, builds the game mesh at it, and rigs that mesh once. Every decimation, retopology and rebake of a mesh that will be skinned happens before the rig: done after, it breaks the weights and UVs and everything taken on the old vertices (weight snapshots, the wrist correction, the grip point). Rigging is local; the cloud only remakes a mesh, on the upgrade track a person picks after the demo, never the quality target. Unity never retargets across skeletons (reference/routes.md).

G0 — the start gate, once per character

A person decides four answers before the first image is generated, written down in the brief or the ledger's note. In full: reference/start-gate.md (§6: territory → edit model).

  1. The quality target, first. Camera distance, the shots that matter, the body parts that

must hold up under them; every stop decision is taken against it (blender-retarget → reference/defect-triage-and-stop.md). It sets how far S3 and S10 go, not where the mesh is made.

  1. The route — it decides the art, so it comes before S1 (reference/routes.md):
The bodyRig (S6, local)ClipsS1 draws
Standard adult — defaultcharacter-autorig (Auto-Rig Pro; hand-built fallback) onto the contracthumanoid-motion two-camera; packs retargetedA-pose, straight elbows, legs apart
Custom: short limbs, big head, ears, tail, mittenscharacter-autorig hand-built, else blender-character-rig positional skinhumanoid-motion two-camera; keyed; retargetedthe mascot A-pose, thin parts thick
Adult, every motion from one packthe fit route (blender-character-rig → reference/fit-to-clip-skeleton.md)the pack's files unchangedA-pose, straight elbows
  1. The track.
TrackStagesFor
PreviewS1–S4, S6–S13a prototype, pitch or reel; the dense mesh rigged as it is
ShipS0–S13the shipping character: budget, game mesh, one rig
UpgradeS3 in the cloud (mesh only) → S4 → S5 (ship) → S6 → S9 → S11–S13a demo-approved character a person picks for a paid mesh; rig local, same contract and gates

A preview that becomes the shipping character goes back to S0 and S5 and is rigged again.

  1. The parts tier — whole (the demo), three (body, head, hair; showcase and ship) or

fine (+ hands, eyes), by the quality target: reference/start-gate.md §5.

The stages

A stage ends when its gate passes; at person, someone looked at the named image after the pre-review (codex-visual → reference/pre-review.md) and said yes; S13 records each artefact.

#StageOwnerEnters withExits when — and leavesRead
S0Budget — ship track, once per classunity-3d-modelsthe class's instances and frame_ms; one asset with approved views (S1)the asset at every preset up to the class's baseline (Small → Showcase), static copies under the game camera, one sheet, one perf-window/1 per rung; a person picks; the 3D budgets row with its calibrated dateunity-3d-models → reference/budgets.md; unity-profiling → reference/frame-windows.md
S1Four viewscodex-visualG0 answered; ART_DIRECTION.md lockedthe three-quarter image approved by a person, then FRONT, LEFT, BACK, RIGHT at one scale, true sides, empty hands, limbs clear of the body; the prop its own sheet; audit_3d_source.py --views passescodex-visual → reference/image-to-3d-input.md (§9)
S2Background removalcomfyui-asset-generationthe approved viewsper view an RGBA cut-out, a mask preview, a black composite; polarity checked on the first view; thin parts survived; upload names uniquecomfyui-asset-generation → reference/image-to-3d.md (Background removal for four views)
S3Generate, locally: the anchor, then partscomfyui-asset-generationthe black composites; the graph diffed against the official templatethe local Pixal3D multi-view GLB, inspect_glb.py --json-out green, its 8-view sheet accepted by a person; tier three: then the parts plan and one job per generated part. One change per run, never an identical resend; "adopt the usable baseline and record its limits" is a valid exitcomfyui-asset-generation → reference/image-to-3d-tuning.md, reference/image-to-3d-parts.md; codex-visual → reference/review-sheets.md
S3bRepaint texture, when S3's texture is below the targetmesh-texture-paintthe S3 GLB; S1's four views and turnaround sheet; parts: each part GLB with its part viewsthe base colour repainted view by view (G0 backend), each view gated; <stem>_painted.glb with mesh, UVs, normal and AO unchanged, its turntable accepted by a person; texels no view reached keep S3's texturemesh-texture-paint
S3cAssemble — three and upblender-character-rigthe anchor (S3/S3b) and the part GLBsassemble_parts.py gates green, compare.png accepted by a person; <c>_rig.glb, the mesh S4 and S6 take, and <c>_hair.glbblender-character-rig → reference/part-assembly.md
S4Normaliseblender-character-riga green GLBone object at its height, Z up, facing −Y, soles on Z 0, scale applied; the weld check read; an Auto-Rig Pro rig imports with weld_distance: None. Leaves ArtDirection/sources/Runner.blendblender-character-rig → reference/import-and-survey.md
S5Game mesh — ship trackblender-character-riga calibrated budget row; the S4 fileregenerated at the row's preset (through S2–S4's gates), or retopology, UVs and a showcase rebake; parts: assemble_parts.py ship; budget, silhouette, UV, bake and joint gates; a person approves the side-by-side. Leaves Runner_game.blend and its maps. S5b: optional repaintblender-character-rig → reference/game-mesh.md
S6Rig, locallycharacter-autorig; fallback blender-character-rigthe mesh to rig (ship: Runner_game.blend); `mesh_check.py` exit 0 — fused limbs, a same-facing double layer or a held prop (pre-review at S1/S3; arp_markers held_prop a backstop) go back to S1 or S3, never into a rig; a back-to-back inner shell is reported; kept, or cut (shell_strip.py)the markers accepted on Auto-Rig Pro AI agreement or by a person reading the two pictures; brt_arp pipeline gates; contract_map.py --require contract exit 0; deform_gate.py exit 0 and its renders looked at by a person; weight sum 1. Parts: all --hair, fine --eyes (reference/start-gate.md §5)character-autorig → reference/arp-pipeline.md, reference/gates.md, reference/hand-built-route.md
S7Clip sourceshumanoid-motion; blender-retargeta rigper move a source: two-camera video solved onto the rig, or a pack (a manifest before any download, names unique, fps the scene's); each source recorded with its licence; loop speeds and contact points measured before gameplay numbers freeze (unity-gameplay → reference/genre-timing-sports.md §0)humanoid-motion → reference/pipeline.md, reference/two-camera.md; blender-retarget → reference/clip-sources.md
S8Retarget and clean — in Blenderhumanoid-motion; blender-retargetthe sources; one clip's skeleton probedpacks: rotations by conjugation and translation scaled by the hip-height ratio (retarget.translation_kept); a two-camera solve is on the rig already. Then contact bake, loop cut, motion_metrics.py exit 0; one clip first (dry run, then real), its rest and wrist stills seen by a person, then the batch, whose report counts bake and metadata separatelyhumanoid-motion → reference/pipeline.md; blender-retarget → reference/rest-pose-and-conjugation.md
S9Library, prop, weightsblender-retarget, blender-character-rigevery clip bakedactions found by custom properties; the grip or a shield's forearm mount read from the prop's shape; drift in position and rotation; a weight move capped near 25% of its feature; the worst frame looked atblender-retarget → reference/action-library.md, reference/weight-repair.md; blender-character-rig → reference/prop-on-bone.md
S10Stop at the targetblender-retargeta defect someone sawthe layer named (geometry, skinning, animation, material), fixed there only, same camera and frame; stopped at the G0 target. Geometry wrong at the source goes back to S3, or S5blender-retarget → reference/defect-triage-and-stop.md
S11Export and round tripblender-retarget, blender-character-rigthe .blend passes brt_auditthe deform skeleton only, scale applied; the character, prop, idle and one action exported and read back (names, parents, scale 1, ≤ 4 influences, ranges) before the restblender-retarget → reference/unity-handoff.md; blender-character-rig → reference/fbx-export.md
S12Unity importunity-rigged-characterthe round trip greenin a throwaway project: Generic (Humanoid only for a mask or IK); avatar.isValid, File Scale 1, bones matching Blender, PBR maps rebuilt, spring chains set up; a screenshot under the game camera and a frame window; a person approvesunity-rigged-character → reference/unity-import.md, reference/humanoid-contract.md, reference/textures.md; unity-profiling → reference/frame-windows.md
S13The ledger, at every gateart-asset-registryany artefacteach artefact with its hash and licence (source, territory), links to its job and the art-direction version; a person's gate as status ID approved; check refuses an excluded territory; stale after any upstream changeart-asset-registry → reference/workflow.md, reference/ledger-schema.md, reference/licences.md

Scope — what this skill does NOT do

Not hereGo to
Props and anything with no skeletonunity-3d-models
A 2D character: sprite sheets, frames, Unity sprite animationcodex-visual · sprite-from-video · unity-2d-sprites
Moving the character in the game: controller, Animator bridgeunity-3d-controller
States, events, root motion and IK on the clips in Unityunity-animation
The game's visual direction and its locked decisionsunity-game-brief
from this repository

More skills

All skills