{"id":"aeec3c55-89c8-4ea6-9268-a328d6b14aef","shortId":"udGnXm","kind":"skill","title":"acreadiness-policy","tagline":"Help the user pick, write, or apply an AgentRC policy. Policies customise readiness scoring by disabling irrelevant checks, overriding impact/level, setting pass-rate thresholds, or chaining org baselines with team overrides. Use when the user asks about strict mode, AI-only scor","description":"# /acreadiness-policy — AgentRC policies\n\nUse this skill when the user asks about **policies**, **strict mode**, **custom scoring**, **disabling checks**, **org standards**, or **CI gating** of readiness.\n\nA policy is a small JSON file with three optional sections — `criteria`, `extras`, `thresholds` — that customise how AgentRC scores readiness.\n\n## Built-in examples\n\nAgentRC ships with three example policies in `examples/policies/`:\n\n| Policy | What it does |\n|---|---|\n| `strict.json` | 100% pass rate, raises impact on key criteria |\n| `ai-only.json` | Disables all repo-health checks, focuses on AI tooling |\n| `repo-health-only.json` | Disables AI checks, focuses on traditional quality |\n\nRecommend these as starting points before writing a custom policy.\n\n## Policy schema\n\n```jsonc\n{\n  \"name\": \"my-policy\",\n  \"criteria\": {\n    \"disable\":  [\"env-example\", \"observability\", \"dependabot\"],\n    \"override\": {\n      \"readme\":      { \"impact\": \"high\", \"level\": 2 },\n      \"lint-config\": { \"title\": \"Linter required\" }\n    }\n  },\n  \"extras\": {\n    \"disable\": [\"pre-commit\"]\n  },\n  \"thresholds\": {\n    \"passRate\": 0.9\n  }\n}\n```\n\n### Impact weights\n\n| Impact | Weight |\n|---|---|\n| critical | 5 |\n| high | 4 |\n| medium | 3 |\n| low | 2 |\n| info | 0 |\n\n`Score = 1 − (deductions / max possible weight)`. Grades: **A** ≥ 0.9, **B** ≥ 0.8, **C** ≥ 0.7, **D** ≥ 0.6, **F** < 0.6.\n\n## Sub-commands\n\n### `show`\nList policies currently in effect (from `agentrc.config.json` `policies` array, or none).\n\n### `new <name>`\nScaffold `policies/<name>.json` with sensible defaults. Walk the user through:\n1. **What to disable** — irrelevant pillars or extras for their stack (e.g. disable `observability` for a static site).\n2. **What to raise** — override `impact` to `high` or `critical` for must-haves (e.g. `readme`, `codeowners`).\n3. **Pass-rate threshold** — typical org baselines: `0.7` (lenient), `0.85` (standard), `1.0` (strict).\n4. Reference the policy from `agentrc.config.json`:\n   ```json\n   { \"policies\": [\"./policies/<name>.json\"] }\n   ```\n\n### `apply <path-or-pkg>`\nRun `agentrc readiness --json --policy <source>` and re-render the report by handing off to the `assess` skill / `ai-readiness-reporter` agent. Supports chaining:\n```bash\nnpx -y github:microsoft/agentrc readiness --json --policy ./org-baseline.json,./team-frontend.json\n```\n\n## CI gating\n\nCombine policies with `--fail-level` to enforce a minimum maturity level in CI:\n\n```yaml\n- run: npx -y github:microsoft/agentrc readiness --policy ./policies/strict.json --fail-level 3\n```\n\n## Advanced\n\nJSON policies can disable, override, and set thresholds — but **cannot add new criteria**. For new detection logic, point users at AgentRC's TypeScript plugin system (`docs/dev/plugins.md`).\n\n## Operating rules\n\n- **Never silently disable a pillar.** If the user wants to disable `observability`, confirm and explain the trade-off.\n- **Prefer overriding `impact` over disabling.** Disabling hides the gap entirely; overriding lets it still appear in the report.\n- **Recommend extras stay enabled.** They cost nothing — they don't affect the score.\n- **Suggest layering** — most orgs want a baseline policy + per-team overrides chained with `--policy a.json,b.json`.","tags":["acreadiness","policy","awesome","copilot","github","agent-skills","agents","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"capabilities":["skill","source-github","skill-acreadiness-policy","topic-agent-skills","topic-agents","topic-awesome","topic-custom-agents","topic-github-copilot","topic-hacktoberfest","topic-prompt-engineering"],"categories":["awesome-copilot"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/github/awesome-copilot/acreadiness-policy","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add github/awesome-copilot","source_repo":"https://github.com/github/awesome-copilot","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 33270 github stars · SKILL.md body (3,229 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:52:03.889Z","embedding":null,"createdAt":"2026-05-04T06:51:34.316Z","updatedAt":"2026-05-18T18:52:03.889Z","lastSeenAt":"2026-05-18T18:52:03.889Z","tsv":"'/acreadiness-policy':48 '/org-baseline.json':331 '/policies':295 '/policies/strict.json':357 '/team-frontend.json':332 '0':194 '0.6':209,211 '0.7':207,281 '0.8':205 '0.85':283 '0.9':180,203 '1':196,238 '1.0':285 '100':110 '2':166,192,256 '3':190,273,361 '4':188,287 '5':186 'a.json':456 'acreadi':2 'acreadiness-polici':1 'add':373 'advanc':362 'affect':438 'agent':320 'agentrc':12,49,90,97,299,383 'agentrc.config.json':222,292 'ai':45,127,131,317 'ai-on':44 'ai-only.json':118 'ai-readiness-report':316 'appear':424 'appli':10,297 'array':224 'ask':40,57 'assess':314 'b':204 'b.json':457 'baselin':32,280,447 'bash':323 'built':94 'built-in':93 'c':206 'cannot':372 'chain':30,322,453 'check':21,65,124,132 'ci':69,333,348 'codeown':272 'combin':335 'command':214 'commit':177 'config':169 'confirm':403 'cost':433 'criteria':84,117,154,375 'critic':185,265 'current':218 'custom':62,145 'customis':15,88 'd':208 'deduct':197 'default':233 'dependabot':160 'detect':378 'disabl':19,64,119,130,155,174,241,250,366,393,401,414,415 'docs/dev/plugins.md':388 'e.g':249,270 'effect':220 'enabl':431 'enforc':342 'entir':419 'env':157 'env-exampl':156 'exampl':96,101,158 'examples/policies':104 'explain':405 'extra':85,173,245,429 'f':210 'fail':339,359 'fail-level':338,358 'file':79 'focus':125,133 'gap':418 'gate':70,334 'github':326,353 'grade':201 'hand':310 'have':269 'health':123 'help':4 'hide':416 'high':164,187,263 'impact':114,163,181,183,261,412 'impact/level':23 'info':193 'irrelev':20,242 'json':78,230,293,296,301,329,363 'jsonc':149 'key':116 'layer':442 'lenient':282 'let':421 'level':165,340,346,360 'lint':168 'lint-config':167 'linter':171 'list':216 'logic':379 'low':191 'matur':345 'max':198 'medium':189 'microsoft/agentrc':327,354 'minimum':344 'mode':43,61 'must':268 'must-hav':267 'my-polici':151 'name':150 'never':391 'new':227,374,377 'none':226 'noth':434 'npx':324,351 'observ':159,251,402 'oper':389 'option':82 'org':31,66,279,444 'overrid':22,35,161,260,367,411,420,452 'pass':26,111,275 'pass-rat':25,274 'passrat':179 'per':450 'per-team':449 'pick':7 'pillar':243,395 'plugin':386 'point':141,380 'polici':3,13,14,50,59,74,102,105,146,147,153,217,223,229,290,294,302,330,336,356,364,448,455 'possibl':199 'pre':176 'pre-commit':175 'prefer':410 'qualiti':136 'rais':113,259 'rate':27,112,276 're':305 're-rend':304 'readi':16,72,92,300,318,328,355 'readm':162,271 'recommend':137,428 'refer':288 'render':306 'repo':122 'repo-health':121 'repo-health-only.json':129 'report':308,319,427 'requir':172 'rule':390 'run':298,350 'scaffold':228 'schema':148 'scor':47 'score':17,63,91,195,440 'section':83 'sensibl':232 'set':24,369 'ship':98 'show':215 'silent':392 'site':255 'skill':53,315 'skill-acreadiness-policy' 'small':77 'source-github' 'stack':248 'standard':67,284 'start':140 'static':254 'stay':430 'still':423 'strict':42,60,286 'strict.json':109 'sub':213 'sub-command':212 'suggest':441 'support':321 'system':387 'team':34,451 'three':81,100 'threshold':28,86,178,277,370 'titl':170 'tool':128 'topic-agent-skills' 'topic-agents' 'topic-awesome' 'topic-custom-agents' 'topic-github-copilot' 'topic-hacktoberfest' 'topic-prompt-engineering' 'trade':408 'trade-off':407 'tradit':135 'typescript':385 'typic':278 'use':36,51 'user':6,39,56,236,381,398 'walk':234 'want':399,445 'weight':182,184,200 'write':8,143 'y':325,352 'yaml':349","prices":[{"id":"9ea3638b-9814-4096-a195-dd38b3a5eb71","listingId":"aeec3c55-89c8-4ea6-9268-a328d6b14aef","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"github","category":"awesome-copilot","install_from":"skills.sh"},"createdAt":"2026-05-04T06:51:34.316Z"}],"sources":[{"listingId":"aeec3c55-89c8-4ea6-9268-a328d6b14aef","source":"github","sourceId":"github/awesome-copilot/acreadiness-policy","sourceUrl":"https://github.com/github/awesome-copilot/tree/main/skills/acreadiness-policy","isPrimary":false,"firstSeenAt":"2026-05-04T06:51:34.316Z","lastSeenAt":"2026-05-18T18:52:03.889Z"}],"details":{"listingId":"aeec3c55-89c8-4ea6-9268-a328d6b14aef","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"github","slug":"acreadiness-policy","github":{"repo":"github/awesome-copilot","stars":33270,"topics":["agent-skills","agents","ai","awesome","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"license":"mit","html_url":"https://github.com/github/awesome-copilot","pushed_at":"2026-05-18T01:26:59Z","description":"Community-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.","skill_md_sha":"ba2476200d292552f1d859a9ba51da0b37b1c926","skill_md_path":"skills/acreadiness-policy/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/github/awesome-copilot/tree/main/skills/acreadiness-policy"},"layout":"multi","source":"github","category":"awesome-copilot","frontmatter":{"name":"acreadiness-policy","description":"Help the user pick, write, or apply an AgentRC policy. Policies customise readiness scoring by disabling irrelevant checks, overriding impact/level, setting pass-rate thresholds, or chaining org baselines with team overrides. Use when the user asks about strict mode, AI-only scoring, custom weights, CI gating, or wants org-wide standardisation."},"skills_sh_url":"https://skills.sh/github/awesome-copilot/acreadiness-policy"},"updatedAt":"2026-05-18T18:52:03.889Z"}}