Repository navigation
docs: correct composition syntax in primer and book; add scene guidance and a pixelsrc skill - #37
Merged
Merged
Conversation
…idance and a pixelsrc skill
The primer and the composition page documented layers as { sprite, x, y } / position. The renderer
rejects that with 'missing field sprites'; compositions take a sprites key map and map layers.
Both now show the real form, with examples rendered on pxl 0.3.1.
Adds to the primer: recolouring by variant or by source + palette, building scenes (anchors,
far-to-near layers, alpha shadows, full-canvas sprites) and a 2:1 isometric recipe.
Adds skills/pixelsrc/SKILL.md, the first agent skill for the repo.
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014TTLD9BXsReLisPj4eMGeJ
…ure are hidden) Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014TTLD9BXsReLisPj4eMGeJ
…7-refresh-20261115
…7-refresh-20261115
Merged
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The primer and composition guide showed layer syntax that the renderer rejects. Use the actual sprites key map, map layers and cell_size grid, and add scene, recoloring and isometric guidance to the primer and authoring skill.
Scope the parse-recovery, nested-composition and inherited-palette limitations to released 0.3.1. Current source now includes the corresponding fixes; the guide distinguishes those fixes from an installed 0.3.1 executable. The symptom table follows the same version distinction.
Validation: the original composition examples were rendered with 0.3.1 and seven primer tests passed. The current source statements were checked against the landed parse-recovery, nested-rendering and inherited-token implementations and their regression controls. The latest follow-up changes prose only; whitespace checks pass. Fresh hosted CI and an independent non-author review remain required for this head.
Four other book pages still contain the older position syntax: personas/sprite-artist.md, getting-started/concepts.md, ai-generation/examples.md and ai-generation/system-prompts.md. They remain outside this guide/primer/skill change.
Demo: the rewritten composition guide provides the concrete runnable example. No behavior or installed executable changes in the prose follow-up; no runtime recording is claimed.