[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M755JCZRFHVK8HWHTQF5AFF7":3,"skill-same:01M755JCZRFHVK8HWHTQF5AFF7":45},{"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":28,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M755JCZRFHVK8HWHTQF5AFF7","design-an-interface",null,"Produce 3+ radically different designs for a module, API, or interface, compare them in prose, and synthesize a recommendation. Use when asked to \"design an interface\", \"shape this API\", \"design it twice\", \"explore module boundaries\", or when planning a new deep module and the first idea is unlikely to be the best. Based on \"Design It Twice\" from A Philosophy of Software Design — the value is the contrast, not the first draft.","eagle27272\u002Fgsd-pi","eagle27272","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F89469515?v=4","01M755FHJ96F4TC1WYYSGJ8D93","Mike","01M755FHKBQK52KMR81J0HEVR2",0,"MIT","https:\u002F\u002Fgithub.com\u002Feagle27272\u002Fgsd-pi\u002Fblob\u002Fmain\u002Fsrc\u002Fresources\u002Fskills\u002Fdesign-an-interface\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: design-an-interface\ndescription: Produce 3+ radically different designs for a module, API, or interface, compare them in prose, and synthesize a recommendation. Use when asked to \"design an interface\", \"shape this API\", \"design it twice\", \"explore module boundaries\", or when planning a new deep module and the first idea is unlikely to be the best. Based on \"Design It Twice\" from A Philosophy of Software Design — the value is the contrast, not the first draft.\n---\n\n\u003Cobjective>\nGenerate at least three radically different interface designs for a single module or API, present them sequentially, compare them honestly, and recommend one (or a hybrid). The goal is to surface the design space — not to pick fast. A small interface hiding significant complexity is a deep module; a large interface with thin implementation is a shallow one. Optimize for the former.\n\u003C\u002Fobjective>\n\n\u003Ccontext>\nThis skill runs during planning — before `S##-PLAN.md` task decomposition, or mid-slice when a seam turns out to be more load-bearing than the roadmap assumed. It is not for picking between two libraries. It is for shaping the interface your own code will expose.\n\nTypical invocation points:\n- A slice plan says \"add module X\" and the shape of X is not obvious.\n- Two callers are about to grow coupled to an interface that has not been designed on purpose.\n- A refactor surfaces a seam that needs to be re-cut deliberately.\n\u003C\u002Fcontext>\n\n\u003Ccore_principle>\n**RADICALLY DIFFERENT, NOT VARIANTS.** Three designs with different method names are one design. Three designs that hide different things, expose different axes of control, or invert the caller\u002Fcallee relationship are three designs. Enforce real divergence by assigning each sub-agent a constraint that would force a different shape.\n\n**INTERFACE, NOT IMPLEMENTATION.** Do not estimate effort. Do not argue about how hard it is to build. Argue about how the interface behaves from the caller's side and what it hides internally.\n\u003C\u002Fcore_principle>\n\n\u003Cprocess>\n\n## Step 1: Gather requirements\n\nBefore spawning anything, answer in the conversation:\n\n- What problem does the module solve?\n- Who calls it? (other modules, external users, tests)\n- What are the key operations?\n- What constraints exist? (performance, compatibility, existing patterns)\n- What should stay hidden inside vs be exposed?\n\nIf the user did not supply all of these, ask — one round, 1–3 questions max, per the ask-vs-infer rule.\n\n## Step 2: Spawn parallel design agents\n\nUse `Agent(subagent_type=general-purpose)` for 3–4 agents in one message so they run concurrently. Each agent gets the same requirements brief plus one divergent constraint:\n\n- Agent 1: \"Minimize method count — 1 to 3 entry points max.\"\n- Agent 2: \"Maximize flexibility — support many extension points and composition.\"\n- Agent 3: \"Optimize for the single most common caller — make the default case trivial and the advanced case possible.\"\n- Agent 4 (optional): \"Design around a ports-and-adapters boundary — interface is the port, concrete implementations are adapters.\"\n\nEach agent returns:\n\n1. Interface signature (types, methods, params)\n2. One worked usage example showing a real caller\n3. What complexity this design keeps internal\n4. Trade-offs — what it's bad at\n\n## Step 3: Present sequentially\n\nShow the three designs one after another. Let the user read each before the next. Do not lead with the comparison — the value is in feeling the shape of each option first.\n\n## Step 4: Compare in prose\n\nAfter all three are on the page, compare them on:\n\n- **Simplicity** — fewer methods and simpler params are easier to learn and harder to misuse\n- **Depth** — small interface hiding significant complexity (good) vs large interface with thin implementation (bad)\n- **Generality vs specialization** — does it cover the real use case without overfitting?\n- **Efficiency of the shape** — does the interface let the implementation be efficient, or force awkward internals?\n- **Misuse surface** — what can a caller do wrong?\n\nProse, not a table. Highlight where the designs diverge most sharply — that is where the interesting trade-off lives.\n\n## Step 5: Recommend\n\nBe opinionated. Pick one, or propose a hybrid that takes specific elements from multiple designs. State the reason in one paragraph. The user wants a strong read, not a menu.\n\n## Step 6: Capture the decision\n\nOnce the user picks:\n\n- Append to `.gsd\u002FDECISIONS.md` with the chosen shape and the reason.\n- If a slice is active, update `S##-CONTEXT.md` with the interface sketch.\n- Do not write the implementation — that happens during execute.\n\n\u003C\u002Fprocess>\n\n\u003Canti_patterns>\n\n- **Three-variants-of-the-same-idea:** all three use a builder, all three return the same object, etc. Kill and re-spawn.\n- **Implementation creep:** proposing file paths, call graphs, or internal data structures. Keep it at interface shape.\n- **Skipping comparison:** presenting three designs and asking \"which do you like?\" The comparison is the whole skill.\n- **Effort-based ranking:** \"#2 is easiest to build\" is not an interface argument. Rank by what the caller experiences.\n\n\u003C\u002Fanti_patterns>\n\n\u003Csuccess_criteria>\n\n- [ ] 3+ genuinely different interface shapes were produced.\n- [ ] Each design shows a real usage example, not a type signature in isolation.\n- [ ] Trade-offs are named per design.\n- [ ] A specific recommendation (or hybrid) is on the page with a reason.\n- [ ] The decision is captured in `.gsd\u002FDECISIONS.md` or the active `S##-CONTEXT.md`.\n\n\u003C\u002Fsuccess_criteria>\n","\u003Cobjective>\nGenerate at least three radically different interface designs for a single module or API, present them sequentially, compare them honestly, and recommend one (or a hybrid). The goal is to surface the design space — not to pick fast. A small interface hiding significant complexity is a deep module; a large interface with thin implementation is a shallow one. Optimize for the former.\n\u003C\u002Fobjective>\n\n\u003Ccontext>\nThis skill runs during planning — before `S##-PLAN.md` task decomposition, or mid-slice when a seam turns out to be more load-bearing than the roadmap assumed. It is not for picking between two libraries. It is for shaping the interface your own code will expose.\n\nTypical invocation points:\n- A slice plan says \"add module X\" and the shape of X is not obvious.\n- Two callers are about to grow coupled to an interface that has not been designed on purpose.\n- A refactor surfaces a seam that needs to be re-cut deliberately.\n\u003C\u002Fcontext>\n\n\u003Ccore_principle>\n**RADICALLY DIFFERENT, NOT VARIANTS.** Three designs with different method names are one design. Three designs that hide different things, expose different axes of control, or invert the caller\u002Fcallee relationship are three designs. Enforce real divergence by assigning each sub-agent a constraint that would force a different shape.\n\n**INTERFACE, NOT IMPLEMENTATION.** Do not estimate effort. Do not argue about how hard it is to build. Argue about how the interface behaves from the caller's side and what it hides internally.\n\u003C\u002Fcore_principle>\n\n\u003Cprocess>\n\n## Step 1: Gather requirements\n\nBefore spawning anything, answer in the conversation:\n\n- What problem does the module solve?\n- Who calls it? (other modules, external users, tests)\n- What are the key operations?\n- What constraints exist? (performance, compatibility, existing patterns)\n- What should stay hidden inside vs be exposed?\n\nIf the user did not supply all of these, ask — one round, 1–3 questions max, per the ask-vs-infer rule.\n\n## Step 2: Spawn parallel design agents\n\nUse `Agent(subagent_type=general-purpose)` for 3–4 agents in one message so they run concurrently. Each agent gets the same requirements brief plus one divergent constraint:\n\n- Agent 1: \"Minimize method count — 1 to 3 entry points max.\"\n- Agent 2: \"Maximize flexibility — support many extension points and composition.\"\n- Agent 3: \"Optimize for the single most common caller — make the default case trivial and the advanced case possible.\"\n- Agent 4 (optional): \"Design around a ports-and-adapters boundary — interface is the port, concrete implementations are adapters.\"\n\nEach agent returns:\n\n1. Interface signature (types, methods, params)\n2. One worked usage example showing a real caller\n3. What complexity this design keeps internal\n4. Trade-offs — what it's bad at\n\n## Step 3: Present sequentially\n\nShow the three designs one after another. Let the user read each before the next. Do not lead with the comparison — the value is in feeling the shape of each option first.\n\n## Step 4: Compare in prose\n\nAfter all three are on the page, compare them on:\n\n- **Simplicity** — fewer methods and simpler params are easier to learn and harder to misuse\n- **Depth** — small interface hiding significant complexity (good) vs large interface with thin implementation (bad)\n- **Generality vs specialization** — does it cover the real use case without overfitting?\n- **Efficiency of the shape** — does the interface let the implementation be efficient, or force awkward internals?\n- **Misuse surface** — what can a caller do wrong?\n\nProse, not a table. Highlight where the designs diverge most sharply — that is where the interesting trade-off lives.\n\n## Step 5: Recommend\n\nBe opinionated. Pick one, or propose a hybrid that takes specific elements from multiple designs. State the reason in one paragraph. The user wants a strong read, not a menu.\n\n## Step 6: Capture the decision\n\nOnce the user picks:\n\n- Append to `.gsd\u002FDECISIONS.md` with the chosen shape and the reason.\n- If a slice is active, update `S##-CONTEXT.md` with the interface sketch.\n- Do not write the implementation — that happens during execute.\n\n\u003C\u002Fprocess>\n\n\u003Canti_patterns>\n\n- **Three-variants-of-the-same-idea:** all three use a builder, all three return the same object, etc. Kill and re-spawn.\n- **Implementation creep:** proposing file paths, call graphs, or internal data structures. Keep it at interface shape.\n- **Skipping comparison:** presenting three designs and asking \"which do you like?\" The comparison is the whole skill.\n- **Effort-based ranking:** \"#2 is easiest to build\" is not an interface argument. Rank by what the caller experiences.\n\n\u003C\u002Fanti_patterns>\n\n\u003Csuccess_criteria>\n\n- [ ] 3+ genuinely different interface shapes were produced.\n- [ ] Each design shows a real usage example, not a type signature in isolation.\n- [ ] Trade-offs are named per design.\n- [ ] A specific recommendation (or hybrid) is on the page with a reason.\n- [ ] The decision is captured in `.gsd\u002FDECISIONS.md` or the active `S##-CONTEXT.md`.\n\n\u003C\u002Fsuccess_criteria>\n",{"name":5,"description":7},"main","a034c670a76777c39345ad63706b280ea0774427","src\u002Fresources\u002Fskills\u002Fdesign-an-interface","https:\u002F\u002Fgithub.com\u002Feagle27272\u002Fgsd-pi","https:\u002F\u002Fwww.opengsd.net","https:\u002F\u002Fgithub.com\u002Feagle27272","2026-11-06 03:33:29",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add eagle27272\u002Fgsd-pi --skill design-an-interface",{"tool":37,"command":38},"bunx","bunx skills add eagle27272\u002Fgsd-pi --skill design-an-interface",{"tool":40,"command":41},"pnpm","pnpm dlx skills add eagle27272\u002Fgsd-pi --skill design-an-interface","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Feagle27272\u002Fgsd-pi\u002Fblob\u002Fmain\u002Fsrc\u002Fresources\u002Fskills\u002Fdesign-an-interface\u002FSKILL.md",true,[],[46,53,60,67,74,81],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":19},"01M755N4XASRYTGDBP3257N9XY","write-milestone-brief","Synthesize the current conversation into a milestone brief (PRD). Writes to `M###-CONTEXT.md` by default, or files a GitHub issue only with explicit user confirmation. Use when asked to \"turn this into a PRD\", \"draft a milestone brief\", \"capture this context\", \"write it up\", or when enough has been discussed to commit the plan to paper. Does not interview — it synthesizes what is already known.","https:\u002F\u002Fgithub.com\u002Feagle27272\u002Fgsd-pi\u002Fblob\u002Fmain\u002Fsrc\u002Fresources\u002Fskills\u002Fwrite-milestone-brief\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M755N0HQG5WDJM1Q1DM86G8R","write-docs","Collaborative authoring workflow for proposals, technical specs, decision docs, READMEs, ADRs, and long-form prose that must work for fresh readers. Three stages: gather context, iterate on structure, reader-test for a stranger. Use when asked to \"write the docs\", \"draft a proposal\", \"write a spec\", \"write an RFC\", \"write the README\", or when a doc must be understandable without this session's context.","https:\u002F\u002Fgithub.com\u002Feagle27272\u002Fgsd-pi\u002Fblob\u002Fmain\u002Fsrc\u002Fresources\u002Fskills\u002Fwrite-docs\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M755MWPJ6T2YJBTX2XYGSHJ6","web-quality-audit","Comprehensive web quality audit covering performance, accessibility, SEO, and best practices. Use when asked to \"audit my site\", \"review web quality\", \"run lighthouse audit\", \"check page quality\", or \"optimize my website\".","https:\u002F\u002Fgithub.com\u002Feagle27272\u002Fgsd-pi\u002Fblob\u002Fmain\u002Fsrc\u002Fresources\u002Fskills\u002Fweb-quality-audit\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M755MS2TPG3DTXM0SD5Y19CG","web-design-guidelines","Review UI code for Web Interface Guidelines compliance. Use when asked to \"review my UI\", \"check accessibility\", \"audit design\", \"review UX\", or \"check my site against best practices\".","https:\u002F\u002Fgithub.com\u002Feagle27272\u002Fgsd-pi\u002Fblob\u002Fmain\u002Fsrc\u002Fresources\u002Fskills\u002Fweb-design-guidelines\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M755MMK6Q58TXHJ8T5NSSNWK","verify-before-complete","Block completion claims until verification evidence has been produced in the current message. Use before marking a task\u002Fslice\u002Fmilestone complete, before creating a commit or PR, before saying \"it works\" or \"tests pass\", and any time you are about to claim work is done. The rule is: evidence before claims, always — running the verification must happen now, not \"earlier in the session\". Fresh output or no claim.","https:\u002F\u002Fgithub.com\u002Feagle27272\u002Fgsd-pi\u002Fblob\u002Fmain\u002Fsrc\u002Fresources\u002Fskills\u002Fverify-before-complete\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M755MDN11JJKSW1HV7TQZ7VC","userinterface-wiki","UI\u002FUX best practices for web interfaces. Use when reviewing animations, CSS, audio, typography, UX patterns, prefetching, or icon implementations. Covers 11 categories from animation principles to typography. Outputs file:line findings.","https:\u002F\u002Fgithub.com\u002Feagle27272\u002Fgsd-pi\u002Fblob\u002Fmain\u002Fsrc\u002Fresources\u002Fskills\u002Fuserinterface-wiki\u002FSKILL.md",[],[]]