[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EXTZ9CFW6B5PYR2P3P2NBP":3,"skill-same:01M7EXTZ9CFW6B5PYR2P3P2NBP":65},{"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":32,"repositoryHtmlUrl":33,"repositoryHomepageUrl":6,"ownerHtmlUrl":34,"ownerBlogUrl":35,"ownerDescription":6,"updatedAt":36,"install":37,"resources":49},"01M7EXTZ9CFW6B5PYR2P3P2NBP","principle-explain-the-number",null,"Apply before you trust, report, or act on a measured number (speedup, regression, throughput, latency, eval result). Find what limits it, and rule out that it measured something other than the work you think.","ravnhq\u002Fravn-core","ravnhq","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F32917297?v=4","01M7EXRETGEZ3CYCQTXRQ83BTJ","Ravn","01M7EXREV559052BB2B6AX8X5K",2,"MIT","https:\u002F\u002Fgithub.com\u002Fravnhq\u002Fravn-core\u002Fblob\u002Fmain\u002Fplugins\u002Fagent\u002Fravn-core\u002Fskills\u002Fprinciple-explain-the-number\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fravnhq\u002Fravn-core\u002Fblob\u002Fmain\u002Fplugins\u002Fagent\u002Fravn-core\u002Fskills\u002Fprinciple-explain-the-number\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: principle-explain-the-number\ndescription: >-\n  Apply before you trust, report, or act on a measured number (speedup,\n  regression, throughput, latency, eval result). Find what limits it, and rule\n  out that it measured something other than the work you think.\ndisable-model-invocation: true\nlicense: See LICENSE.txt\nmetadata:\n  proof: subjective\n---\n\n# Explain the Number\n\nAdapted from pstack `principle-explain-the-number`, MIT License, Copyright (c) 2026 Lauren Tan. See [LICENSE.txt](LICENSE.txt).\n\n- **Ask \"why not double?\"** Name the resource or code path that bounds the result, such as a core, a lock, the disk, the network, or the load generator itself. Get it from a profile or from system counters taken during a run, then map it to source. A guess from reading the code is not a limiter. If you cannot say why the number is not twice as good, you do not know what you measured.\n- **List what else the number could be measuring, and rule out each one with evidence.** The usual suspects are errors, skipped or cached work, code that never ran, an untuned side (one left on default settings), noise, and a piece too small to matter end to end.\n- **Keep the evidence with the number.** Put the run count, the spread, and the limiter in the notes or a linked artifact.\n\nFor a performance number, run the full procedure with the [benchmark checklist](BENCHMARK-CHECKLIST.md). For an eval result, ask the same of the trials: did every run do the task, does the gap hold across trials and models, and does the scenario matter.\n\nYou skipped this when the evidence behind a number has no run count, no spread, or no named limiter, or when the time saved is larger than the time the changed piece took.\n\nDistinct from [Prove It Works](..\u002Fprinciple-prove-it-works\u002FSKILL.md), which checks that an output is real.\n","# Explain the Number\n\nAdapted from pstack `principle-explain-the-number`, MIT License, Copyright (c) 2026 Lauren Tan. See [LICENSE.txt](LICENSE.txt).\n\n- **Ask \"why not double?\"** Name the resource or code path that bounds the result, such as a core, a lock, the disk, the network, or the load generator itself. Get it from a profile or from system counters taken during a run, then map it to source. A guess from reading the code is not a limiter. If you cannot say why the number is not twice as good, you do not know what you measured.\n- **List what else the number could be measuring, and rule out each one with evidence.** The usual suspects are errors, skipped or cached work, code that never ran, an untuned side (one left on default settings), noise, and a piece too small to matter end to end.\n- **Keep the evidence with the number.** Put the run count, the spread, and the limiter in the notes or a linked artifact.\n\nFor a performance number, run the full procedure with the [benchmark checklist](BENCHMARK-CHECKLIST.md). For an eval result, ask the same of the trials: did every run do the task, does the gap hold across trials and models, and does the scenario matter.\n\nYou skipped this when the evidence behind a number has no run count, no spread, or no named limiter, or when the time saved is larger than the time the changed piece took.\n\nDistinct from [Prove It Works](..\u002Fprinciple-prove-it-works\u002FSKILL.md), which checks that an output is real.\n",{"name":5,"license":25,"metadata":26,"description":7,"disable-model-invocation":28},"See LICENSE.txt",{"proof":27},"subjective",true,"main","8debc762560573209acaf70a1a66f1061d7c8060","plugins\u002Fagent\u002Fravn-core\u002Fskills\u002Fprinciple-explain-the-number",0,"https:\u002F\u002Fgithub.com\u002Fravnhq\u002Fravn-core","https:\u002F\u002Fgithub.com\u002Fravnhq","https:\u002F\u002Fwww.ravn.co","2026-11-13 05:50:45",{"source":8,"skillName":5,"commands":38,"prompt":48,"zipAvailable":28},[39,42,45],{"tool":40,"command":41},"npx","npx skills add ravnhq\u002Fravn-core --skill principle-explain-the-number",{"tool":43,"command":44},"bunx","bunx skills add ravnhq\u002Fravn-core --skill principle-explain-the-number",{"tool":46,"command":47},"pnpm","pnpm dlx skills add ravnhq\u002Fravn-core --skill principle-explain-the-number","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fravnhq\u002Fravn-core\u002Fblob\u002Fmain\u002Fplugins\u002Fagent\u002Fravn-core\u002Fskills\u002Fprinciple-explain-the-number\u002FSKILL.md",[50,56,60],{"path":51,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":55},"agents\u002Fopenai.yaml","REFERENCE","参考文档",145,"https:\u002F\u002Fgithub.com\u002Fravnhq\u002Fravn-core\u002Fblob\u002Fmain\u002Fplugins\u002Fagent\u002Fravn-core\u002Fskills\u002Fprinciple-explain-the-number\u002Fagents\u002Fopenai.yaml",{"path":57,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":58,"sourceHtmlUrl":59},"BENCHMARK-CHECKLIST.md",4547,"https:\u002F\u002Fgithub.com\u002Fravnhq\u002Fravn-core\u002Fblob\u002Fmain\u002Fplugins\u002Fagent\u002Fravn-core\u002Fskills\u002Fprinciple-explain-the-number\u002FBENCHMARK-CHECKLIST.md",{"path":61,"resourceType":62,"resourceTypeDesc":63,"sizeBytes":64,"sourceHtmlUrl":16},"LICENSE.txt","LICENSE","许可证",1177,[66,74,82,90,98,106],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":70,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":20},"01M7EXWEDTSBBB0DQENHSBXCV5","writing-for-agents","Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.","https:\u002F\u002Fgithub.com\u002Fravnhq\u002Fravn-core\u002Fblob\u002Fmain\u002Fplugins\u002Fagent\u002Fravn-core\u002Fskills\u002Fwriting-for-agents\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fravnhq\u002Fravn-core\u002Fblob\u002Fmain\u002Fplugins\u002Fagent\u002Fravn-core\u002Fskills\u002Fwriting-for-agents\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":78,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":20},"01M7EXWA9QD5H1Z7ZNZHFV7M5E","why","Use for 'why does X work this way', 'why we picked Y', design rationale, regressions, postmortems, or data-backed thresholds. Queries every available evidence MCP in parallel and returns a cited read on decisions and tradeoffs. Use how for runtime behavior.","https:\u002F\u002Fgithub.com\u002Fravnhq\u002Fravn-core\u002Fblob\u002Fmain\u002Fplugins\u002Fagent\u002Fravn-core\u002Fskills\u002Fwhy\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fravnhq\u002Fravn-core\u002Fblob\u002Fmain\u002Fplugins\u002Fagent\u002Fravn-core\u002Fskills\u002Fwhy\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":86,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":20},"01M7EXW7M17CN7V62E25PM4QAJ","typescript-best-practices","TypeScript type-safety rules: discriminated unions, branded types, no `as`, exhaustive switches, schema-derived types. Use when writing, editing, or reviewing TypeScript.","https:\u002F\u002Fgithub.com\u002Fravnhq\u002Fravn-core\u002Fblob\u002Fmain\u002Fplugins\u002Fagent\u002Fravn-core\u002Fskills\u002Ftypescript-best-practices\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fravnhq\u002Fravn-core\u002Fblob\u002Fmain\u002Fplugins\u002Fagent\u002Fravn-core\u002Fskills\u002Ftypescript-best-practices\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":94,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":20},"01M7EXW4Q6KTG9RM0R1MB29H9D","show-me-your-work","Keep a reviewable decision trail for unattended or multi-phase work: a TSV log with one row per decision (what, why, evidence, result).","https:\u002F\u002Fgithub.com\u002Fravnhq\u002Fravn-core\u002Fblob\u002Fmain\u002Fplugins\u002Fagent\u002Fravn-core\u002Fskills\u002Fshow-me-your-work\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fravnhq\u002Fravn-core\u002Fblob\u002Fmain\u002Fplugins\u002Fagent\u002Fravn-core\u002Fskills\u002Fshow-me-your-work\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":102,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":20},"01M7EXW00F0AQWA8F8ANCN2ZZT","ship","Take a change from idea to a ready PR with passing CI, running research, grilling, design, verification, and the pr skill in sequence.","https:\u002F\u002Fgithub.com\u002Fravnhq\u002Fravn-core\u002Fblob\u002Fmain\u002Fplugins\u002Fagent\u002Fravn-core\u002Fskills\u002Fship\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fravnhq\u002Fravn-core\u002Fblob\u002Fmain\u002Fplugins\u002Fagent\u002Fravn-core\u002Fskills\u002Fship\u002FSKILL.md",[],[],{"skillNo":107,"name":108,"nameZh":6,"description":109,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":110,"sourceHtmlUrl":111,"categories":112,"keywords":113,"publishedAt":20},"01M7EXVTVXP3RB0NPVTPG05YC4","session-pickup","Resume unfinished work from a handoff note or prior coding-agent session. Use before reading a supplied handoff, even when its next action is only an inspection or report. Also use to pick up, continue where you left off, or take over from a transcript, agent URL, or pushed branch. Use pause-safely to write a handoff.","https:\u002F\u002Fgithub.com\u002Fravnhq\u002Fravn-core\u002Fblob\u002Fmain\u002Fplugins\u002Fagent\u002Fravn-core\u002Fskills\u002Fsession-pickup\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fravnhq\u002Fravn-core\u002Fblob\u002Fmain\u002Fplugins\u002Fagent\u002Fravn-core\u002Fskills\u002Fsession-pickup\u002FSKILL.md",[],[]]