Official Codebase of 3DCodeVerse
Python
skills: hoist the WHEN into the first sentence of every description
gaoypeng3568721ed5ec
diff --git a/harness/codeverse/skills/cv3d-bbox-contract/SKILL.md b/harness/codeverse/skills/cv3d-bbox-contract/SKILL.mdindex cb7c42fe..7e667914 100644--- a/harness/codeverse/skills/cv3d-bbox-contract/SKILL.md+++ b/harness/codeverse/skills/cv3d-bbox-contract/SKILL.md@@ -1,6 +1,6 @@---name: cv3d-bbox-contract-description: Hit the plan's dimensions on the first build. Use whenever this session owns a part's or the object's size or placement — baseline, part, detail, refine, rebuild, zone — and on every repair round where the contract gate fired. Covers the tolerance the gate really uses (relative, not a flat millimetre figure), how instanced parts are measured, ground contact and footprint, part-name matching, and how to prove the numbers with measure / check_contract instead of by eye.+description: "Use when a session owns part sizes, placement or ground contact, or when the contract gate fired: hit the plan's dimensions on the first build. Applies to baseline, part, detail, refine, rebuild and zone sessions on static_object, articulated_object and scene. Covers the tolerance the gate really uses (relative, not a flat millimetre figure), how instanced parts are measured, ground contact and footprint, part-name matching, and how to prove the numbers with measure / check_contract instead of by eye."license: Apache-2.0metadata:evidence: measureddiff --git a/harness/codeverse/skills/cv3d-blender-forms/SKILL.md b/harness/codeverse/skills/cv3d-blender-forms/SKILL.mdindex 9b911a9b..003385b0 100644--- a/harness/codeverse/skills/cv3d-blender-forms/SKILL.md+++ b/harness/codeverse/skills/cv3d-blender-forms/SKILL.md@@ -1,6 +1,6 @@---name: cv3d-blender-forms-description: Turn a described shape into the right bpy technique, and avoid the five bpy traps this harness's lint and exporter actually catch (join without an active object, a part file model.py never imports, no PascalCase names, modifier_apply out of context, primitive_cube_add scale doubling the extents). Use in any session writing Blender python — static_object with language blender, or articulated_object with language urdf_blender — when building, detailing, refining or repairing geometry.+description: "Use when writing Blender bpy code (language blender or urdf_blender): turn a described shape into the right bpy technique. Avoids the five bpy traps this harness's lint and exporter actually catch: join without an active object, a part file model.py never imports, no PascalCase names, modifier_apply out of context, and primitive_cube_add scale doubling the extents. Covers building, detailing, refining and repairing geometry."license: Apache-2.0compatibility: Blender 5.0.1 headless, run by codeverse/languages/blender/wrappers/run_bpy.py. bpy, bmesh, mathutils, math, random, numpy only.metadata:diff --git a/harness/codeverse/skills/cv3d-cadquery-forms/SKILL.md b/harness/codeverse/skills/cv3d-cadquery-forms/SKILL.mdindex ab33f295..7bfaff02 100644--- a/harness/codeverse/skills/cv3d-cadquery-forms/SKILL.md+++ b/harness/codeverse/skills/cv3d-cadquery-forms/SKILL.md@@ -1,6 +1,6 @@---name: cv3d-cadquery-forms-description: Build the planned forms in CadQuery and get past the OCC kernel on the first try. Use for any session writing src/model.py in CadQuery — baseline, part, detail, refine, rebuild or repair. Gives the form-to-technique decision table, the fillet / revolve / boolean rules that decide whether the script builds at all, and the four traps our own lint and runtime wrapper are written to catch.+description: "Use when writing CadQuery src/model.py - baseline, part, detail, refine, rebuild or repair: build the planned forms and get past the OCC kernel. Gives the form-to-technique decision table, the fillet / revolve / boolean rules that decide whether the script builds at all, and the four traps our own lint and runtime wrapper are written to catch."license: Apache-2.0compatibility: CadQuery 2.8 on OCP; one module src/model.py exporting a module-level `result`.metadata:diff --git a/harness/codeverse/skills/cv3d-form-manifest/SKILL.md b/harness/codeverse/skills/cv3d-form-manifest/SKILL.mdindex 01e260c8..dad652e8 100644--- a/harness/codeverse/skills/cv3d-form-manifest/SKILL.md+++ b/harness/codeverse/skills/cv3d-form-manifest/SKILL.md@@ -1,6 +1,6 @@---name: cv3d-form-manifest-description: "Decide every shape in language-neutral FORM words, with its dimensions, its placement and one countable refinement, BEFORE calling any geometry API. Use at the start of a baseline, part, detail or rebuild session on the static_object or articulated_object track — that is, whenever you are about to write geometry for a part you have not built yet. Turns the ENGINEERING BRIEF and the plan's part rows into a written element list the language skill's table then implements one line at a time. Skip it on a repair round: a repair is not re-planning."+description: "Use before calling any geometry API on a baseline, part, detail or rebuild session: name every shape, its dimensions and placement in FORM words. For the static_object and articulated_object tracks - whenever you are about to write geometry for a part you have not built yet. Turns the ENGINEERING BRIEF and the plan's part rows into a written element list the language skill's table then implements one line at a time, each with one countable refinement. Skip it on a repair round: a repair is not re-planning."license: Apache-2.0compatibility: "static_object and articulated_object tracks, all four object languages (blender, urdf_blender, cadquery, threejs). Needs the plan and, when the run enabled it, the ENGINEERING BRIEF block in your prompt."metadata:diff --git a/harness/codeverse/skills/cv3d-glsl-craft/SKILL.md b/harness/codeverse/skills/cv3d-glsl-craft/SKILL.mdindex 34e3c678..79c3d186 100644--- a/harness/codeverse/skills/cv3d-glsl-craft/SKILL.md+++ b/harness/codeverse/skills/cv3d-glsl-craft/SKILL.md@@ -1,6 +1,6 @@---name: cv3d-glsl-craft-description: Craft rules for the fragment shaders this harness judges — what the five sampled frames measure and where the real operating band is, how to build multi-scale structure that does not alias, how to make motion come from the mechanism instead of a uv scroll, and why an added radial falloff reads as a uniform glow instead of light shafts. Use in any graphics session with language glsl_shader when writing, refining, repairing or rebuilding the shader, and whenever gl_frames reports static, flicker or low detail.+description: "Use when writing, refining or repairing a glsl_shader fragment shader, or when gl_frames reports static, flicker or low detail. Craft rules for the shaders this harness judges: what the five sampled frames measure and where the real operating band is, how to build multi-scale structure that does not alias, how to make motion come from the mechanism instead of a uv scroll, and why an added radial falloff reads as a uniform glow instead of light shafts."license: Apache-2.0compatibility: GLSL 330 core via moderngl, headless. One image pass (src/shader.frag), an optional src/common.glsl and one feedback pass (src/buffer_a.frag). The harness declares the uniforms; the contract lists them.metadata:diff --git a/harness/codeverse/skills/cv3d-opengl-pipeline/SKILL.md b/harness/codeverse/skills/cv3d-opengl-pipeline/SKILL.mdindex a353f071..74f7e6a2 100644--- a/harness/codeverse/skills/cv3d-opengl-pipeline/SKILL.md+++ b/harness/codeverse/skills/cv3d-opengl-pipeline/SKILL.md@@ -1,6 +1,6 @@---name: cv3d-opengl-pipeline-description: Write a raw OpenGL / moderngl program that renders what the brief asked for. Use for any opengl_python session - baseline, refine, repair or rebuild - and whenever the gl_frames gate reported flicker, no motion or a near-flat image. Covers the setup / render contract, the sampled-time trap that breaks every feedback simulation, VAO and uniform mechanics, ping-pong FBOs, and the three richness rules the judge scores this language worst on.+description: "Use when writing an opengl_python / moderngl program, or when the gl_frames gate reported flicker, no motion or a near-flat image. Covers baseline, refine, repair and rebuild sessions: the setup / render contract, the sampled-time trap that breaks every feedback simulation, VAO and uniform mechanics, ping-pong FBOs, and the three richness rules the judge scores this language worst on."license: Apache-2.0compatibility: OpenGL 3.3 core through moderngl, headless EGL; one module src/program.py, GLSL 330 core inline or in src/*.glsl.metadata:diff --git a/harness/codeverse/skills/cv3d-part-contact/SKILL.md b/harness/codeverse/skills/cv3d-part-contact/SKILL.mdindex 64697b59..01d28d3a 100644--- a/harness/codeverse/skills/cv3d-part-contact/SKILL.md+++ b/harness/codeverse/skills/cv3d-part-contact/SKILL.md@@ -1,6 +1,6 @@---name: cv3d-part-contact-description: How multi-part objects must touch in this harness — the contact, weld-overlap, penetration and stray-island numbers the connectivity gate actually measures, and how to add detail without creating new contact pairs. Use when writing or fixing the geometry of an object with two or more parts (static_object or articulated_object, any language), before the first build, and on every repair round where a connectivity or joint_sweep finding fired.+description: "Use when an object has two or more parts, or when a connectivity or joint_sweep finding fired: how parts must touch without penetrating. For static_object and articulated_object in any language, before the first build and on every repair round. Gives the contact, weld-overlap, penetration and stray-island numbers the connectivity gate actually measures, and how to add detail without creating new contact pairs."license: Apache-2.0compatibility: Object tracks only (static_object, articulated_object). Needs the connectivity gate, i.e. an exported object.glb; scene and graphics tracks have no part graph.metadata:diff --git a/harness/codeverse/skills/cv3d-repeats-and-mirrors/SKILL.md b/harness/codeverse/skills/cv3d-repeats-and-mirrors/SKILL.mdindex 777af4c7..397add56 100644--- a/harness/codeverse/skills/cv3d-repeats-and-mirrors/SKILL.md+++ b/harness/codeverse/skills/cv3d-repeats-and-mirrors/SKILL.md@@ -1,6 +1,6 @@---name: cv3d-repeats-and-mirrors-description: Build repeated, mirrored and radially arrayed parts so the contract gate passes on the first build. Use whenever a plan part has instances greater than 1 or symmetry other than none, when a part is a left/right pair or a ring of N, or on any repair round that reported contract/instance_bbox or contract/instance_count. Covers instance naming (Name_0..Name_N), which box the gate compares for an instanced part, mirroring without a negative object scale, and radial angles derived from the count.+description: "Use when a part has instances above 1 or symmetry, is a left/right pair or a ring of N, or when contract/instance_bbox or instance_count fired. Build repeated, mirrored and radially arrayed parts so the contract gate passes on the first build. Covers instance naming (Name_0..Name_N), which box the gate compares for an instanced part, mirroring without a negative object scale, and radial angles derived from the count."license: Apache-2.0compatibility: static_object and articulated_object tracks; blender, urdf_blender, cadquery and threejs. Numbers are from codeverse/spatial/contract.py and conventions.py.metadata:diff --git a/harness/codeverse/skills/cv3d-scene-composition/SKILL.md b/harness/codeverse/skills/cv3d-scene-composition/SKILL.mdindex 04c707b2..645cbdaa 100644--- a/harness/codeverse/skills/cv3d-scene-composition/SKILL.md+++ b/harness/codeverse/skills/cv3d-scene-composition/SKILL.md@@ -1,6 +1,6 @@---name: cv3d-scene-composition-description: Lay out a three.js scene so the harness's deterministic instruments agree with the picture — one height function everything samples, a world that does not end in shot, and cameras computed from measured bounds instead of guessed. Includes the sky/ground/content classifier that silently decides two gate findings, and the exact scene_frames thresholds and score caps for camera placement and frame coverage. Use in any scene_threejs session that owns the environment, a zone's placement, or the camera list, and on any repair round where scene_frames reported a camera problem.+description: "Use when a scene_threejs session owns the environment, a zone's placement or the camera list, or when scene_frames reported a camera problem. Lay out the scene so the harness's deterministic instruments agree with the picture - one height function everything samples, a world that does not end in shot, and cameras computed from measured bounds instead of guessed. Includes the sky/ground/content classifier that silently decides two gate findings, and the exact scene_frames thresholds and score caps for camera placement and frame coverage."license: Apache-2.0compatibility: track scene, language scene_threejs (three r182, headless Chrome, the harness builds the cameras from your plain camera objects).metadata:diff --git a/harness/codeverse/skills/cv3d-scene-lighting/SKILL.md b/harness/codeverse/skills/cv3d-scene-lighting/SKILL.mdindex 5efafb4a..64249a3b 100644--- a/harness/codeverse/skills/cv3d-scene-lighting/SKILL.md+++ b/harness/codeverse/skills/cv3d-scene-lighting/SKILL.md@@ -1,6 +1,6 @@---name: cv3d-scene-lighting-description: Light a three.js scene so the frame gate passes and the mood still reads. Use in a scene baseline, env or refine session, and on any round where scene_frames called a frame too dark, blown out or flat. Gives the exact thresholds the gate measures, the key / fill / practical recipe with numbers, and the one thing hex colours hide - how dark an albedo really is once the renderer works in linear light.+description: "Use when lighting a scene_threejs baseline, env or refine session, or when scene_frames called a frame too dark, blown out or flat. Light the scene so the frame gate passes and the mood still reads. Gives the exact thresholds the gate measures, the key / fill / practical recipe with numbers, and the one thing hex colours hide - how dark an albedo really is once the renderer works in linear light."license: Apache-2.0compatibility: three r0.182, headless WebGL; renderer fixed at ACES Filmic tone mapping, exposure 1.0, sRGB output.metadata:diff --git a/harness/codeverse/skills/cv3d-scene-motion/SKILL.md b/harness/codeverse/skills/cv3d-scene-motion/SKILL.mdindex 57159a29..c9abd6c2 100644--- a/harness/codeverse/skills/cv3d-scene-motion/SKILL.md+++ b/harness/codeverse/skills/cv3d-scene-motion/SKILL.md@@ -1,6 +1,6 @@---name: cv3d-scene-motion-description: "Make a scene_threejs scene visibly move between the two frames the harness photographs, and survive the four mechanisms that silently freeze it. Use in any scene session that authors or refines animation — baseline, zone, refine or compose — and on every repair round where the scene_frames gate reported no motion or the judge answered nothing_moves. Covers the measured motion threshold, the single update hook the harness actually calls, the amplitudes that read at 1024 x 576, and why clearing the motion gate is not the same as scoring animation_life — that is judged per item against the plan animation list."+description: "Use when a scene_threejs session authors or refines animation, or when scene_frames reported no motion or the judge said nothing_moves. Make the scene visibly move between the two frames the harness photographs, and survive the four mechanisms that silently freeze it. Applies to baseline, zone, refine and compose sessions. Covers the measured motion threshold, the single update hook the harness actually calls, the amplitudes that read at 1024 x 576, and why clearing the motion gate is not the same as scoring animation_life - that is judged per item against the plan animation list."license: Apache-2.0compatibility: "scene track, language scene_threejs. three r182 in headless Chrome; the harness photographs each camera at t = 0 s and t = 1.5 s and diffs the pair."metadata:diff --git a/harness/codeverse/skills/cv3d-threejs-forms/SKILL.md b/harness/codeverse/skills/cv3d-threejs-forms/SKILL.mdindex 535b5f77..10ca27e2 100644--- a/harness/codeverse/skills/cv3d-threejs-forms/SKILL.md+++ b/harness/codeverse/skills/cv3d-threejs-forms/SKILL.md@@ -1,6 +1,6 @@---name: cv3d-threejs-forms-description: "Turn each FORM word in your manifest into the right three.js geometry maker, with the segment counts that make curves read and the traps that make a threejs part silently ship nothing. Use in any baseline, part, detail, refine, rebuild or repair session on the static_object track in language threejs — that is, whenever you are writing src/object.js or src/parts/*.js. Covers the fact that this language has no boolean/CSG at all, so cavities and shells are built into the profile instead of subtracted."+description: "Use when writing three.js object geometry in src/object.js or src/parts/*.js on the static_object track, in any session kind. Turn each FORM word in your manifest into the right three.js geometry maker, with the segment counts that make curves read and the traps that make a threejs part silently ship nothing. Covers the fact that this language has no boolean/CSG at all, so cavities and shells are built into the profile instead of subtracted."license: Apache-2.0compatibility: "static_object track, language threejs. three r182 ESM in node, exported to GLB by the harness. Imports that resolve: three, three/addons/*, relative files under src/."metadata:diff --git a/harness/codeverse/skills/cv3d-threejs-shader-traps/SKILL.md b/harness/codeverse/skills/cv3d-threejs-shader-traps/SKILL.mdindex 658eebe3..19cf8c56 100644--- a/harness/codeverse/skills/cv3d-threejs-shader-traps/SKILL.md+++ b/harness/codeverse/skills/cv3d-threejs-shader-traps/SKILL.md@@ -1,6 +1,6 @@---name: cv3d-threejs-shader-traps-description: Write a ShaderMaterial or an onBeforeCompile patch that survives this harness's shader gate on the first build. Use on any scene_threejs or threejs session that authors custom GLSL, and on every round where shader_preflight reported an error or a warning. Says which mistakes the harness detects statically, which it detects at runtime, which it cannot see at all, and corrects three widely repeated three.js warnings that do not apply to this renderer.+description: "Use when a threejs or scene_threejs session writes a ShaderMaterial or an onBeforeCompile patch, or when shader_preflight reported an error. Write custom GLSL that survives this harness's shader gate on the first build. Says which mistakes the harness detects statically, which it detects at runtime, which it cannot see at all, and corrects three widely repeated three.js warnings that do not apply to this renderer."license: Apache-2.0compatibility: [email protected], headless WebGL via puppeteer. Rules read from runtime_js/lib/glsl_audit.mjs, runtime_js/lib/host_compile.mjs, runtime_js/lib/shader_report.mjs and runtime_js/lib/browser/renderer.js.metadata:diff --git a/harness/codeverse/skills/cv3d-urdf-joints/SKILL.md b/harness/codeverse/skills/cv3d-urdf-joints/SKILL.mdindex 84db9f95..dd08db48 100644--- a/harness/codeverse/skills/cv3d-urdf-joints/SKILL.md+++ b/harness/codeverse/skills/cv3d-urdf-joints/SKILL.md@@ -1,6 +1,6 @@---name: cv3d-urdf-joints-description: Get links, joints, axes, limits and clearances right in one pass on an articulated_object session. Use when authoring or repairing src/robot.urdf and the rest pose in src/model.py, and always on a repair round that reported joint_sweep or motion_direction. Explains which pose set the sweep gate tests, why a moved-pose overlap is always an ERROR, and the arithmetic that predicts which way positive q pushes a child before you write the axis.+description: "Use when authoring or repairing an articulated_object's src/robot.urdf - links, joints, axes, limits, clearances - or when joint_sweep fired. Also covers the rest pose in src/model.py, and applies on every repair round that reported joint_sweep or motion_direction. Explains which pose set the sweep gate tests, why a moved-pose overlap is always an ERROR, and the arithmetic that predicts which way positive q pushes a child before you write the axis."license: Apache-2.0compatibility: track articulated_object, language urdf_blender. Constants read from codeverse/languages/urdf/runtime.py, codeverse/spatial/joints_sweep.py, joints_poses.py and codeverse/tracks/motion.py.metadata: