[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75V6TM3F9A7ZMA0Q43RVJSF":3,"skill-same:01M75V6TM3F9A7ZMA0Q43RVJSF":55},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M75V6TM3F9A7ZMA0Q43RVJSF","tooling",null,"Maps shared build\u002FCLI architecture, compiler assembly identity, candidate installation, generated sections, and host admission.","ByteTerrace\u002FPuck","ByteTerrace","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F18753984?v=4","01M75V2WCB9PGGC3H7RZC7AXPS","01M75V2WD0NJPRNP5HJ75VZGD0",2,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftooling\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: tooling\ndescription: \"Maps shared build\u002FCLI architecture, compiler assembly identity, candidate installation, generated sections, and host admission.\"\n---\n\n# Build and CLI tooling\n\nLoad [verification](..\u002Fverification\u002FSKILL.md) for builds, private CLI copies and\nleases, and [symbol-analysis](..\u002Fsymbol-analysis\u002FSKILL.md) for finding callers.\n[CI and releases](..\u002F..\u002F..\u002Fdocs\u002Fdevelopment\u002Fci.md) owns repository automation;\nthe [CLI reference](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Fcli.md) owns verb behavior.\nFile publication, paths, Git inventories, project ownership and Markdown parsing route to\n[tooling-files](..\u002Ftooling-files\u002FSKILL.md).\n\n| Capability | Shared home | Callers and boundary |\n|---|---|---|\n| Parse project declarations and evaluate architecture policy | `ArchitectureModel` in `build\u002FProjectArchitecture.cs` | The build task and `Puck.Cli.Core` compile this source. MSBuild supplies evaluated policy and resolved references; `ArchitectureCommand` supplies declared facts. Keep resolved-route enforcement (`PUCKARCH006`) in `PuckArchitectureGate`. A declared report cannot prove resolved references. |\n| Walk project dependencies | [ArchitectureGraph](..\u002F..\u002F..\u002Fbuild\u002FProjectArchitecture.cs) | Architecture closures follow assembly edges; affected and shader selection follow all build references. Choose the edge set; share the walk. |\n| Traverse assemblies for derivation identity | `AssemblyReach.Of` | The default follows `Puck.*`; `WorldCompileCache` includes all non-framework compiler dependencies and records missing trimmed modules. `WorldCodeWarmer` uses the same walk. Keep identity folds with their derivations. |\n| Splice generated document sections | `CliGeneratedSection.TryReplace` | Packages and the architecture map preserve delimiters and surrounding text, then use `CliGeneratedFile.WriteOrCheck`, including index agreement. |\n| Install an isolated CLI candidate | `CandidateCliInstall` in `build\u002FCandidateCliInstall.cs` | Compiled into `Puck.Cli.Release` and run as a file-based bootstrap by `setup-puck`, before a CLI exists. One exclusive feed, private package cache, fresh tool path and version check. The CLI supplies `CliProcess`; bootstrap `Main` supplies process I\u002FO only. |\n| Acquire and admit leased work | `LeasedAdmission.AcquireAsync` in `Puck.Cli.Core` | `LeaseCommand` and `WorldLaunch` share GPU preflight, unreserved before acquisition, then bounded reservation under the hold and release before retry. Heavy work admits with its lease held. The total caller deadline includes acquisition and admission. |\n| Bound a measurement window | `OperationDeadline` in `Puck.Abstractions`, owned by `MeasureCommand` | One clock and cancellation lifetime covers acquisition, settling and draining. `MeasureCommand.DrainAsync` checks it before each request and sample, and incomplete requests remain pending. `CliProcess.RunCapturedAsync` stops and reaps the active child tree before the quiet hold is disposed. |\n| Recover abandoned lease metadata | `CliLease.PruneReleased` in `Puck.Cli.Core` | Inspection and quiet-priority checks share cleanup under the resource's exclusive guard. Acquisition already replaces metadata once it owns that same guard; process identity and metadata age never override a free guard. |\n| Pause a suite budget while waiting for another run | `SuiteBudget` in `Puck.Cli.Core` | Sweep, motion, frame benchmarks and offscreen legs share remaining-time calculation, cancellation and scoped pauses. Offscreen callers lend their existing suite stopwatch. Canary's concurrent leg context already uses `CliProcess.RemainingBudget`; it does not pause a shared clock while other legs run. |\n| Enumerate the live console vocabulary across boot shapes | `WorldConsoleVerbs.TryEnumerate` in `Puck.Cli.Harness` | `verbs` and `docs citations` read the structured `world.affordances` manifest. The catalog excludes authored commands; citation checking includes them. |\n| Sample and judge host headroom | `HostAdmission`, `HostProbe`, `HostStartTracker` in `Puck.Cli.Harness\u002FHost` | `WorldAdmission` installs real admission by default, including standalone `Puck.Cli.Worlds`. `Install` is a test override; no entry point needs to remember an install call. |\n| Turn captured processes into gate outcomes | `GateStepResult.Captured` | Gate execution and lock restore preserve merged stream order, refusal exit on timeout, and one timeout annotation. |\n\nThe framework-facade MSBuild task runs before Puck projects build; a project\nreference to the runtime CLI would create a bootstrap dependency and target the\nwrong runtime. Shared source is intentional. Add a new shared build source to\nthe task's compiler inputs and its assembly-cache identity together.\n\nAdmission's guarantee stops at a lease share: releasing one `WorldGpuHold`\nshare does not release another live start's share. Cross-process growth\nreservations also remain process-local; machine leases serialize device and\nheavy starts. Do not describe those reservations as machine-wide exclusion.\n\nThis map earns its place by naming the cross-assembly homes and distinctions a\nname search misses: declared versus resolved references, assembly versus build\nedges, compiler dependencies versus Puck-only warmup, and bootstrap versus\ninstalled CLI execution. Update it with a move or a new caller.\n","# Build and CLI tooling\n\nLoad [verification](..\u002Fverification\u002FSKILL.md) for builds, private CLI copies and\nleases, and [symbol-analysis](..\u002Fsymbol-analysis\u002FSKILL.md) for finding callers.\n[CI and releases](..\u002F..\u002F..\u002Fdocs\u002Fdevelopment\u002Fci.md) owns repository automation;\nthe [CLI reference](..\u002F..\u002F..\u002Fdocs\u002Freference\u002Fcli.md) owns verb behavior.\nFile publication, paths, Git inventories, project ownership and Markdown parsing route to\n[tooling-files](..\u002Ftooling-files\u002FSKILL.md).\n\n| Capability | Shared home | Callers and boundary |\n|---|---|---|\n| Parse project declarations and evaluate architecture policy | `ArchitectureModel` in `build\u002FProjectArchitecture.cs` | The build task and `Puck.Cli.Core` compile this source. MSBuild supplies evaluated policy and resolved references; `ArchitectureCommand` supplies declared facts. Keep resolved-route enforcement (`PUCKARCH006`) in `PuckArchitectureGate`. A declared report cannot prove resolved references. |\n| Walk project dependencies | [ArchitectureGraph](..\u002F..\u002F..\u002Fbuild\u002FProjectArchitecture.cs) | Architecture closures follow assembly edges; affected and shader selection follow all build references. Choose the edge set; share the walk. |\n| Traverse assemblies for derivation identity | `AssemblyReach.Of` | The default follows `Puck.*`; `WorldCompileCache` includes all non-framework compiler dependencies and records missing trimmed modules. `WorldCodeWarmer` uses the same walk. Keep identity folds with their derivations. |\n| Splice generated document sections | `CliGeneratedSection.TryReplace` | Packages and the architecture map preserve delimiters and surrounding text, then use `CliGeneratedFile.WriteOrCheck`, including index agreement. |\n| Install an isolated CLI candidate | `CandidateCliInstall` in `build\u002FCandidateCliInstall.cs` | Compiled into `Puck.Cli.Release` and run as a file-based bootstrap by `setup-puck`, before a CLI exists. One exclusive feed, private package cache, fresh tool path and version check. The CLI supplies `CliProcess`; bootstrap `Main` supplies process I\u002FO only. |\n| Acquire and admit leased work | `LeasedAdmission.AcquireAsync` in `Puck.Cli.Core` | `LeaseCommand` and `WorldLaunch` share GPU preflight, unreserved before acquisition, then bounded reservation under the hold and release before retry. Heavy work admits with its lease held. The total caller deadline includes acquisition and admission. |\n| Bound a measurement window | `OperationDeadline` in `Puck.Abstractions`, owned by `MeasureCommand` | One clock and cancellation lifetime covers acquisition, settling and draining. `MeasureCommand.DrainAsync` checks it before each request and sample, and incomplete requests remain pending. `CliProcess.RunCapturedAsync` stops and reaps the active child tree before the quiet hold is disposed. |\n| Recover abandoned lease metadata | `CliLease.PruneReleased` in `Puck.Cli.Core` | Inspection and quiet-priority checks share cleanup under the resource's exclusive guard. Acquisition already replaces metadata once it owns that same guard; process identity and metadata age never override a free guard. |\n| Pause a suite budget while waiting for another run | `SuiteBudget` in `Puck.Cli.Core` | Sweep, motion, frame benchmarks and offscreen legs share remaining-time calculation, cancellation and scoped pauses. Offscreen callers lend their existing suite stopwatch. Canary's concurrent leg context already uses `CliProcess.RemainingBudget`; it does not pause a shared clock while other legs run. |\n| Enumerate the live console vocabulary across boot shapes | `WorldConsoleVerbs.TryEnumerate` in `Puck.Cli.Harness` | `verbs` and `docs citations` read the structured `world.affordances` manifest. The catalog excludes authored commands; citation checking includes them. |\n| Sample and judge host headroom | `HostAdmission`, `HostProbe`, `HostStartTracker` in `Puck.Cli.Harness\u002FHost` | `WorldAdmission` installs real admission by default, including standalone `Puck.Cli.Worlds`. `Install` is a test override; no entry point needs to remember an install call. |\n| Turn captured processes into gate outcomes | `GateStepResult.Captured` | Gate execution and lock restore preserve merged stream order, refusal exit on timeout, and one timeout annotation. |\n\nThe framework-facade MSBuild task runs before Puck projects build; a project\nreference to the runtime CLI would create a bootstrap dependency and target the\nwrong runtime. Shared source is intentional. Add a new shared build source to\nthe task's compiler inputs and its assembly-cache identity together.\n\nAdmission's guarantee stops at a lease share: releasing one `WorldGpuHold`\nshare does not release another live start's share. Cross-process growth\nreservations also remain process-local; machine leases serialize device and\nheavy starts. Do not describe those reservations as machine-wide exclusion.\n\nThis map earns its place by naming the cross-assembly homes and distinctions a\nname search misses: declared versus resolved references, assembly versus build\nedges, compiler dependencies versus Puck-only warmup, and bootstrap versus\ninstalled CLI execution. Update it with a move or a new caller.\n",{"name":5,"description":7},"main","2ef814b84c9595144e052c6dcd300badb619ee2f",".claude\u002Fskills\u002Ftooling",0,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck","https:\u002F\u002Fgithub.com\u002FByteTerrace","https:\u002F\u002Fbyteterrace.com","2026-11-12 13:59:16",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add ByteTerrace\u002FPuck --skill tooling",{"tool":37,"command":38},"bunx","bunx skills add ByteTerrace\u002FPuck --skill tooling",{"tool":40,"command":41},"pnpm","pnpm dlx skills add ByteTerrace\u002FPuck --skill tooling","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftooling\u002FSKILL.md",true,[45,51],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"evals\u002Fshared-admission\u002Fgraders\u002Fshared-homes.md","REFERENCE","参考文档",486,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftooling\u002Fevals\u002Fshared-admission\u002Fgraders\u002Fshared-homes.md",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"evals\u002Fshared-admission\u002Fprompt.md",475,"https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftooling\u002Fevals\u002Fshared-admission\u002Fprompt.md",[56,63,70,77,84,91],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":18},"01M75V6X1GBYDMSMJC8VXXPFAP","verification","Verifies Puck changes: landing bar, builds, stale DLLs, flaky tests, GPU\u002Fheavy leases, coverage, source-scan or regex laws versus type\u002Fcompiler enforcement, and writing tests.","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fverification\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":18},"01M75V6R4E6AY73X27MC6EE5X5","tooling-files","Maps shared repository tooling for files, paths, Git queries, project ownership and Markdown fences. Load before adding or changing a helper in these areas.","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftooling-files\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":18},"01M75V6N2P9XWWPH7EHRKMBTEC","symbol-analysis","Answers C# structure questions with puck references and declarations: which types derive from, implement or override a symbol, who references it, safe to delete or rename. Text: content-search.","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fsymbol-analysis\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":18},"01M75V6HRKM57BD8Q7A4N8QN0C","state","Maps Puck's state and rule engine (Puck.State, .Rules, .Search, .Topology, .Vectors, .Generators): arena, journal scopes, undo, hashing, rule compiler, faults, transforms, search, draws.","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fstate\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":18},"01M75V6CE3X73KNZYFRT9A5W8F","sdf-authoring","Authors creations: shape rows, primitives, blends, folds, palettes, paints, render lanes, rigs, bake work and bytes, creation stats. Use to sculpt or fix a part. Grammar: puck-dsl; GPU: rendering.","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fsdf-authoring\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":18},"01M75V695VX158KAVEV7987QQQ","rom-forge","Authors and compiles Puck cartridges (puck.cartridge.v1, *.cgb.puck, *.dmg.puck, *.agb.puck, forge.play, forge.open, puck compile --validate), native compilers, cost. Emulator core is gaming-bricks.","https:\u002F\u002Fgithub.com\u002FByteTerrace\u002FPuck\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002From-forge\u002FSKILL.md",[],[]]