[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ATBXMBB9GG2BYYPYMM45MX":3,"skill-same:01M7ATBXMBB9GG2BYYPYMM45MX":49},{"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":28,"commitSha":29,"skillDirectory":30,"forksCount":14,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":33,"ownerDescription":6,"updatedAt":34,"install":35,"resources":48},"01M7ATBXMBB9GG2BYYPYMM45MX","codebase-design",null,"Shared vocabulary and method for designing deep modules — much behaviour behind a small interface, placed at a real seam, tested through that interface. Use when designing or reshaping a module's interface, deciding where a seam belongs, finding shallow pass-through code worth merging, making code easier to test or navigate, or when another skill needs this vocabulary.","coltonbearden\u002Fawakened","coltonbearden","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F208834784?v=4","01M7ATATS86H87M6N7DGFWJXWA","Colton Bearden","01M7ATATSYZ652XPQKRKYQ3Q3P",0,"MIT","https:\u002F\u002Fgithub.com\u002Fcoltonbearden\u002Fawakened\u002Fblob\u002Fmain\u002Fplugins\u002Fdomain\u002Fskills\u002Fcodebase-design\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: codebase-design\ndescription: Shared vocabulary and method for designing deep modules — much behaviour behind a small interface, placed at a real seam, tested through that interface. Use when designing or reshaping a module's interface, deciding where a seam belongs, finding shallow pass-through code worth merging, making code easier to test or navigate, or when another skill needs this vocabulary.\nallowed-tools: [Read, Grep, Glob]\n---\n\n# Codebase Design\n\n## Purpose\n\nGive design conversations one precise language and a small set of tests for whether a structure earns its keep.\nThe skill produces recommendations and interface sketches in the conversation; it edits no code and records no\ndecision. Implementation belongs to the workflow plugin doing the work; the eventual decision record belongs to\n`rinnegan`.\n\n## Trigger Conditions\n\nUse this skill when the user is shaping a new module, unhappy with a wide or leaky interface, choosing where an\nabstraction should sit, or asking why code is hard to test or hard to find.\n\nDo not use it to review a finished change for defects (`sharingan`), to define business terms\n(`domain-modeling`), or to map an unfamiliar repository (`codebase-onboarding`).\n\n## Vocabulary\n\nUse these words exactly; substitutes blur the discussion.\n\n| Term | Meaning | Say it instead of |\n|---|---|---|\n| Module | Anything with an interface and an implementation, at any scale | unit, component, service |\n| Interface | All a caller must know: signature, invariants, ordering, error modes, setup, cost | API, signature |\n| Implementation | The body behind the interface | — |\n| Seam | The place where behaviour can be swapped without editing there; where an interface lives | boundary |\n| Adapter | A concrete thing that satisfies an interface at a seam; names a role, not a size | — |\n| Depth | Behaviour a caller gets per unit of interface learned | — |\n| Leverage | The caller's gain from depth: one implementation repaid across many call sites and tests | — |\n| Locality | The maintainer's gain from depth: change, bugs, and knowledge concentrate in one place | — |\n\nA module is deep when a small interface hides a lot; shallow when the interface is nearly as wide as what sits\nbehind it. Depth is a property of the interface, so a deep module may still be built from small, swappable\ninternal parts with their own private seams.\n\n## Method\n\n1. Name the module and write its interface in full — types, invariants, ordering, failure modes, required\n   setup, performance shape. If that list is long relative to the behaviour, the module is shallow.\n2. Apply the deletion test: imagine the module gone. If complexity disappears, it was pass-through; if it\n   reappears across several callers, it was earning depth.\n3. Place the seam only where something varies. One adapter is a hypothetical seam; two (usually production and\n   test) make it real. Classify each dependency to decide the testing shape: pure in-process logic merges\n   freely; a dependency with a local stand-in is tested with the stand-in; a service you own gets a port with a\n   production adapter and an in-memory one; a third-party service gets a port with a test double.\n4. Check testability through the interface alone: dependencies are accepted rather than constructed inside,\n   results are returned rather than applied as side effects, and tests describe behaviour, not internals. A test\n   that must change when the implementation changes is reaching past the interface.\n5. Design it twice, inline. Before recommending, sketch the interface at least three different ways in this\n   session, each under a different pressure — fewest entry points, most flexibility, easiest common call, and\n   ports-and-adapters when a dependency crosses a seam. Present them in turn, compare on depth, locality, and\n   seam placement, and give a firm recommendation or a hybrid. No subagents are dispatched for this.\n6. When shallow modules are merged, write new tests at the deepened interface and retire the old ones on the\n   parts; layering both is waste.\n\n## Safety Checks\n\n- Read-only: the skill reads code and writes nothing (C-3).\n- Do not adopt lines-of-implementation over lines-of-interface as a depth measure; it rewards padding.\n- Language- and framework-specific idioms enter only when the user asks for them (P-2).\n\n## Output Contract\n\n1. **Module and interface** — the full interface as it stands, and the depth verdict\n2. **Alternatives** — the sketches from step 5, compared\n3. **Recommendation** — the chosen shape, seam placement, dependency strategy, and test surface\n","# Codebase Design\n\n## Purpose\n\nGive design conversations one precise language and a small set of tests for whether a structure earns its keep.\nThe skill produces recommendations and interface sketches in the conversation; it edits no code and records no\ndecision. Implementation belongs to the workflow plugin doing the work; the eventual decision record belongs to\n`rinnegan`.\n\n## Trigger Conditions\n\nUse this skill when the user is shaping a new module, unhappy with a wide or leaky interface, choosing where an\nabstraction should sit, or asking why code is hard to test or hard to find.\n\nDo not use it to review a finished change for defects (`sharingan`), to define business terms\n(`domain-modeling`), or to map an unfamiliar repository (`codebase-onboarding`).\n\n## Vocabulary\n\nUse these words exactly; substitutes blur the discussion.\n\n| Term | Meaning | Say it instead of |\n|---|---|---|\n| Module | Anything with an interface and an implementation, at any scale | unit, component, service |\n| Interface | All a caller must know: signature, invariants, ordering, error modes, setup, cost | API, signature |\n| Implementation | The body behind the interface | — |\n| Seam | The place where behaviour can be swapped without editing there; where an interface lives | boundary |\n| Adapter | A concrete thing that satisfies an interface at a seam; names a role, not a size | — |\n| Depth | Behaviour a caller gets per unit of interface learned | — |\n| Leverage | The caller's gain from depth: one implementation repaid across many call sites and tests | — |\n| Locality | The maintainer's gain from depth: change, bugs, and knowledge concentrate in one place | — |\n\nA module is deep when a small interface hides a lot; shallow when the interface is nearly as wide as what sits\nbehind it. Depth is a property of the interface, so a deep module may still be built from small, swappable\ninternal parts with their own private seams.\n\n## Method\n\n1. Name the module and write its interface in full — types, invariants, ordering, failure modes, required\n   setup, performance shape. If that list is long relative to the behaviour, the module is shallow.\n2. Apply the deletion test: imagine the module gone. If complexity disappears, it was pass-through; if it\n   reappears across several callers, it was earning depth.\n3. Place the seam only where something varies. One adapter is a hypothetical seam; two (usually production and\n   test) make it real. Classify each dependency to decide the testing shape: pure in-process logic merges\n   freely; a dependency with a local stand-in is tested with the stand-in; a service you own gets a port with a\n   production adapter and an in-memory one; a third-party service gets a port with a test double.\n4. Check testability through the interface alone: dependencies are accepted rather than constructed inside,\n   results are returned rather than applied as side effects, and tests describe behaviour, not internals. A test\n   that must change when the implementation changes is reaching past the interface.\n5. Design it twice, inline. Before recommending, sketch the interface at least three different ways in this\n   session, each under a different pressure — fewest entry points, most flexibility, easiest common call, and\n   ports-and-adapters when a dependency crosses a seam. Present them in turn, compare on depth, locality, and\n   seam placement, and give a firm recommendation or a hybrid. No subagents are dispatched for this.\n6. When shallow modules are merged, write new tests at the deepened interface and retire the old ones on the\n   parts; layering both is waste.\n\n## Safety Checks\n\n- Read-only: the skill reads code and writes nothing (C-3).\n- Do not adopt lines-of-implementation over lines-of-interface as a depth measure; it rewards padding.\n- Language- and framework-specific idioms enter only when the user asks for them (P-2).\n\n## Output Contract\n\n1. **Module and interface** — the full interface as it stands, and the depth verdict\n2. **Alternatives** — the sketches from step 5, compared\n3. **Recommendation** — the chosen shape, seam placement, dependency strategy, and test surface\n",{"name":5,"description":7,"allowed-tools":24},[25,26,27],"Read","Grep","Glob","main","b192e49d15e524b1a88cd89bc42ed677c1019c9f","plugins\u002Fdomain\u002Fskills\u002Fcodebase-design","https:\u002F\u002Fgithub.com\u002Fcoltonbearden\u002Fawakened","https:\u002F\u002Fgithub.com\u002Fcoltonbearden","https:\u002F\u002Fcoltonbearden.com\u002F","2026-09-25 06:56:45",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add coltonbearden\u002Fawakened --skill codebase-design",{"tool":41,"command":42},"bunx","bunx skills add coltonbearden\u002Fawakened --skill codebase-design",{"tool":44,"command":45},"pnpm","pnpm dlx skills add coltonbearden\u002Fawakened --skill codebase-design","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fcoltonbearden\u002Fawakened\u002Fblob\u002Fmain\u002Fplugins\u002Fdomain\u002Fskills\u002Fcodebase-design\u002FSKILL.md",true,[],[50,57,64,71,78,85],{"skillNo":51,"name":52,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M7ATJM35P1TKP3CPE240A8KY","good-skill","Fixture - a skill whose name equals its directory and whose description clears the forty-character floor (N-2).","https:\u002F\u002Fgithub.com\u002Fcoltonbearden\u002Fawakened\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Fgood-skill\u002FSKILL.md",[],[],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M7ATJJYPD2HBMA6H5KQ28YNM","wrong-name","Too short.","https:\u002F\u002Fgithub.com\u002Fcoltonbearden\u002Fawakened\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Fbad-skill\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"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},"01M7ATJG19YSBW0PZCP9YN2S0K","\u003Cskill-name>","\u003CWhat the skill does, then the situations that should trigger it. Concrete and situational, third person, never marketing. Minimum 40 characters — this text is the auto-invocation surface (N-2).>","https:\u002F\u002Fgithub.com\u002Fcoltonbearden\u002Fawakened\u002Fblob\u002Fmain\u002Ftemplates\u002Fskill.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M7ATJCEBSD2HYJAC4BE22AR1","writing-plans","Turns an agreed design or spec into a step-by-step implementation plan that an engineer with no context could execute. Use when a multi-step change is understood well enough to sequence but no plan exists yet, before touching code. Produces a plan file with exact paths, test-first steps, interfaces between tasks, and no placeholders.","https:\u002F\u002Fgithub.com\u002Fcoltonbearden\u002Fawakened\u002Fblob\u002Fmain\u002Fplugins\u002Fsuper-saiyan\u002Fskills\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M7ATJ8AF6T9VWJH3NXY5QRS7","verification-before-completion","Gate that runs before any claim that work is done, fixed, passing, or shipped. Identifies the command that would prove the claim, runs it fresh, reads the whole output, and only then reports — with the evidence attached and any gap stated. Use before committing, opening a pull request, marking a task complete, or telling the user something works.","https:\u002F\u002Fgithub.com\u002Fcoltonbearden\u002Fawakened\u002Fblob\u002Fmain\u002Fplugins\u002Fsuper-saiyan\u002Fskills\u002Fverification-before-completion\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M7ATJ2AAB7VS5AVNPT6E9YNQ","using-skills","Session discipline that fires before the first action of any task. Checks whether an installed skill or command already covers the job, keeps every action inside the requested scope, and reports verification as evidence rather than confidence. Use at the start of a conversation, before answering a question, before exploring a codebase, and whenever a task changes shape mid-session.","https:\u002F\u002Fgithub.com\u002Fcoltonbearden\u002Fawakened\u002Fblob\u002Fmain\u002Fplugins\u002Fsuper-saiyan\u002Fskills\u002Fusing-skills\u002FSKILL.md",[],[]]