[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75Y3C1EPHSXREPCB707HS2D":3,"skill-same:01M75Y3C1EPHSXREPCB707HS2D":116},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":25,"repositoryHtmlUrl":26,"repositoryHomepageUrl":27,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M75Y3C1EPHSXREPCB707HS2D","contracts",null,"STiFLeR7\u002Fpinocchio","STiFLeR7","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F157357792?v=4","01M75Y38BH3EZYAKZRTEST9Y8K","Hill Patel","01M75Y38CARNP46D9C5Y3XPVWF",2,"MIT","https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002Fskill.md",[],[],"2026-11-12 13:55:43",false,"# Skill — Canonical Logical Contract\n\nStatus: Frozen (Phase 0 contract freeze)\nObject: Skill · Primary source: `docs\u002Fv2\u002F06_SKILLS.md` · Binding ADRs: ADR-002, ADR-004\n\n> A logical, implementation-independent specification. Fields are logical\n> (name + meaning + required\u002Foptional), never wire\u002Ftyped definitions. No\n> serialization, storage, API, or code is implied here.\n\n---\n\n## 1. Purpose\n\nA Skill is a **reusable, runtime-independent operational procedure** — it\ncaptures *how* a type of work should be performed, encapsulating operational\nexpertise rather than implementation details. A Skill describes the methodology\n(phases, checkpoints, expected transitions) without binding to any runtime,\nmodel, tool, or provider.\n\nSkills bridge operator goals and execution engines (`06`): they are the building\nblocks Planning composes and Work Packaging packages. The **same Skill runs on\nany runtime unchanged** (INV-33). Skills are *procedures*; Capabilities are\n*functionality* — distinct objects (ADR-002 §D).\n\n---\n\n## 2. Ownership\n\n- **Produced \u002F owned by:** the **Skill Registry** (ADR-002 — the authoritative\n  registry of reusable operational procedures). It owns Skill definitions,\n  versions, composition references, and required context. The registry does not\n  execute (`06`).\n- **State transitions owned by:** the Skill Registry (definitional lifecycle:\n  registration, versioning, deprecation). The per-operation *execution* lifecycle\n  of a selected Skill is owned by the execution\u002Forchestration layers, projected\n  from the Event Log (ADR-001).\n- **Consumed by:**\n  - **Skill Selection** — determines which Skills satisfy required Capabilities,\n    considering capability, context, constraints, and evidence requirements;\n    **never considers runtimes** (`06`).\n  - **Work Packaging** — packages selected Skills (with resolved context and\n    strategy) into Work Packages for Execution.\n- **Validation\u002FRecovery declaration vs. evaluation (ADR-004 §3.4):** a Skill\n  *declares* default Validation and Recovery strategies, but it **never owns**\n  their evaluation. Validation *verdicts* are owned by the **Validation layer**;\n  Recovery *strategy selection* is owned by **Recovery**. Declaration ≠ evaluation.\n\n---\n\n## 3. Lifecycle\n\nThe Skill **definition** is versioned and append-only in the registry. A\n*selected* Skill instance moves through an execution lifecycle whose state is a\nprojection of the Event Log (ADR-001); every transition emits exactly one Event\n(INV-15).\n\n```\nRegistered → Selected → Prepared → Executing → Validated → Completed\n```\n\n**Failure \u002F terminal states:**\n\n```\nBlocked · Failed · Cancelled · Expired\n```\n\n- **Registered** — published in the Skill Registry, discoverable for selection.\n- **Selected** — chosen by Skill Selection to satisfy required Capabilities.\n- **Prepared** — Required Context assembled by Context Engineering; packaged.\n- **Executing** — performed by an assigned runtime (the Skill itself is runtime-\n  independent — INV-33).\n- **Validated → Completed** — completion is determined by the Validation layer\n  from independent Evidence, never by runtime self-report (INV-20, INV-21).\n\nDefinition versions are immutable once published; change means a new version\n(ADR-001 additive evolution).\n\n---\n\n## 4. Required Fields\n\n| Field | Meaning |\n|-------|---------|\n| **Identity** | Stable identifier + human-readable Name; participates in correlation\u002Ftrace lineage. |\n| **Version** | Definition version. Skills version independently as procedures (ADR-002 §D). |\n| **Purpose** | The operational capability this Skill provides — what work it knows how to perform. |\n| **Inputs** | Required information to perform the procedure (e.g. repository, research question, document, workspace, context package) — logical roles, not wire schemas. |\n| **Outputs** | Expected deliverables (e.g. report, implementation, summary, review, documentation) — logical roles. |\n| **Procedure** | The operational methodology: **phases, checkpoints, and expected transitions**, described **without binding to any runtime** (INV-33). |\n\n---\n\n## 5. Optional Fields\n\n| Field | Meaning |\n|-------|---------|\n| **Required Context** | What Context Engineering must provide before execution (e.g. repository, architecture, historical decisions, research sources, existing tasks). Drives context assembly during Prepared. |\n| **Constraints** | Operational boundaries inherent to the procedure: approval required, budget, security, workspace restrictions, deadlines, quality requirements (`06`). Declarative; enforcement is Governance\u002FOrchestration. |\n| **Validation Strategy (default)** | The procedure's **default** approach to verifying completion (e.g. tests, review, evidence, generated artifacts, independent verification). A **default that Execution Strategy may override** (ADR-004 §3.4). Evaluation is the Validation layer's, not the Skill's. |\n| **Recovery Strategy (default)** | The procedure's **default** expected behavior on failure (e.g. retry, escalate, request context, pause, human review). A **default that Execution Strategy may override** (ADR-004 §3.4). Strategy *selection* at runtime is Recovery's. |\n| **Category** | Logical grouping (e.g. Analysis, Development, Documentation, Operations, Personal) — taxonomy only. |\n| **Composition References** | Other Skills this Skill composes with (`06` Skill Composition). References by Skill Identity\u002Fversion. |\n| **Required Capabilities** | The Capabilities this Skill needs to be satisfiable (references into `capability.md`); one Skill may require multiple Capabilities. |\n| **Metadata** | Non-authoritative descriptive attributes (tags, compatibility notes, documentation links). |\n\n---\n\n## 6. Invariants\n\n- **INV-33** — Skills describe operational capability, **never runtime\n  implementation**; the same Skill runs on any runtime unchanged. The Procedure\n  binds to no runtime, model, tool, or provider. *(Binding for this contract.)*\n- **ADR-004 §3.4 (precedence)** — When a Skill and an Execution Strategy both\n  carry validation\u002Frecovery guidance: **Governance\u002FPolicy (hard constraints) →\n  Execution Strategy → Skill default**. Skill validation\u002Frecovery are\n  **overridable defaults**, not authority.\n- **Declaration ≠ evaluation** — Validation *verdicts* are owned by the\n  Validation layer; Recovery *strategy selection* by Recovery. A Skill only\n  *declares* defaults (ADR-004 §3.4; INV-20, INV-21).\n- **INV-07** — Exactly one canonical Skill schema; Skills are not redefined as\n  Capabilities or Harnesses (ADR-002 §D, alternative D rejected).\n- **Selection runtime-blindness** — Skill Selection never considers runtimes\n  (`06`); a Skill carries no runtime\u002Fprovider field.\n- **Composition closure** — every Composition Reference and Required Capability\n  resolves to an existing Skill \u002F Capability (no dangling references).\n- **INV-15 \u002F INV-13** — every execution-lifecycle transition of a selected Skill\n  emits exactly one Event; its state is a projection of the authoritative log.\n\n---\n\n## 7. Relationships\n\n- **`capability.md`** — A Skill *requires* one or more Capabilities; one\n  Capability may support many Skills (`06`, `21`). Skills are procedures;\n  Capabilities are functionality (ADR-002 §D).\n- **`execution_strategy.md`** — **authoritative over** the Skill for the\n  operation: it may override the Skill's default Validation\u002FRecovery guidance\n  (ADR-004 §3.4). The Strategy declares coordination; Orchestration enacts it.\n- **`work_package.md`** — Work Packaging packages selected Skills (with resolved\n  context + strategy) into Work Packages; Execution receives only Work Packages\n  (INV-09, INV-19), never raw Skills or Goals.\n- **`policy.md`** — Governance\u002FPolicy hard constraints sit **above** Skill\n  defaults in the precedence order (ADR-004 §3.4); governed actions fail closed\n  (INV-30).\n- **`context_package.md`** — a Skill's *Required Context* drives what Context\n  Engineering assembles before the Prepared state.\n- **Harness Registry \u002F runtimes** — a Skill names no runtime; runtimes are\n  selected by Orchestration over resolved capability candidates (INV-37), and the\n  same Skill executes on any of them unchanged.\n\n---\n\n## 8. Versioning Rules\n\n- Evolution is **additive**: new optional fields, new Skill versions, or new\n  Skills. Published `(Identity, Version)` definitions are immutable.\n- A **new Version** is required for any change to Purpose, Inputs\u002FOutputs meaning,\n  Procedure phases\u002Fcheckpoints, or Required Capabilities that alters what a\n  consumer (Selection\u002FWork Packaging) expects.\n- **Validation\u002FRecovery default** changes are versioned additively; because they\n  are *overridable defaults* (ADR-004 §3.4), changing them never alters the\n  precedence contract (Governance → Execution Strategy → Skill).\n- **Category, Composition References, Metadata** may be extended additively\n  without a new object version when no consumer guarantee changes.\n- Skills version **independently** of Capabilities, runtimes, and providers\n  (ADR-002 §D); runtime support is never recorded on the Skill.\n- Old versions remain **selectable and replayable** until deprecated\u002Fretired;\n  historical references in past Work Packages\u002Fevents stay valid forever (ADR-001\n  event upcasting).\n",{},"master","41869c68f2cf32aaaad88d62ad9e68defbe4e432","engine-room\u002Fcontracts",0,"https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio","https:\u002F\u002Fpinocchio.stifler.in","https:\u002F\u002Fgithub.com\u002FSTiFLeR7","stifler.in","AI Systems Engineer | Building Open-Source AI | Agentic AI","2026-10-26 23:06:11",{"source":7,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add STiFLeR7\u002Fpinocchio --skill contracts",{"tool":38,"command":39},"bunx","bunx skills add STiFLeR7\u002Fpinocchio --skill contracts",{"tool":41,"command":42},"pnpm","pnpm dlx skills add STiFLeR7\u002Fpinocchio --skill contracts","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002Fskill.md",true,[46,52,56,60,64,68,72,76,80,84,88,92,96,100,104,108,112],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"artifact.md","REFERENCE","参考文档",9386,"https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002Fartifact.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"capability.md",8227,"https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002Fcapability.md",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"checkpoint.md",9899,"https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002Fcheckpoint.md",{"path":61,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":62,"sourceHtmlUrl":63},"context_package.md",10148,"https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002Fcontext_package.md",{"path":65,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":66,"sourceHtmlUrl":67},"event.md",10020,"https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002Fevent.md",{"path":69,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":70,"sourceHtmlUrl":71},"execution_graph.md",10123,"https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002Fexecution_graph.md",{"path":73,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":74,"sourceHtmlUrl":75},"execution_strategy.md",8905,"https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002Fexecution_strategy.md",{"path":77,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":78,"sourceHtmlUrl":79},"goal.md",9477,"https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002Fgoal.md",{"path":81,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":82,"sourceHtmlUrl":83},"intent.md",9645,"https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002Fintent.md",{"path":85,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":86,"sourceHtmlUrl":87},"knowledge.md",12363,"https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002Fknowledge.md",{"path":89,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":90,"sourceHtmlUrl":91},"observation.md",9447,"https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002Fobservation.md",{"path":93,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":94,"sourceHtmlUrl":95},"plan.md",8891,"https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002Fplan.md",{"path":97,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":98,"sourceHtmlUrl":99},"policy.md",14731,"https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002Fpolicy.md",{"path":101,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":102,"sourceHtmlUrl":103},"README.md",4320,"https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002FREADME.md",{"path":105,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":106,"sourceHtmlUrl":107},"reflection.md",11826,"https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002Freflection.md",{"path":109,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":110,"sourceHtmlUrl":111},"resource.md",10067,"https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002Fresource.md",{"path":113,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":114,"sourceHtmlUrl":115},"work_package.md",12021,"https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fengine-room\u002Fcontracts\u002Fwork_package.md",[117,124],{"skillNo":118,"name":119,"nameZh":6,"description":120,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":121,"categories":122,"keywords":123,"publishedAt":18},"01M75Y3DEVQZ3M15S6R2KG52Q7","pinocchio","Explains Pinocchio receipts (PASS \u002F FAIL \u002F CAN'T TELL) and how to configure claim checking. Use when a Pinocchio receipt or block appears, or the user asks about Pinocchio settings.","https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fskills\u002Fpinocchio\u002FSKILL.md",[],[],{"skillNo":125,"name":126,"nameZh":6,"description":127,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":128,"categories":129,"keywords":130,"publishedAt":18},"01M75Y3AGE0F410BNXKVN5TV1T","verify-first","Use before claiming work is done or tests pass.","https:\u002F\u002Fgithub.com\u002FSTiFLeR7\u002Fpinocchio\u002Fblob\u002Fmaster\u002Fbench\u002Fplacebo\u002Fskills\u002Fverify-first\u002FSKILL.md",[],[]]