[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M74FDZ57H72EMM8Y2Q04D383":3,"skill-same:01M74FDZ57H72EMM8Y2Q04D383":89},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":28,"commitSha":29,"skillDirectory":30,"forksCount":31,"repositoryHtmlUrl":32,"repositoryHomepageUrl":33,"ownerHtmlUrl":34,"ownerBlogUrl":35,"ownerDescription":36,"updatedAt":37,"install":38,"resources":51},"01M74FDZ57H72EMM8Y2Q04D383","module-health-rollup",null,"Rolls up test-driven module health: parses the stack pack's coverage and test reports, attributes rows to modules through module-map.yml, and writes .paqad\u002Fmodule-health records with blocked_metrics for signals it could not compute. Use when checks finish, when module-health sync runs with a report, or when the user asks to refresh module health or roll up coverage.","Eliyce\u002Fpaqad-ai","Eliyce","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F173689792?v=4","01M74F7NHRXY2FW9KM93WHKHST","01M74F7NJDEWZ2XM9CQV70T3JK",8,"MIT","https:\u002F\u002Fgithub.com\u002FEliyce\u002Fpaqad-ai\u002Fblob\u002Fmain\u002Fruntime\u002Fbase\u002Fskills\u002Fmodule-health-rollup\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: module-health-rollup\ndescription: \"Rolls up test-driven module health: parses the stack pack's coverage and test reports, attributes rows to modules through module-map.yml, and writes .paqad\u002Fmodule-health records with blocked_metrics for signals it could not compute. Use when checks finish, when module-health sync runs with a report, or when the user asks to refresh module health or roll up coverage.\"\nmetadata:\n  model_tier: medium\n  cacheable: 'false'\n  output_format: markdown\n  paqad-meta: skill.meta.yaml\n---\n\n## What It Does\n\nRuns the test-driven module-health rollup. For every module declared in `module-map.yml`, the rollup computes:\n\n| Metric               | Source                                                          |\n| -------------------- | --------------------------------------------------------------- |\n| `coverage_pct`       | Coverage report parsed via the pack's `coverage_format` parser. |\n| `tests_passing`      | Test report parsed via the pack's `test_report_format` parser.  |\n| `tests_failing`      | Same.                                                           |\n| `tests_total`        | Same.                                                           |\n| `change_velocity`    | `git log -- \u003Csources>` over `git_window_days` (default 14).     |\n| `contract_stability` | `public_api_extractor` output. Blocked when extractor absent.   |\n\nCoverage and test rows are attributed to module slugs by matching each file against `module-map.yml`'s `sources:` globs. Files that match no module land in the report's `unattributed_files` list (surfaced to the user as a `MM-ADD` candidate for the reconciler).\n\nHard rule: no metric is fabricated or zeroed. When a signal cannot be computed the metric is set to `null` and the reason recorded in `blocked_metrics` (e.g. `coverage:not_configured`, `tests:report_missing:\u003Cpath>`, `contract_stability:no_public_api_extractor`).\n\n## Use This When\n\n- `feature-development.checks` finishes format\u002Ftest\u002Fbuild and needs to refresh module health.\n- `paqad-ai module-health sync --from-report \u003Cpath>` is invoked.\n- The provider hook at `runtime\u002Fhooks\u002Fmodule-health-sync.sh` fires.\n- A user prompt asks to \"refresh module health\" or \"roll up coverage\".\n\n## Inputs\n\n- The active stack pack's `module_health` block: see `references\u002Fcoverage-formats.md` for the closed format set. Required: `source_roots`, plus at least one of `(coverage_format + coverage_path)` or `(test_report_format + test_report_path)`.\n- `module-map.yml` (read-only) for slug attribution.\n- Optional `--from-report \u003Cpath>` to bypass the pack's report path (typical in CI).\n\n## Procedure\n\n1. Resolve the active stack pack and read its `module_health` block. If the block is absent, hard-fail with `blocked: module_health_unknown` and surface a Decision Pause packet asking the user to add it to the pack.\n2. Invoke the TS engine via the bundled wrapper:\n   ```\n   bash scripts\u002Frollup.sh [project-root] [--from-report \u003Cpath>]\n   ```\n   The wrapper shells out to `paqad-ai module-health rollup --project-root \u003Croot> [--from-report \u003Cpath>]`. Omit `--from-report` to run off the declared report paths in the pack.\n3. Parse the resulting `RollupReport`. Group findings by module.\n4. For each module, surface any `blocked_metrics` entries to the user as informational warnings (not Decision Pause packets: these are config gaps, not choices).\n5. For `unattributed_files`, route the user to the module-map reconciler (`MM-ADD` candidates).\n\n## Output Contract\n\n- Per-module records written to `.paqad\u002Fmodule-health\u002F\u003Cslug>.json` in the schema-v2 shape with `blocked_metrics: string[]` and `evidence.rollup` populated.\n- A `## Module Health Rollup` markdown block listing each module, its tier, and any `blocked_metrics` reasons.\n- A `## Unattributed Coverage Files` block listing files that landed on no module slug.\n\n## Escalate \u002F Stop Conditions\n\n- Hard-fail with `blocked: module_health_unknown` when the active stack pack does not declare a `module_health` block.\n- Stop and route to the module-map reconciler when `unattributed_files` is non-empty: coverage for an undeclared module is a `MM-ADD` candidate.\n- Do **not** invent `contract_stability` when the pack has no `public_api_extractor`. Record `contract_stability:no_public_api_extractor` in `blocked_metrics` and continue.\n\n## Scripts\n\nDeterministic plumbing: do **not** re-derive these in the LLM layer.\n\n- `scripts\u002Frollup.sh [project-root] [--from-report \u003Cpath>]`: invoke the rollup; writes `.paqad\u002Fmodule-health\u002F\u003Cslug>.json` per declared module and prints the rollup report JSON.\n- `scripts\u002Fis-blocked.sh [report.json|-]`: exit 1 with the blocked reason on stdout when the whole rollup is blocked (typically `module_health_unknown`).\n- `scripts\u002Flist-blocked-metrics.sh [report.json|-]`: sorted `\u003Cslug>: \u003Creason>, \u003Creason>` lines for the informational warnings the skill surfaces.\n- `scripts\u002Flist-unattributed.sh [report.json|-]`: sorted file paths for the `## Unattributed Coverage Files` block; these are `MM-ADD` candidates for the module-map reconciler.\n\n## Assets\n\n- `assets\u002Ftemplates\u002Frollup-summary.md`: markdown template for the `## Module Health Rollup` + `## Unattributed Coverage Files` blocks.\n\n## Resources\n\n- `references\u002Fcoverage-formats.md`: supported formats + the no-fabricated-metrics contract.\n- `runtime\u002Fbase\u002Fskills\u002Fmodule-health-rollup\u002Fagents\u002Fopenai.yaml`: agent interface metadata.\n- `src\u002Fmodule-health\u002Frollup.ts`: rollup engine.\n- `src\u002Fmodule-health\u002Fparsers\u002F`: the nine framework-shipped parsers.\n- `src\u002Fvalidators\u002Fschemas\u002Fstack-pack.schema.json`: closed enum for `coverage_format` \u002F `test_report_format`.\n- `runtime\u002Fbase\u002Fskills\u002Fmodule-map-reconciler\u002FSKILL.md`: sibling skill that consumes `unattributed_files` as `MM-ADD` candidates.\n- the Decision Pause Contract (in the framework bootstrap): packet semantics.\n","## What It Does\n\nRuns the test-driven module-health rollup. For every module declared in `module-map.yml`, the rollup computes:\n\n| Metric               | Source                                                          |\n| -------------------- | --------------------------------------------------------------- |\n| `coverage_pct`       | Coverage report parsed via the pack's `coverage_format` parser. |\n| `tests_passing`      | Test report parsed via the pack's `test_report_format` parser.  |\n| `tests_failing`      | Same.                                                           |\n| `tests_total`        | Same.                                                           |\n| `change_velocity`    | `git log -- \u003Csources>` over `git_window_days` (default 14).     |\n| `contract_stability` | `public_api_extractor` output. Blocked when extractor absent.   |\n\nCoverage and test rows are attributed to module slugs by matching each file against `module-map.yml`'s `sources:` globs. Files that match no module land in the report's `unattributed_files` list (surfaced to the user as a `MM-ADD` candidate for the reconciler).\n\nHard rule: no metric is fabricated or zeroed. When a signal cannot be computed the metric is set to `null` and the reason recorded in `blocked_metrics` (e.g. `coverage:not_configured`, `tests:report_missing:\u003Cpath>`, `contract_stability:no_public_api_extractor`).\n\n## Use This When\n\n- `feature-development.checks` finishes format\u002Ftest\u002Fbuild and needs to refresh module health.\n- `paqad-ai module-health sync --from-report \u003Cpath>` is invoked.\n- The provider hook at `runtime\u002Fhooks\u002Fmodule-health-sync.sh` fires.\n- A user prompt asks to \"refresh module health\" or \"roll up coverage\".\n\n## Inputs\n\n- The active stack pack's `module_health` block: see `references\u002Fcoverage-formats.md` for the closed format set. Required: `source_roots`, plus at least one of `(coverage_format + coverage_path)` or `(test_report_format + test_report_path)`.\n- `module-map.yml` (read-only) for slug attribution.\n- Optional `--from-report \u003Cpath>` to bypass the pack's report path (typical in CI).\n\n## Procedure\n\n1. Resolve the active stack pack and read its `module_health` block. If the block is absent, hard-fail with `blocked: module_health_unknown` and surface a Decision Pause packet asking the user to add it to the pack.\n2. Invoke the TS engine via the bundled wrapper:\n   ```\n   bash scripts\u002Frollup.sh [project-root] [--from-report \u003Cpath>]\n   ```\n   The wrapper shells out to `paqad-ai module-health rollup --project-root \u003Croot> [--from-report \u003Cpath>]`. Omit `--from-report` to run off the declared report paths in the pack.\n3. Parse the resulting `RollupReport`. Group findings by module.\n4. For each module, surface any `blocked_metrics` entries to the user as informational warnings (not Decision Pause packets: these are config gaps, not choices).\n5. For `unattributed_files`, route the user to the module-map reconciler (`MM-ADD` candidates).\n\n## Output Contract\n\n- Per-module records written to `.paqad\u002Fmodule-health\u002F\u003Cslug>.json` in the schema-v2 shape with `blocked_metrics: string[]` and `evidence.rollup` populated.\n- A `## Module Health Rollup` markdown block listing each module, its tier, and any `blocked_metrics` reasons.\n- A `## Unattributed Coverage Files` block listing files that landed on no module slug.\n\n## Escalate \u002F Stop Conditions\n\n- Hard-fail with `blocked: module_health_unknown` when the active stack pack does not declare a `module_health` block.\n- Stop and route to the module-map reconciler when `unattributed_files` is non-empty: coverage for an undeclared module is a `MM-ADD` candidate.\n- Do **not** invent `contract_stability` when the pack has no `public_api_extractor`. Record `contract_stability:no_public_api_extractor` in `blocked_metrics` and continue.\n\n## Scripts\n\nDeterministic plumbing: do **not** re-derive these in the LLM layer.\n\n- `scripts\u002Frollup.sh [project-root] [--from-report \u003Cpath>]`: invoke the rollup; writes `.paqad\u002Fmodule-health\u002F\u003Cslug>.json` per declared module and prints the rollup report JSON.\n- `scripts\u002Fis-blocked.sh [report.json|-]`: exit 1 with the blocked reason on stdout when the whole rollup is blocked (typically `module_health_unknown`).\n- `scripts\u002Flist-blocked-metrics.sh [report.json|-]`: sorted `\u003Cslug>: \u003Creason>, \u003Creason>` lines for the informational warnings the skill surfaces.\n- `scripts\u002Flist-unattributed.sh [report.json|-]`: sorted file paths for the `## Unattributed Coverage Files` block; these are `MM-ADD` candidates for the module-map reconciler.\n\n## Assets\n\n- `assets\u002Ftemplates\u002Frollup-summary.md`: markdown template for the `## Module Health Rollup` + `## Unattributed Coverage Files` blocks.\n\n## Resources\n\n- `references\u002Fcoverage-formats.md`: supported formats + the no-fabricated-metrics contract.\n- `runtime\u002Fbase\u002Fskills\u002Fmodule-health-rollup\u002Fagents\u002Fopenai.yaml`: agent interface metadata.\n- `src\u002Fmodule-health\u002Frollup.ts`: rollup engine.\n- `src\u002Fmodule-health\u002Fparsers\u002F`: the nine framework-shipped parsers.\n- `src\u002Fvalidators\u002Fschemas\u002Fstack-pack.schema.json`: closed enum for `coverage_format` \u002F `test_report_format`.\n- `runtime\u002Fbase\u002Fskills\u002Fmodule-map-reconciler\u002FSKILL.md`: sibling skill that consumes `unattributed_files` as `MM-ADD` candidates.\n- the Decision Pause Contract (in the framework bootstrap): packet semantics.\n",{"name":5,"metadata":23,"description":7},{"cacheable":24,"model_tier":25,"paqad-meta":26,"output_format":27},"false","medium","skill.meta.yaml","markdown","main","793418e848ae0410573905284b68adcab385230e","runtime\u002Fbase\u002Fskills\u002Fmodule-health-rollup",0,"https:\u002F\u002Fgithub.com\u002FEliyce\u002Fpaqad-ai","https:\u002F\u002Fpaqad.ai","https:\u002F\u002Fgithub.com\u002FEliyce","https:\u002F\u002Feliyce.com\u002F","AI delivery you can review. Dutch software company building software and AI agents. Makers of Paqad, the open-source AI delivery framework.","2026-11-13 04:41:45",{"source":8,"skillName":5,"commands":39,"prompt":49,"zipAvailable":50},[40,43,46],{"tool":41,"command":42},"npx","npx skills add Eliyce\u002Fpaqad-ai --skill module-health-rollup",{"tool":44,"command":45},"bunx","bunx skills add Eliyce\u002Fpaqad-ai --skill module-health-rollup",{"tool":47,"command":48},"pnpm","pnpm dlx skills add Eliyce\u002Fpaqad-ai --skill module-health-rollup","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FEliyce\u002Fpaqad-ai\u002Fblob\u002Fmain\u002Fruntime\u002Fbase\u002Fskills\u002Fmodule-health-rollup\u002FSKILL.md",true,[52,58,64,68,74,78,82,86],{"path":53,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":56,"sourceHtmlUrl":57},"agents\u002Fopenai.yaml","REFERENCE","参考文档",387,"https:\u002F\u002Fgithub.com\u002FEliyce\u002Fpaqad-ai\u002Fblob\u002Fmain\u002Fruntime\u002Fbase\u002Fskills\u002Fmodule-health-rollup\u002Fagents\u002Fopenai.yaml",{"path":59,"resourceType":60,"resourceTypeDesc":61,"sizeBytes":62,"sourceHtmlUrl":63},"assets\u002Ftemplates\u002Frollup-summary.md","ASSET","资产文件",896,"https:\u002F\u002Fgithub.com\u002FEliyce\u002Fpaqad-ai\u002Fblob\u002Fmain\u002Fruntime\u002Fbase\u002Fskills\u002Fmodule-health-rollup\u002Fassets\u002Ftemplates\u002Frollup-summary.md",{"path":65,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":66,"sourceHtmlUrl":67},"references\u002Fcoverage-formats.md",2505,"https:\u002F\u002Fgithub.com\u002FEliyce\u002Fpaqad-ai\u002Fblob\u002Fmain\u002Fruntime\u002Fbase\u002Fskills\u002Fmodule-health-rollup\u002Freferences\u002Fcoverage-formats.md",{"path":69,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":72,"sourceHtmlUrl":73},"scripts\u002Fis-blocked.sh","SCRIPT","脚本",1007,"https:\u002F\u002Fgithub.com\u002FEliyce\u002Fpaqad-ai\u002Fblob\u002Fmain\u002Fruntime\u002Fbase\u002Fskills\u002Fmodule-health-rollup\u002Fscripts\u002Fis-blocked.sh",{"path":75,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":76,"sourceHtmlUrl":77},"scripts\u002Flist-blocked-metrics.sh",1237,"https:\u002F\u002Fgithub.com\u002FEliyce\u002Fpaqad-ai\u002Fblob\u002Fmain\u002Fruntime\u002Fbase\u002Fskills\u002Fmodule-health-rollup\u002Fscripts\u002Flist-blocked-metrics.sh",{"path":79,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":80,"sourceHtmlUrl":81},"scripts\u002Flist-unattributed.sh",1066,"https:\u002F\u002Fgithub.com\u002FEliyce\u002Fpaqad-ai\u002Fblob\u002Fmain\u002Fruntime\u002Fbase\u002Fskills\u002Fmodule-health-rollup\u002Fscripts\u002Flist-unattributed.sh",{"path":83,"resourceType":70,"resourceTypeDesc":71,"sizeBytes":84,"sourceHtmlUrl":85},"scripts\u002Frollup.sh",905,"https:\u002F\u002Fgithub.com\u002FEliyce\u002Fpaqad-ai\u002Fblob\u002Fmain\u002Fruntime\u002Fbase\u002Fskills\u002Fmodule-health-rollup\u002Fscripts\u002Frollup.sh",{"path":26,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":87,"sourceHtmlUrl":88},822,"https:\u002F\u002Fgithub.com\u002FEliyce\u002Fpaqad-ai\u002Fblob\u002Fmain\u002Fruntime\u002Fbase\u002Fskills\u002Fmodule-health-rollup\u002Fskill.meta.yaml",[90,97,104,109,116,123],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":18},"01M74FSCKQP6TACC8X8AZ19F4V","sample-skill","Sample bundled skill fixture","https:\u002F\u002Fgithub.com\u002FEliyce\u002Fpaqad-ai\u002Fblob\u002Fmain\u002Ftests\u002Funit\u002Fadapters\u002Ffixtures\u002Fsample-skill\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":18},"01M74FSAQ6C28V4G3322XGMARB","processing-invoices","Turns a supplier invoice into one ledger line. Use when a supplier invoice arrives and needs booking.","https:\u002F\u002Fgithub.com\u002FEliyce\u002Fpaqad-ai\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fauthoring\u002Fnpm-project\u002Fskill\u002FSKILL.md",[],[],{"skillNo":105,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":18},"01M74FS914YQKWQNHC58MEG1N8","https:\u002F\u002Fgithub.com\u002FEliyce\u002Fpaqad-ai\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fauthoring\u002Flaravel-project\u002Fskill\u002FSKILL.md",[],[],{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":18},"01M74FS356J9QP10A362QRVCPZ","understand-idea","Chat and Claude Code: Step 1 of the discover journey: clarifies the goal, who benefits, success and constraints into the idea block. Use when the journey directs it to step 1, not directly.","https:\u002F\u002Fgithub.com\u002FEliyce\u002Fpaqad-ai\u002Fblob\u002Fmain\u002Fruntime\u002Fclaude-plugin\u002Fskills\u002Funderstand-idea\u002FSKILL.md",[],[],{"skillNo":117,"name":118,"nameZh":6,"description":119,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":120,"categories":121,"keywords":122,"publishedAt":18},"01M74FRSWEMB7KNVW0TP8P3JKB","size-work","Chat and Claude Code: Suggest a size for a ticket from comparable finished work, as a labelled suggestion the team still owns. Use it when someone asks \"how big is this?\", \"roughly how much work is ABC-12?\", or wants a backlog item sized. It finds the team's sizing scale at first use, picks two to five of the closest finished tickets with links, and gives a size or range with the drivers behind it and a confidence of low, medium or high, lowered and explained when the area's documents are template text. Every result is labelled a suggested size, never a date or a commitment. It writes nothing into the size field unless the user says \"set it\", and it refuses to overwrite an existing size unless the user asks to replace it. Produces the sizing block of the record.","https:\u002F\u002Fgithub.com\u002FEliyce\u002Fpaqad-ai\u002Fblob\u002Fmain\u002Fruntime\u002Fclaude-plugin\u002Fskills\u002Fsize-work\u002FSKILL.md",[],[],{"skillNo":124,"name":125,"nameZh":6,"description":126,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":127,"categories":128,"keywords":129,"publishedAt":18},"01M74FR9A9VPHW1NFAFYZMXE2H","refine-ticket","Chat and Claude Code: Improve one or more existing tracker tickets without losing the author's intent. Use it when someone wants a ticket read, diagnosed and tidied up (\"this ticket is vague\", \"fix up ABC-12\", \"split this, it's too big\"). It reads each ticket in full and snapshots it with its last-updated time, says what is wrong with evidence, and proposes a field-by-field before and after change set limited to summary, description, labels, parent, links and new child tickets on a split. It writes nothing until an explicit \"apply it\" bound to that exact change set, re-checks the ticket for conflicting edits just before writing, never replaces rich descriptions with plain text, never deletes or closes a ticket, and reads each ticket back after applying. Produces the existing and changes blocks of the record.","https:\u002F\u002Fgithub.com\u002FEliyce\u002Fpaqad-ai\u002Fblob\u002Fmain\u002Fruntime\u002Fclaude-plugin\u002Fskills\u002Frefine-ticket\u002FSKILL.md",[],[]]