Rewrite the Skills repository guide

[raghubetina]

Summary\n- orient developers and agents around the portable Skill, schema, evaluations, and release owners\n- keep tester onboarding routed to Drawing Board\n- make the release runbook own public install and exact CLI reproduction commands\n\n## Verification\n- Skills release compatibility metadata is valid.

Claude plugin package is deterministic and valid.
✔ inventory entries admit only directories and regular files (2.623583ms)
✔ component inventory parser accepts one ANSI-decorated count per group (3.69ms)
✔ Claude Code version parser requires the observed native CLI format (0.33075ms)
✔ plugin command boundary passes only the exact environment and isolated cwd (0.195292ms)
✔ plugin command boundary preserves start and exit failures (0.359334ms)
✔ native executable resolution requires an executable native file (92.697292ms)
✔ manifest validation evidence comes from the exact successful invocation (7.9585ms)
✔ observation evidence rejects embedded host absolute paths (0.982667ms)
✔ manifest validation evidence rendering uses observed normalized fields (0.12425ms)
✔ state-presence rendering has one explicit empty representation (0.137875ms)
✔ committed comparison excludes run-local observation state (0.144583ms)
✔ registry reconciliation compares package contents instead of tgz bytes (3.530375ms)
✔ registry reconciliation rejects inventory, byte, and mode drift (7.114875ms)
✔ registry reconciliation rejects links and special tar entries (0.627667ms)
✔ registry reconciliation rejects ambiguous package paths (0.614625ms)
✔ candidate protocol defines interview coverage and complete-candidate readiness (14.338833ms)
✔ home-inventory corpus case probes consequential ambiguity without invented answers (4.269834ms)
✔ packaged interview guidance keeps the opening turn focused on one product candidate (2.445958ms)
✔ packaged workflow requires one exact semantic approval before a publish-capable Compile (1.038042ms)
✔ pre-Compile evals separate approval, diagnostics, and execution (3.434333ms)
✔ evaluation harness exposes the representative Movie Catalog fixture (0.66125ms)
✔ stagedInputs selects only staged input artifacts (0.2415ms)
✔ evaluationCaseById rejects a missing case (0.252541ms)
✔ default real-state labels reject parent location overrides (1.477084ms)
✔ isolated plugin commands receive only the explicit environment (17.463416ms)
✔ changed-state diagnostics include resolved absolute monitored paths (0.168333ms)
✔ path entry presence does not mistake dangling links for absence (55.287291ms)
✔ target state snapshots detect nested changes and reject links (87.902958ms)
✔ release order accepts one current tag after older public identities (3.001541ms)
✔ release order rejects a reused or decreasing public version (0.949042ms)
✔ release order requires one current protected tag after all prior tags (0.615458ms)
✔ prospective release order accepts zero or older protected tags (0.217042ms)
✔ prospective release order reconciles consumed current identities (0.124792ms)
✔ prospective release order rejects incoherent current identities (0.264125ms)
✔ catalog reconciliation reads npm, fetched tags, and the catalog (21.182042ms)
✔ default publish reconciliation rejects an already-promoted catalog (59.550125ms)
✔ consumed release order binds compatibility bytes to the protected tag (51.248209ms)
✔ release compatibility matches the installable plugin manifest (8.677083ms)
✔ current release docs route through structured identities (5.253333ms)
✔ approval-flow docs define the lightweight human-observed smoke (3.071541ms)
✔ dated release-state observation retains its recorded facts (1.000542ms)
✔ release compatibility rejects shape and manifest drift (4.586833ms)
✔ release compatibility uses strict semantic versions (0.163292ms)
✔ current candidates use ordinary pre-1.0 versions (0.070583ms)
✔ semantic-version precedence orders ordinary and historical versions (0.255ms)
✔ archived release chronology retains exact observed facts (57.060667ms)
✔ documentation roles are routed and retrieval-sized (44.510791ms)
✔ revision pins remain exhaustive across coordination surfaces (12.427125ms)
✔ immutable plugin teaching lag distinguishes fixed and retained claims (39.105459ms)
✔ fresh Claude Code evidence is exact and bounded (111.369917ms)
✔ local-directory plugin evidence remains revision-scoped (1.567958ms)
✔ installable Skills follow the portable repository profile (14.954334ms)
✔ Claude Code packaging reuses the portable Skill exactly once (38.22525ms)
✔ repository inventory traverses .git directories and rejects unsafe .git entries (1.413834ms)
✔ CI checks the exact modular CLI contract (4.447667ms)
✔ behavioral eval cases are well-formed and reference real fixtures (2.654125ms)
✔ authored JSON examples parse and retain the pinned Plan contract (5.488334ms)
✔ bounded importer prose remains bound to the exact allowlists (8.609708ms)
✔ validator routing preserves validation boundaries (1.401625ms)
✔ complete examples and eval Plans validate against the bundled exact schema (132.729125ms)
✔ revision evals stage existing Plan identity and private state (1.270167ms)
✔ subject identity evals use the public UUID generator (1.013875ms)
✔ bounded import evals bind supported and unsupported Plan state (2.982292ms)
✔ local capability check is shell-portable and uses the project wrapper (2.291916ms)
✔ analysis status guidance follows the pinned CLI contract (6.836458ms)
✔ product Compile and retained Compilation evals match the CLI contract (4.284042ms)
✔ recovery evals stage and preserve existing Plan state (1.2585ms)
✔ initialization recovery consumes the prepared CLI error envelope (1.031375ms)
✔ malformed source fixture is bound to its coordinate diagnostic (0.769834ms)
✔ the independently installed Skill retains the repository license (0.375833ms)
ℹ tests 70
ℹ suites 0
ℹ pass 70
ℹ fail 0
ℹ cancelled 0
ℹ skipped 0
ℹ todo 0
ℹ duration_ms 674.984833\n- \n- author-context and independent documentation reviews approved