[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7FD7NX4ZXG2VPNC1ATR76YF":3,"skill-same:01M7FD7NX4ZXG2VPNC1ATR76YF":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":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":44},"01M7FD7NX4ZXG2VPNC1ATR76YF","principle-explain-the-number",null,"Apply before you measure, and before you trust, report, or act on a number you measured: a speedup, a regression, a throughput, a latency, or an eval result. Find what limits it, and rule out that it measured something other than the work you think.","l246804\u002Fdsh-pstack","l246804","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F53589602?v=4","01M7FD2TFY24A2KKK55FSQWJ47","leihaohao","01M7FD2TGRS2ZCQ68BRY93D89D",23,"MIT","https:\u002F\u002Fgithub.com\u002Fl246804\u002Fdsh-pstack\u002Fblob\u002Fmain\u002Fpstack\u002Fskills\u002Fprinciple-explain-the-number\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: principle-explain-the-number\ndescription: \"Apply before you measure, and before you trust, report, or act on a number you measured: a speedup, a regression, a throughput, a latency, or an eval result. Find what limits it, and rule out that it measured something other than the work you think.\"\ndisable-model-invocation: true\n---\n\n# Explain the Number\n\n- **Write the decision before you run.** Name the result that would change a decision, and the noise floor. Stop when the run-to-run spread is larger than the effect.\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](..\u002Fbenchmark-checklist\u002FSKILL.md) skill. 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 a run started without the result that would change a decision, 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\n- **Write the decision before you run.** Name the result that would change a decision, and the noise floor. Stop when the run-to-run spread is larger than the effect.\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](..\u002Fbenchmark-checklist\u002FSKILL.md) skill. 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 a run started without the result that would change a decision, 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,"description":7,"disable-model-invocation":24},true,"main","df33da1bb4942fbd2761c305edb3785093ec1055","pstack\u002Fskills\u002Fprinciple-explain-the-number",4,"https:\u002F\u002Fgithub.com\u002Fl246804\u002Fdsh-pstack","https:\u002F\u002Fgithub.com\u002Fl246804","2026-11-15 16:09:02",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":24},[34,37,40],{"tool":35,"command":36},"npx","npx skills add l246804\u002Fdsh-pstack --skill principle-explain-the-number",{"tool":38,"command":39},"bunx","bunx skills add l246804\u002Fdsh-pstack --skill principle-explain-the-number",{"tool":41,"command":42},"pnpm","pnpm dlx skills add l246804\u002Fdsh-pstack --skill principle-explain-the-number","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fl246804\u002Fdsh-pstack\u002Fblob\u002Fmain\u002Fpstack\u002Fskills\u002Fprinciple-explain-the-number\u002FSKILL.md",[],[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},"01M7FDC7PA7ACJ95HW5T1N9ZJ3","setup-project-docs","Bootstrap architecture, glossary, decision-record conventions, and root agent-doc pointers; rerun to fill approved gaps.","https:\u002F\u002Fgithub.com\u002Fl246804\u002Fdsh-pstack\u002Fblob\u002Fmain\u002Fskills\u002Fauthored\u002Fsetup-project-docs\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},"01M7FDC35BXG4PW3HG16BXF5FG","docs-drift","Audit living project documentation for drift and redundancy; repair approved findings.","https:\u002F\u002Fgithub.com\u002Fl246804\u002Fdsh-pstack\u002Fblob\u002Fmain\u002Fskills\u002Fauthored\u002Fdocs-drift\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},"01M7FDBZ7PP5T1V4Q1MEP95BGM","decision-write","Write, update, land, or supersede decision records. Use for resolved alternatives, missing rationale, reversed decisions, or record-file changes. Land finds and verifies the implementation; Review-only updates keep the current status.","https:\u002F\u002Fgithub.com\u002Fl246804\u002Fdsh-pstack\u002Fblob\u002Fmain\u002Fskills\u002Fauthored\u002Fdecision-write\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},"01M7FDBVXYSHCB2E52HKS2TH2E","decision-audit","Read-only audit of decision records for a PR, local changes, or the whole repository. Report routing, status, scope, anchor, supersession, and overdue-review findings with command evidence.","https:\u002F\u002Fgithub.com\u002Fl246804\u002Fdsh-pstack\u002Fblob\u002Fmain\u002Fskills\u002Fauthored\u002Fdecision-audit\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},"01M7FDBSF0V6HTFHD5PHDC6BAM","writing-for-agents","Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.","https:\u002F\u002Fgithub.com\u002Fl246804\u002Fdsh-pstack\u002Fblob\u002Fmain\u002Fskills\u002F.agents\u002Fskills\u002Fwriting-for-agents\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},"01M7FDBQPY2F8PSNJKTGZ6AYD6","retro","Conduct a retrospective on a coding session.","https:\u002F\u002Fgithub.com\u002Fl246804\u002Fdsh-pstack\u002Fblob\u002Fmain\u002Fskills\u002F.agents\u002Fskills\u002Fretro\u002FSKILL.md",[],[]]