Low-Poly-Modeling-Skill

agent
Security Audit
Fail
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Fail
  • exec() — Shell command execution in examples/minimal_character.py
  • exec() — Shell command execution in tests/smoke_weld.py
  • exec() — Shell command execution in tests/test_measure_stub.py
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

As it says, a low-poly modeling skill for AI agents, Mostly in PS1/PSX style.

README.md

Low-Poly-Modeling-Skill

A skill for AI coding agents that model PS1/PSX-style low-poly assets in Blender.

Not a modeling tutorial. It is the working method that converges fast: block with lofts,
judge in clay, correct numbers instead of vertices, weld the joints into one surface, and
verify with the same gate every time. It also carries the list of failure modes that cost
the most round trips, so the next attempt doesn't rediscover them.

The body doctrine is one welded surface: limbs grow out of the torso through cut
sockets and shared rings, not pushed into it and hidden under a garment. Butted shells are
a blockout stage, not a result — they show a seam in close-up and tear when rigged.

Built from a study of three real PS1-era reference models and one finished character.

What's here

file what it is
SKILL.md the skill: conventions, API, welding doctrine, workflow, traps, review gate
scripts/psx_build.py the library — superellipse rings, lofts, bridge() seam stitching, extrude() welded digits, mirroring, finish, geometry gate
scripts/preview.py ortho clay renders; shots derived from the object's bounding box
scripts/compare.py stats table + side-by-side render against reference models
scripts/measure_silhouette.py width-at-height scan of a reference image
examples/minimal_character.py ~60 line end-to-end blockout
tests/smoke_weld.py exercises bridge() + extrude() and asserts 0 boundary edges (run inside Blender)
tests/test_measure_stub.py runs the measuring tool against a synthetic image, no Blender needed

Install

Copy or link this folder into your agent's skills directory so that SKILL.md sits at its
root:

~/.config/opencode/skills/ps1-modeling/     # OpenCode
~/.claude/skills/ps1-modeling/              # Claude Code

On Windows a junction is enough and keeps one copy:

cmd /c mklink /J "%USERPROFILE%\.config\opencode\skills\ps1-modeling" "F:\path\to\Low-Poly-Modeling-Skill"

Use

The scripts run inside Blender (they need bpy). From the repo root:

import sys; sys.path.insert(0, "scripts")

exec(open("examples/minimal_character.py").read())   # build
exec(open("scripts/preview.py").read())              # render clay views
exec(open("scripts/compare.py").read())              # after setting REFS

Each harness has its config at the top: OBJECT, OUT, and for compare.py a REFS list
of reference models to scale and line up against the build.

What it produces

Renders taken during development of the character this skill was written on — all clay,
all straight out of preview.py, no retouching. That is the point: a build is judged on
silhouette and where the surfaces meet, not on surface detail.

T-pose front three-quarter
Front, 1.72 m, T-pose, 1127 v / 2228 tris Three-quarter view
profile head
Profile — silhouette and hair mass Head: smooth skull, faceted mane, stitched neck
hand
Welded hand: 4 fingers of 3 segments extruded off the knuckle ring, thumb out of the palm's own wall quad

Future plans

  • Geometry correction — tighten the remaining stitch seams (shoulder cap, crotch
    triangles) and give the face modelled eye sockets so painted features have something to
    sit in.
  • Animating — a skeleton on the welded surface: shoulders, hips and wrists now share
    edges with the torso, which is what makes that possible without tearing.
  • Texturing — one 256²/512² atlas: painted face, dark inner-hair region so the mane's
    facets read as depth, and the clothes as paint over the same mesh.
  • UV map correction — replace the smart_project placeholder with a real layout: one
    island per stitched band, no overlapping shells, seams placed where the texture hides
    them.

The conventions it enforces

+Z up · character faces −Y · feet on Z=0 · metres · one object · one material · one
256²–512² atlas · smooth-shaded body with faceted hair · no normal maps, PBR or shape keys ·
one welded surface — no coincident vertices, no boundary edges on the body, no
non-manifold edges, no n-gons · 600–1600 tris for a bare body, more once hair and
accessories are added.

License

MIT — see LICENSE.

Reviews (0)

No results found