[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DGVE6NVBACPDFZRJ89CEYT":3,"skill-same:01M7DGVE6NVBACPDFZRJ89CEYT":44},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M7DGVE6NVBACPDFZRJ89CEYT","service-spec",null,"Use for any task whose prompt is a multi-part spec for a service, API, or CLI built up over successive parts (part 1, part 2, ... each adding or changing behavior). Guides literal reading of the spec and the choices to make where it is silent.","jemdiggity\u002Fkojo","jemdiggity","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1940552?v=4","01M7DGK797SRB0B74KVSKQ44GZ","Jeremy Hale","01M7DGK7ABQPV6AA6CPDC2NNP7",0,"MIT","https:\u002F\u002Fgithub.com\u002Fjemdiggity\u002Fkojo\u002Fblob\u002Fmain\u002Fskills\u002Fsonnet-dcs\u002Fround2\u002Fd2c-alias\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: service-spec\ndescription: Use for any task whose prompt is a multi-part spec for a service, API, or CLI built up over successive parts (part 1, part 2, ... each adding or changing behavior). Guides literal reading of the spec and the choices to make where it is silent.\n---\n\n# Service from a multi-part spec\n\n## Base rules\n- Read every error\u002Fcondition sentence literally. \"Returns X when Y\" defines exactly the set Y. Do not widen Y to similar situations, and do not add error branches no sentence licenses.\n- When the spec is silent, pick the behavior that keeps earlier parts' worked examples and tests passing unchanged. Earlier behavior is the tie-breaker, not \"the more coherent design\".\n- A guess that changes an earlier part's output is wrong by default. Do not document a guess as the decision; change the guess.\n\n## Empty-state walk-through (do this before coding each part)\nTrace the first use of every new workflow from an empty store, in three steps: (a) identity does not exist; (b) identity exists but the thing being read has not been set yet; (c) after the first write\u002Ftransition. Do this for each read a new write depends on, including reads defined in earlier parts. Decide what each read returns at each step before writing handlers.\n- A read of current state returns not-found only for the exact condition the spec names, normally \"the identity itself does not exist\".\n- When the identity exists but the value has not been set yet, respond with success and an explicit, typed, empty representation of \"nothing yet\". This is a normal state, not an error. Do not reuse the not-found path for it.\n- A not-found in state (b) is a bug in the read: fix the read, do not document it.\n- A create\u002Ftransition path that \"starts from the current value\" must work on step (b): the current value is the typed empty sentinel, and the operation proceeds from it.\n\n## Type-stable sentinels\n- A field the spec documents as an integer is an integer in every response and every accepted input, including the \"none yet\" case. If numbering starts at 1, the pre-first value is 0. Never null, never absent, never a string.\n- Same rule for every type: lists are empty lists, not null; booleans are true\u002Ffalse, not null.\n- If you are about to write null for a numeric field, stop and use the integer below the first real value.\n- Inputs accept the same sentinel the reads emit, so a client can echo a read straight back into a write. Treat the sentinel in a request exactly as \"start from nothing\".\n- Keep sentinel handling in one helper (e.g. `current_or_zero(...)`) so every endpoint agrees.\n\n## Alias every route and parameter spelling\n- When a later part writes an existing route differently (trailing slash, singular vs plural, hyphen vs underscore, segment order, casing, a prefix added or dropped), serve every spelling with the same handler. Never replace the old spelling.\n- Grep the whole prompt for each path and register each variant seen. Cheap to add, expensive to miss.\n- Same for parameter names: if a later part spells a query or body key differently, accept both and map them to one internal name.\n\n## Verify before finishing a part\nFor each read a new write depends on, including reads defined in earlier parts, curl the three states (unknown identity; known identity with nothing set; after first write). Confirm: only state (a) is not-found; state (b) is a success body; every numeric field is a JSON number in all three. A not-found in state (b) is a bug: fix the read and re-curl. Curl each route in every spelling the prompt uses and confirm they return the same body. Throwaway commands only; no test files, no notes files.\n","# Service from a multi-part spec\n\n## Base rules\n- Read every error\u002Fcondition sentence literally. \"Returns X when Y\" defines exactly the set Y. Do not widen Y to similar situations, and do not add error branches no sentence licenses.\n- When the spec is silent, pick the behavior that keeps earlier parts' worked examples and tests passing unchanged. Earlier behavior is the tie-breaker, not \"the more coherent design\".\n- A guess that changes an earlier part's output is wrong by default. Do not document a guess as the decision; change the guess.\n\n## Empty-state walk-through (do this before coding each part)\nTrace the first use of every new workflow from an empty store, in three steps: (a) identity does not exist; (b) identity exists but the thing being read has not been set yet; (c) after the first write\u002Ftransition. Do this for each read a new write depends on, including reads defined in earlier parts. Decide what each read returns at each step before writing handlers.\n- A read of current state returns not-found only for the exact condition the spec names, normally \"the identity itself does not exist\".\n- When the identity exists but the value has not been set yet, respond with success and an explicit, typed, empty representation of \"nothing yet\". This is a normal state, not an error. Do not reuse the not-found path for it.\n- A not-found in state (b) is a bug in the read: fix the read, do not document it.\n- A create\u002Ftransition path that \"starts from the current value\" must work on step (b): the current value is the typed empty sentinel, and the operation proceeds from it.\n\n## Type-stable sentinels\n- A field the spec documents as an integer is an integer in every response and every accepted input, including the \"none yet\" case. If numbering starts at 1, the pre-first value is 0. Never null, never absent, never a string.\n- Same rule for every type: lists are empty lists, not null; booleans are true\u002Ffalse, not null.\n- If you are about to write null for a numeric field, stop and use the integer below the first real value.\n- Inputs accept the same sentinel the reads emit, so a client can echo a read straight back into a write. Treat the sentinel in a request exactly as \"start from nothing\".\n- Keep sentinel handling in one helper (e.g. `current_or_zero(...)`) so every endpoint agrees.\n\n## Alias every route and parameter spelling\n- When a later part writes an existing route differently (trailing slash, singular vs plural, hyphen vs underscore, segment order, casing, a prefix added or dropped), serve every spelling with the same handler. Never replace the old spelling.\n- Grep the whole prompt for each path and register each variant seen. Cheap to add, expensive to miss.\n- Same for parameter names: if a later part spells a query or body key differently, accept both and map them to one internal name.\n\n## Verify before finishing a part\nFor each read a new write depends on, including reads defined in earlier parts, curl the three states (unknown identity; known identity with nothing set; after first write). Confirm: only state (a) is not-found; state (b) is a success body; every numeric field is a JSON number in all three. A not-found in state (b) is a bug: fix the read and re-curl. Curl each route in every spelling the prompt uses and confirm they return the same body. Throwaway commands only; no test files, no notes files.\n",{"name":5,"description":7},"main","90c4e234b13d749b2f69ddcb1c759e5f667f6413","skills\u002Fsonnet-dcs\u002Fround2\u002Fd2c-alias","https:\u002F\u002Fgithub.com\u002Fjemdiggity\u002Fkojo","https:\u002F\u002Fgithub.com\u002Fjemdiggity","2026-11-01 06:04:44",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add jemdiggity\u002Fkojo --skill service-spec",{"tool":36,"command":37},"bunx","bunx skills add jemdiggity\u002Fkojo --skill service-spec",{"tool":39,"command":40},"pnpm","pnpm dlx skills add jemdiggity\u002Fkojo --skill service-spec","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjemdiggity\u002Fkojo\u002Fblob\u002Fmain\u002Fskills\u002Fsonnet-dcs\u002Fround2\u002Fd2c-alias\u002FSKILL.md",true,[],[45,51,56,61,66,71],{"skillNo":46,"name":5,"nameZh":6,"description":47,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":48,"categories":49,"keywords":50,"publishedAt":19},"01M7DGWAMS2Z08G9S6KYEBM4YG","Invoke before reading any code, for any task whose prompt is a multi-part spec for a service, API or CLI built up over successive parts (part 1, part 2, ... each adding or changing behavior). Apply its rules while reading the spec literally and while choosing behavior where the spec is silent.","https:\u002F\u002Fgithub.com\u002Fjemdiggity\u002Fkojo\u002Fblob\u002Fmain\u002Fskills\u002Fsonnet-dcs\u002Fround3\u002Fd3e-accept\u002FSKILL.md",[],[],{"skillNo":52,"name":5,"nameZh":6,"description":47,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M7DGW5T9M4EXVHNTNW1NY6MR","https:\u002F\u002Fgithub.com\u002Fjemdiggity\u002Fkojo\u002Fblob\u002Fmain\u002Fskills\u002Fsonnet-dcs\u002Fround3\u002Fd3d-exact-words\u002FSKILL.md",[],[],{"skillNo":57,"name":5,"nameZh":6,"description":47,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M7DGW1S560QM0M72BSYP42XB","https:\u002F\u002Fgithub.com\u002Fjemdiggity\u002Fkojo\u002Fblob\u002Fmain\u002Fskills\u002Fsonnet-dcs\u002Fround3\u002Fd3c-omit\u002FSKILL.md",[],[],{"skillNo":62,"name":5,"nameZh":6,"description":47,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M7DGVXQS07PEJQBS7VJC9B7R","https:\u002F\u002Fgithub.com\u002Fjemdiggity\u002Fkojo\u002Fblob\u002Fmain\u002Fskills\u002Fsonnet-dcs\u002Fround3\u002Fd3b-inherit\u002FSKILL.md",[],[],{"skillNo":67,"name":5,"nameZh":6,"description":47,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7DGVSEXFX35NZPSPBN9833Q","https:\u002F\u002Fgithub.com\u002Fjemdiggity\u002Fkojo\u002Fblob\u002Fmain\u002Fskills\u002Fsonnet-dcs\u002Fround3\u002Fd3a-gate-lean\u002FSKILL.md",[],[],{"skillNo":72,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M7DGVNNTDB3EGQHJXTNM986H","https:\u002F\u002Fgithub.com\u002Fjemdiggity\u002Fkojo\u002Fblob\u002Fmain\u002Fskills\u002Fsonnet-dcs\u002Fround2\u002Fd2e-lean\u002FSKILL.md",[],[]]