[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7B176WNZ5JXFSYVKFSQQA44":3,"skill-same:01M7B176WNZ5JXFSYVKFSQQA44":59},{"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":16,"sourceHtmlUrl":17,"categories":18,"keywords":19,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":23,"frontMatter":24,"refName":29,"commitSha":30,"skillDirectory":31,"forksCount":14,"repositoryHtmlUrl":32,"repositoryHomepageUrl":6,"ownerHtmlUrl":33,"ownerBlogUrl":6,"ownerDescription":34,"updatedAt":35,"install":36,"resources":48},"01M7B176WNZ5JXFSYVKFSQQA44","principle-minimize-reader-load",null,"Apply when reviewing or shaping code that's hard to trace. Count layers between question and answer, and hidden state in the reader's head; collapse one-caller wrappers and shrink mutable scope.","saphitv\u002Fskills","saphitv","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F54666981?v=4","01M7B13YDD32AHNCZS9HJP9MBD","Simon Maggini","01M7B13YE0E1SZKRC4S7WWTAT7",0,"MIT","https:\u002F\u002Fgithub.com\u002Fsaphitv\u002Fskills\u002Fblob\u002Fmain\u002Fpoteto\u002Fskills\u002Factive\u002Fprinciple-minimize-reader-load\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsaphitv\u002Fskills\u002Fblob\u002Fmain\u002Fpoteto\u002Fskills\u002Factive\u002Fprinciple-minimize-reader-load\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: principle-minimize-reader-load\ndescription: \"Apply when reviewing or shaping code that's hard to trace. Count layers between question and answer, and hidden state in the reader's head; collapse one-caller wrappers and shrink mutable scope.\"\ndisable-model-invocation: true\nlicense: MIT\nmetadata:\n  source: https:\u002F\u002Fgithub.com\u002Fuzairansaruzi\u002Fp3-stack\u002Ftree\u002F09909ebb5c0125e27fad3e57d96b81e832696d69\u002Fskills\u002Fprinciple-minimize-reader-load\n  upstream_commit: 09909ebb5c0125e27fad3e57d96b81e832696d69\n---\n\n# Minimize Reader Load\n\nMaintainability is the work a reader must do to understand code. Track two axes:\n1. **Layers to trace.** How many indirections sit between the question and the answer.\n2. **State to hold.** How much hidden or mutable context the reader must keep in their head.\n\n**Why:** Code is read far more than it is written. LOC, cyclomatic complexity, and \"clean architecture\" are proxies. Reader load is the thing that matters. The two axes are independent. A flat file with 50 globals can be as hard to reason about as a 6-layer adapter stack. Guard both. This is the human analog of [Guard the Context Window](..\u002Fprinciple-guard-the-context-window\u002FSKILL.md). Working memory is finite for readers too.\n\n**The pattern:**\n- **Collapse layers** that cost more than they save: wrappers with one caller, adapters with no second implementation, speculative indirection that was never needed. Inline them.\n- **Make adjacent layers change the abstraction.** A layer that repeats the same methods and arguments adds reader load without compression. Collapse pass-through layers.\n- **Demand interface compression.** A broad interface that hides little complexity makes readers learn both the surface and the implementation. Prefer boundaries that hide meaningful decisions.\n- **Shrink state scope:** prefer pure functions (returns over mutations), locals over fields, fields over module state, and module state over globals. Derive instead of sync.\n- **Name the invariant at the boundary,** not in every consumer, so the reader learns it once.\n- Before adding a layer or a piece of state, ask: does this reduce reader load somewhere else by at least as much?\n\n**The test:** Can a new reader answer \"where does X come from?\" and \"what can change X?\" in under 30 seconds? If not, cut layers or cut state.\n","# Minimize Reader Load\n\nMaintainability is the work a reader must do to understand code. Track two axes:\n1. **Layers to trace.** How many indirections sit between the question and the answer.\n2. **State to hold.** How much hidden or mutable context the reader must keep in their head.\n\n**Why:** Code is read far more than it is written. LOC, cyclomatic complexity, and \"clean architecture\" are proxies. Reader load is the thing that matters. The two axes are independent. A flat file with 50 globals can be as hard to reason about as a 6-layer adapter stack. Guard both. This is the human analog of [Guard the Context Window](..\u002Fprinciple-guard-the-context-window\u002FSKILL.md). Working memory is finite for readers too.\n\n**The pattern:**\n- **Collapse layers** that cost more than they save: wrappers with one caller, adapters with no second implementation, speculative indirection that was never needed. Inline them.\n- **Make adjacent layers change the abstraction.** A layer that repeats the same methods and arguments adds reader load without compression. Collapse pass-through layers.\n- **Demand interface compression.** A broad interface that hides little complexity makes readers learn both the surface and the implementation. Prefer boundaries that hide meaningful decisions.\n- **Shrink state scope:** prefer pure functions (returns over mutations), locals over fields, fields over module state, and module state over globals. Derive instead of sync.\n- **Name the invariant at the boundary,** not in every consumer, so the reader learns it once.\n- Before adding a layer or a piece of state, ask: does this reduce reader load somewhere else by at least as much?\n\n**The test:** Can a new reader answer \"where does X come from?\" and \"what can change X?\" in under 30 seconds? If not, cut layers or cut state.\n",{"name":5,"license":15,"metadata":25,"description":7,"disable-model-invocation":28},{"source":26,"upstream_commit":27},"https:\u002F\u002Fgithub.com\u002Fuzairansaruzi\u002Fp3-stack\u002Ftree\u002F09909ebb5c0125e27fad3e57d96b81e832696d69\u002Fskills\u002Fprinciple-minimize-reader-load","09909ebb5c0125e27fad3e57d96b81e832696d69",true,"main","e140a936f9f29c17f35164b21aae448f41b87cbb","poteto\u002Fskills\u002Factive\u002Fprinciple-minimize-reader-load","https:\u002F\u002Fgithub.com\u002Fsaphitv\u002Fskills","https:\u002F\u002Fgithub.com\u002Fsaphitv","Working at Easyprog, attending school at Supsi, passionate about web development.","2026-11-12 16:56:25",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":28},[38,41,44],{"tool":39,"command":40},"npx","npx skills add saphitv\u002Fskills --skill principle-minimize-reader-load",{"tool":42,"command":43},"bunx","bunx skills add saphitv\u002Fskills --skill principle-minimize-reader-load",{"tool":45,"command":46},"pnpm","pnpm dlx skills add saphitv\u002Fskills --skill principle-minimize-reader-load","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fsaphitv\u002Fskills\u002Fblob\u002Fmain\u002Fpoteto\u002Fskills\u002Factive\u002Fprinciple-minimize-reader-load\u002FSKILL.md",[49,55],{"path":50,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":54},"agents\u002Fopenai.yaml","REFERENCE","参考文档",43,"https:\u002F\u002Fgithub.com\u002Fsaphitv\u002Fskills\u002Fblob\u002Fmain\u002Fpoteto\u002Fskills\u002Factive\u002Fprinciple-minimize-reader-load\u002Fagents\u002Fopenai.yaml",{"path":56,"resourceType":56,"resourceTypeDesc":57,"sizeBytes":58,"sourceHtmlUrl":16},"LICENSE","许可证",1119,[60,68,76,84,92,100],{"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":64,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":20},"01M7B1FHX908WSXXJENZ8RV88N","takeover","Take over existing work. Use when the user asks to take over a PR, branch, or agent thread, or requests a takeover.","https:\u002F\u002Fgithub.com\u002Fsaphitv\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Factive\u002Ftakeover\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsaphitv\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Factive\u002Ftakeover\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":72,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":20},"01M7B1FAZW3D5D8Q2QSTBX4BZQ","statechart","Check a TLA+ model of a system that moves between states, such as a product flow, a protocol, or a service, and draw it as a Mermaid statechart. The report gives the shortest path to each state that breaks a rule. Use for \u002Fstatechart, or to show a bug as a path through states.","https:\u002F\u002Fgithub.com\u002Fsaphitv\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Factive\u002Fstatechart\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsaphitv\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Factive\u002Fstatechart\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":80,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":20},"01M7B1F96A7KZSGDPR59MVQCTB","sol-loop","Use when the user says \"sol loop\".","https:\u002F\u002Fgithub.com\u002Fsaphitv\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Factive\u002Fsol-loop\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsaphitv\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Factive\u002Fsol-loop\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":88,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":20},"01M7B1F3TB4MVFFKB16HZG9NCX","security-audit-testing","Experimental Cloudflare security-audit trial for security questions, focused vulnerability reviews, codebase audits, or pen tests. Run the complete workflow only for explicit codebase audit or pen-test requests, full\u002Fcomprehensive\u002Fend-to-end reviews, or requested report artifacts.","https:\u002F\u002Fgithub.com\u002Fsaphitv\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Factive\u002Fsecurity-audit-testing\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsaphitv\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Factive\u002Fsecurity-audit-testing\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":96,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":20},"01M7B1EZ0530A1BB1SND8NTDSV","retro","Conduct a retrospective on a coding session.","https:\u002F\u002Fgithub.com\u002Fsaphitv\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Factive\u002Fretro\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsaphitv\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Factive\u002Fretro\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":104,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":20},"01M7B1EWKNQPSW37CS533BHAVW","modernize","For getting old prs up to date. Use when asked to rebase a pr or \"modernize\".","https:\u002F\u002Fgithub.com\u002Fsaphitv\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Factive\u002Fmodernize\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fsaphitv\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Factive\u002Fmodernize\u002FSKILL.md",[],[]]