[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M74G2CF4SKG032KM3M73DPCX":3,"skill-same:01M74G2CF4SKG032KM3M73DPCX":46},{"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":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M74G2CF4SKG032KM3M73DPCX","cavekit-deepen",null,"Optional design-improvement pass for spare usage budget. Finds the shallowest module the spec touches, researches a deeper design, and proposes refactors that shrink interfaces and hide decisions — behavior held constant, tests green before and after. Proposes §I\u002F§V\u002F§T edits, never silent rewrites. Use when users invoke \u002Fck:deepen, say \"deepen this\", \"improve the design\", \"this module feels shallow\", or \"use spare budget on the codebase\".","casualjim\u002Fpi-mimir","casualjim","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F456109?v=4","01M74FWNWVYZQ29YNASRYNTCG4","Ivan Porto Carrero","01M74FWNXE5R8481XV0Q8Q7EY0",16,"MIT","https:\u002F\u002Fgithub.com\u002Fcasualjim\u002Fpi-mimir\u002Fblob\u002Fmain\u002Fpackages\u002Fpi-cavekit\u002Fskills\u002Fcavekit-deepen\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: cavekit-deepen\ndescription: Optional design-improvement pass for spare usage budget. Finds the shallowest module the spec touches, researches a deeper design, and proposes refactors that shrink interfaces and hide decisions — behavior held constant, tests green before and after. Proposes §I\u002F§V\u002F§T edits, never silent rewrites. Use when users invoke \u002Fck:deepen, say \"deepen this\", \"improve the design\", \"this module feels shallow\", or \"use spare budget on the codebase\".\n---\n\n# cavekit-deepen — make modules deep\n\nBehavior is sacred: tests green before AND after. Every change shrinks an interface or hides a decision — deepen, don't churn. Defers all `SPEC.md` writes to `cavekit-spec`.\n\nRead bundled `..\u002F..\u002FFORMAT.md` before drafting §I\u002F§V\u002F§T handoff content.\n\nA deep module hides a lot behind a small interface; a shallow one's interface costs as much to use as writing the code yourself. Complexity = dependencies + obscurity, and it compounds. Deepen spends spare usage paying that down before it becomes a §B. Run it when the build is green and there is budget to drain — not under deadline.\n\n## When to deepen\n\n- Build is green, tests pass, and token budget spare exists.\n- A module's interface feels as complex as its implementation (shallow smell).\n- The same change keeps touching many files (change amplification).\n- User explicitly asks to improve design quality.\n\n⊥ run mid-feature or under pressure. Deepen is the deliberate pass, not the reflex.\n\n## Five steps\n\n### 1. Pick the shallow\n\nScan the modules the spec touches. Rank by shallowness — interface surface vs work done. Pick the one worst offender. Tells:\n\n- Pass-through method that only forwards to one other (shallow layer).\n- Caller must set 5 flags right to use it (config leakage).\n- Same abstraction repeated at two layers (no information hiding).\n- A `?` or §B that traces back to a confusing interface.\n\nOne module per pass. Deepening is surgical, ⊥ a codebase sweep. If `cavecrew-investigator` is available, use it for read-only shallowness ranking; it must not design or edit.\n\n### 2. Diagnose\n\nName the design defect in caveman, citing file:line:\n\n> src\u002Fauth\u002Ftoken.go: 6-arg ctor leaks rotation policy to every caller. shallow.\n\nComplexity is real only if it shows: change amplification, high cognitive load, or an unknown-unknown (caller must know a hidden fact to call it right).\n\n### 3. Research the deepening\n\nWhat does a deeper version look like? Pull a known pattern (hand to `cavekit-research` for the external case → §R) or derive from the codebase's own better modules. Moves that deepen:\n\n- Pull complexity down — hide the hard part inside, give callers the simple path.\n- Define errors out of existence — design the interface so the edge cannot occur.\n- Information hiding — one decision, one module; callers don't learn it.\n- General-purpose interface over a pile of special-case methods.\n\n### 4. Propose\n\nDraft the change as spec edits, not a silent rewrite:\n\n- New\u002Fsimpler §I shape for the module.\n- §V that locks the deepened invariant so a future build cannot re-shallow it.\n- §T refactor row(s), each citing the §V\u002F§I it serves.\n\nHand to `cavekit-spec` to write. Show the before\u002Fafter interface so the user sees the shrink.\n\n### 5. Verify behavior held\n\nRefuse to rewrite. Full suite green before starting AND after. A deepening that changes behavior is a feature in disguise — stop, route through `\u002Fck:spec` + `\u002Fck:build`. New interface gets a test proving the old callers still work.\n\n## When to stop\n\nDone when the chosen module's interface is strictly smaller, its hidden decision no longer leaks, tests are green, and §I\u002F§V record the new shape. One module deepened beats five churned. Budget left → pick the next shallowst, fresh pass.\n\n## Boundaries\n\n- ⊥ change behavior. Green before, green after. Pure structure.\n- ⊥ write `SPEC.md`. Propose §I\u002F§V\u002F§T; `cavekit-spec` writes.\n- ⊥ deepen more than one module per pass.\n- ⊥ run under deadline or mid-feature. This is the spare-budget pass.\n- ⊥ add abstraction for single-use code. A deep module earns its hiding; a speculative one is just more surface.\n- Reference sibling skills by `cavekit-\u003Cverb>` names (e.g. `cavekit-spec`, `cavekit-research`), never upstream `skills\u002F\u003Cverb>\u002FSKILL.md` paths.\n","# cavekit-deepen — make modules deep\n\nBehavior is sacred: tests green before AND after. Every change shrinks an interface or hides a decision — deepen, don't churn. Defers all `SPEC.md` writes to `cavekit-spec`.\n\nRead bundled `..\u002F..\u002FFORMAT.md` before drafting §I\u002F§V\u002F§T handoff content.\n\nA deep module hides a lot behind a small interface; a shallow one's interface costs as much to use as writing the code yourself. Complexity = dependencies + obscurity, and it compounds. Deepen spends spare usage paying that down before it becomes a §B. Run it when the build is green and there is budget to drain — not under deadline.\n\n## When to deepen\n\n- Build is green, tests pass, and token budget spare exists.\n- A module's interface feels as complex as its implementation (shallow smell).\n- The same change keeps touching many files (change amplification).\n- User explicitly asks to improve design quality.\n\n⊥ run mid-feature or under pressure. Deepen is the deliberate pass, not the reflex.\n\n## Five steps\n\n### 1. Pick the shallow\n\nScan the modules the spec touches. Rank by shallowness — interface surface vs work done. Pick the one worst offender. Tells:\n\n- Pass-through method that only forwards to one other (shallow layer).\n- Caller must set 5 flags right to use it (config leakage).\n- Same abstraction repeated at two layers (no information hiding).\n- A `?` or §B that traces back to a confusing interface.\n\nOne module per pass. Deepening is surgical, ⊥ a codebase sweep. If `cavecrew-investigator` is available, use it for read-only shallowness ranking; it must not design or edit.\n\n### 2. Diagnose\n\nName the design defect in caveman, citing file:line:\n\n> src\u002Fauth\u002Ftoken.go: 6-arg ctor leaks rotation policy to every caller. shallow.\n\nComplexity is real only if it shows: change amplification, high cognitive load, or an unknown-unknown (caller must know a hidden fact to call it right).\n\n### 3. Research the deepening\n\nWhat does a deeper version look like? Pull a known pattern (hand to `cavekit-research` for the external case → §R) or derive from the codebase's own better modules. Moves that deepen:\n\n- Pull complexity down — hide the hard part inside, give callers the simple path.\n- Define errors out of existence — design the interface so the edge cannot occur.\n- Information hiding — one decision, one module; callers don't learn it.\n- General-purpose interface over a pile of special-case methods.\n\n### 4. Propose\n\nDraft the change as spec edits, not a silent rewrite:\n\n- New\u002Fsimpler §I shape for the module.\n- §V that locks the deepened invariant so a future build cannot re-shallow it.\n- §T refactor row(s), each citing the §V\u002F§I it serves.\n\nHand to `cavekit-spec` to write. Show the before\u002Fafter interface so the user sees the shrink.\n\n### 5. Verify behavior held\n\nRefuse to rewrite. Full suite green before starting AND after. A deepening that changes behavior is a feature in disguise — stop, route through `\u002Fck:spec` + `\u002Fck:build`. New interface gets a test proving the old callers still work.\n\n## When to stop\n\nDone when the chosen module's interface is strictly smaller, its hidden decision no longer leaks, tests are green, and §I\u002F§V record the new shape. One module deepened beats five churned. Budget left → pick the next shallowst, fresh pass.\n\n## Boundaries\n\n- ⊥ change behavior. Green before, green after. Pure structure.\n- ⊥ write `SPEC.md`. Propose §I\u002F§V\u002F§T; `cavekit-spec` writes.\n- ⊥ deepen more than one module per pass.\n- ⊥ run under deadline or mid-feature. This is the spare-budget pass.\n- ⊥ add abstraction for single-use code. A deep module earns its hiding; a speculative one is just more surface.\n- Reference sibling skills by `cavekit-\u003Cverb>` names (e.g. `cavekit-spec`, `cavekit-research`), never upstream `skills\u002F\u003Cverb>\u002FSKILL.md` paths.\n",{"name":5,"description":7},"main","86a206d111fba4ffc9c47c363486479262e63513","packages\u002Fpi-cavekit\u002Fskills\u002Fcavekit-deepen",9,"https:\u002F\u002Fgithub.com\u002Fcasualjim\u002Fpi-mimir","https:\u002F\u002Fgithub.com\u002Fcasualjim","http:\u002F\u002Fflanders.co.nz","2026-11-10 15:32:15",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add casualjim\u002Fpi-mimir --skill cavekit-deepen",{"tool":38,"command":39},"bunx","bunx skills add casualjim\u002Fpi-mimir --skill cavekit-deepen",{"tool":41,"command":42},"pnpm","pnpm dlx skills add casualjim\u002Fpi-mimir --skill cavekit-deepen","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fcasualjim\u002Fpi-mimir\u002Fblob\u002Fmain\u002Fpackages\u002Fpi-cavekit\u002Fskills\u002Fcavekit-deepen\u002FSKILL.md",true,[],[47,54,61,68,75,82],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":19},"01M74GK3CG2X0988XMHBKNC0HG","why","Use for 'why does X work this way', 'why we picked Y', design rationale, regressions, postmortems, or data-backed thresholds. Discovers available MCPs and queries each evidence category (source control, issue tracker, long-form docs, real-time chat, infrastructure observability, error tracking, product analytics warehouse) in parallel, then returns a cited read on decisions and tradeoffs. Use how for runtime behavior.","https:\u002F\u002Fgithub.com\u002Fcasualjim\u002Fpi-mimir\u002Fblob\u002Fmain\u002Fpackages\u002Fpi-pstack\u002Fskills\u002Fwhy\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":57,"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},"01M74GK2A4034JSAN8BCGBEPVB","unslop","Cut AI tells from any writing.","https:\u002F\u002Fgithub.com\u002Fcasualjim\u002Fpi-mimir\u002Fblob\u002Fmain\u002Fpackages\u002Fpi-pstack\u002Fskills\u002Funslop\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M74GK13302GXTR58TM47BQY1","typescript-best-practices","TypeScript best practices. Use when reading or editing any .ts or .tsx file.","https:\u002F\u002Fgithub.com\u002Fcasualjim\u002Fpi-mimir\u002Fblob\u002Fmain\u002Fpackages\u002Fpi-pstack\u002Fskills\u002Ftypescript-best-practices\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M74GJYB1DJCA4AQH22MWYM9J","technical-writing","Layered technical-writing standard: Diátaxis structure, Google developer style sentences, STE instruction rules, Global English syntax. Use for \u002Fskill:technical-writing or when writing or reviewing docs, RFCs, readmes, PR descriptions, or commit messages.","https:\u002F\u002Fgithub.com\u002Fcasualjim\u002Fpi-mimir\u002Fblob\u002Fmain\u002Fpackages\u002Fpi-pstack\u002Fskills\u002Ftechnical-writing\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M74GJW7794XM60AKH76941T0","teach","Explain a body of work plainly so a person actually understands it. Runs the `how` and `why` skills and weaves what they find into one clear explanation. Use for 'teach me this', 'help me really understand X', 'explain this change or subsystem to me'.","https:\u002F\u002Fgithub.com\u002Fcasualjim\u002Fpi-mimir\u002Fblob\u002Fmain\u002Fpackages\u002Fpi-pstack\u002Fskills\u002Fteach\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M74GJPQN3RW4FN7G78W2NFR1","tdd","Use only when the user explicitly asks for TDD, a failing test, or a regression test, OR when the bug has an obvious cheap local test target. Skip when the test path is unclear, expensive, integration-heavy, or not requested.","https:\u002F\u002Fgithub.com\u002Fcasualjim\u002Fpi-mimir\u002Fblob\u002Fmain\u002Fpackages\u002Fpi-pstack\u002Fskills\u002Ftdd\u002FSKILL.md",[],[]]