[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DF9BFZ7M4EVZX1G6F57KB7":3,"skill-same:01M7DF9BFZ7M4EVZX1G6F57KB7":55},{"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":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7DF9BFZ7M4EVZX1G6F57KB7","profiling",null,"Measure a performance baseline and locate its bottleneck before changing code. Use when investigating latency, throughput, memory, CPU, I\u002FO or cost, or when a performance check or budget fails; use a specialized frontend or backend skill once the bottleneck is located.","andersonmrodrigues\u002Fpaved","andersonmrodrigues","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F13907380?v=4","01M7DEV3FP2VMQZ3FP2FP1TK1C","Anderson Rodrigues","01M7DEV3GC2QAQBW4FMNT98H48",1,"MIT","https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Fplugins\u002Fpaved\u002Fskills\u002Fprofiling\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: profiling\ndescription: >-\n  Measure a performance baseline and locate its bottleneck before changing code. Use when investigating latency, throughput, memory, CPU, I\u002FO or cost, or when a performance check or budget fails; use a specialized frontend or backend skill once the bottleneck is located.\n---\n\n\u003C!-- Generated by Paved plugin paved@2.29.0 from core.performance.profiling@0.3.0; edit Paved Core instead. -->\n# Profiling\n\n## When to use\n\nIn the `discovery` phase of a `performance` run, where it produces the baseline, and\nwhenever a performance claim needs a number, including in a `feature` that adds a budget. The layer-specific skills (`backend-performance`,\n`frontend-performance`) depend on this one for measurement.\n\n## Required context\n\nNone is required. Useful: performance budgets and benchmarks in the verification\nprofile, and the architecture context for the affected path.\n\n## Preconditions\n\n- The target metric and workload are defined: what is measured, under what input, and\n  what \"better\" means. If not, define them with a human first.\n- A measurement can be taken in an environment representative enough to trust.\n\n## Procedure\n\n1. **Define the measurement** following\n   [references\u002Fmeasurement-protocol.md](references\u002Fmeasurement-protocol.md): metric,\n   statistic, workload, environment, warm-up and repetitions.\n2. **Measure the baseline** and its run-to-run variance before changing anything.\n3. **Profile** to locate where time or resources go. Do not optimize from intuition.\n4. **Pick the largest contributor** and form one hypothesis about it.\n5. **Change one thing.** Measure again under the same workload and environment.\n6. **Keep the change** only if the improvement exceeds the variance and behavior is\n   unchanged (run the behavior checks too).\n7. **Repeat** until the target is met or the remaining gains are not worth the\n   complexity, then report as in\n   [examples\u002Fmeasurement-report.md](examples\u002Fmeasurement-report.md).\n\nIn a `performance` run, steps 1 to 4 end discovery: write the baseline as a\nmeasurement record (`schemas\u002Fperformance-measurement.schema.yaml`, `stage: baseline`)\nwith at least three samples, the method, what limits the numbers and the hypothesis.\nStep 5's measurement is the `after` record, taken with exactly the same metric and\nmethod. Paved compares the two sample sets and decides whether the gain clears the\nnoise; never edit samples after recording them.\n\n## Tools\n\nNone from the Core. Profilers and benchmark runners are declared in `.paved\u002Ftools\u002F` or\nsupplied by adapters.\n\n## Rules\n\n`core.performance.measure-before-optimizing` is this skill's contract.\n\n## Verification\n\nRequired: `performance` — the measurement of baseline and result. Recommended: `unit`\nand `integration`, to show behavior did not change.\n\n## Evidence\n\nBaseline and result measurements with workload and environment, and non-regression check\nresults.\n\n## Completion criteria\n\n- The target is met, or the evidence explains why it cannot be with a reasonable change.\n- Baseline and result were measured the same way.\n- Behavior checks pass.\n\n## Failure modes\n\n| Failure | Signal | Response |\n|---|---|---|\n| Noise mistaken for gain | Improvement within variance | Increase repetitions or discard |\n| Different workload | Before and after measured differently | Re-measure both the same way |\n| Micro-optimizing the wrong path | Profile shows the change is not on the hot path | Revert; go back to the profile |\n| Unrepresentative environment | Numbers differ wildly from those reported | State the environment; ask for a better one |\n\n## References\n\n- [references\u002Fmeasurement-protocol.md](references\u002Fmeasurement-protocol.md): how to\n  define and take a trustworthy measurement.\n- [examples\u002Fmeasurement-report.md](examples\u002Fmeasurement-report.md): a synthetic report.\n\n\n## Paved integration\n\nUse the project-local Paved contract as the source of truth. Discover state with `node \"\u003Cplugin root>\u002Fscripts\u002Fpaved.mjs\" status --json`, load only relevant `.paved\u002Fproject\u002F` context, and invoke verification with `node \"\u003Cplugin root>\u002Fscripts\u002Fpaved.mjs\" verify --json`. `\u003Cplugin root>` is the installed Paved plugin directory, two directories above this SKILL.md. Always run the launcher from the repository being worked on, never from the plugin directory. Do not edit generated integration files or bypass Paved lifecycle and ownership checks.\n","\u003C!-- Generated by Paved plugin paved@2.29.0 from core.performance.profiling@0.3.0; edit Paved Core instead. -->\n# Profiling\n\n## When to use\n\nIn the `discovery` phase of a `performance` run, where it produces the baseline, and\nwhenever a performance claim needs a number, including in a `feature` that adds a budget. The layer-specific skills (`backend-performance`,\n`frontend-performance`) depend on this one for measurement.\n\n## Required context\n\nNone is required. Useful: performance budgets and benchmarks in the verification\nprofile, and the architecture context for the affected path.\n\n## Preconditions\n\n- The target metric and workload are defined: what is measured, under what input, and\n  what \"better\" means. If not, define them with a human first.\n- A measurement can be taken in an environment representative enough to trust.\n\n## Procedure\n\n1. **Define the measurement** following\n   [references\u002Fmeasurement-protocol.md](references\u002Fmeasurement-protocol.md): metric,\n   statistic, workload, environment, warm-up and repetitions.\n2. **Measure the baseline** and its run-to-run variance before changing anything.\n3. **Profile** to locate where time or resources go. Do not optimize from intuition.\n4. **Pick the largest contributor** and form one hypothesis about it.\n5. **Change one thing.** Measure again under the same workload and environment.\n6. **Keep the change** only if the improvement exceeds the variance and behavior is\n   unchanged (run the behavior checks too).\n7. **Repeat** until the target is met or the remaining gains are not worth the\n   complexity, then report as in\n   [examples\u002Fmeasurement-report.md](examples\u002Fmeasurement-report.md).\n\nIn a `performance` run, steps 1 to 4 end discovery: write the baseline as a\nmeasurement record (`schemas\u002Fperformance-measurement.schema.yaml`, `stage: baseline`)\nwith at least three samples, the method, what limits the numbers and the hypothesis.\nStep 5's measurement is the `after` record, taken with exactly the same metric and\nmethod. Paved compares the two sample sets and decides whether the gain clears the\nnoise; never edit samples after recording them.\n\n## Tools\n\nNone from the Core. Profilers and benchmark runners are declared in `.paved\u002Ftools\u002F` or\nsupplied by adapters.\n\n## Rules\n\n`core.performance.measure-before-optimizing` is this skill's contract.\n\n## Verification\n\nRequired: `performance` — the measurement of baseline and result. Recommended: `unit`\nand `integration`, to show behavior did not change.\n\n## Evidence\n\nBaseline and result measurements with workload and environment, and non-regression check\nresults.\n\n## Completion criteria\n\n- The target is met, or the evidence explains why it cannot be with a reasonable change.\n- Baseline and result were measured the same way.\n- Behavior checks pass.\n\n## Failure modes\n\n| Failure | Signal | Response |\n|---|---|---|\n| Noise mistaken for gain | Improvement within variance | Increase repetitions or discard |\n| Different workload | Before and after measured differently | Re-measure both the same way |\n| Micro-optimizing the wrong path | Profile shows the change is not on the hot path | Revert; go back to the profile |\n| Unrepresentative environment | Numbers differ wildly from those reported | State the environment; ask for a better one |\n\n## References\n\n- [references\u002Fmeasurement-protocol.md](references\u002Fmeasurement-protocol.md): how to\n  define and take a trustworthy measurement.\n- [examples\u002Fmeasurement-report.md](examples\u002Fmeasurement-report.md): a synthetic report.\n\n\n## Paved integration\n\nUse the project-local Paved contract as the source of truth. Discover state with `node \"\u003Cplugin root>\u002Fscripts\u002Fpaved.mjs\" status --json`, load only relevant `.paved\u002Fproject\u002F` context, and invoke verification with `node \"\u003Cplugin root>\u002Fscripts\u002Fpaved.mjs\" verify --json`. `\u003Cplugin root>` is the installed Paved plugin directory, two directories above this SKILL.md. Always run the launcher from the repository being worked on, never from the plugin directory. Do not edit generated integration files or bypass Paved lifecycle and ownership checks.\n",{"name":5,"description":7},"main","1cd80f05aff924ea609012e864fa5c22c16c7d2d","plugins\u002Fpaved\u002Fskills\u002Fprofiling",0,"https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved","https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues","2026-11-14 20:09:28",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add andersonmrodrigues\u002Fpaved --skill profiling",{"tool":37,"command":38},"bunx","bunx skills add andersonmrodrigues\u002Fpaved --skill profiling",{"tool":40,"command":41},"pnpm","pnpm dlx skills add andersonmrodrigues\u002Fpaved --skill profiling","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Fplugins\u002Fpaved\u002Fskills\u002Fprofiling\u002FSKILL.md",true,[45,51],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"examples\u002Fmeasurement-report.md","REFERENCE","参考文档",983,"https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Fplugins\u002Fpaved\u002Fskills\u002Fprofiling\u002Fexamples\u002Fmeasurement-report.md",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Fmeasurement-protocol.md",1848,"https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Fplugins\u002Fpaved\u002Fskills\u002Fprofiling\u002Freferences\u002Fmeasurement-protocol.md",[56,63,69,75,81,87],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7DFBWJT4T1MPBHTWT19PBEK","sample-skill","Does a sample task. Use when a sample is needed.","https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Fvalid\u002Fsample-skill\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M7DFBS6WTK30PBSW4ZS0NPWT","unexplained-contract","https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Finvalid\u002Funexplained-contract\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":59,"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},"01M7DFBPJGG170V9WTMFWY73R4","shell-block","https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Finvalid\u002Fshell-block\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":59,"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},"01M7DFBMZYR20JPTXNE5A8EFG6","project-identifier","https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Finvalid\u002Fproject-identifier\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7DFBJ8J533DAKA3FTF54SX3","oversized","https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Finvalid\u002Foversized\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M7DFBFAD0RYCRHTZ2JW4RX7E","no-activation","Does a sample task.","https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Finvalid\u002Fno-activation\u002FSKILL.md",[],[]]