# Acreadiness Policy

Help the user pick, write, or apply an AgentRC policy.

- Repository: https://github.com/github/awesome-copilot (40669 stars)
- Category: Writing
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add github/awesome-copilot --skill acreadiness-policy -g -a claude-code -y`
Codex: `npx skills add github/awesome-copilot --skill acreadiness-policy -g -a codex -y`
Cursor: `npx skills add github/awesome-copilot --skill acreadiness-policy -g -a cursor -y`
Gemini CLI: `npx skills add github/awesome-copilot --skill acreadiness-policy -g -a gemini-cli -y`

## 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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# /acreadiness-policy, AgentRC policies

Use this skill when the user asks about **policies**, **strict mode**, **custom scoring**, **disabling checks**, **org standards**, or **CI gating** of readiness.

A policy is a small JSON file with three optional sections, `criteria`, `extras`, `thresholds`, that customise how AgentRC scores readiness.

## Built-in examples

AgentRC ships with three example policies in `examples/policies/`:

| Policy | What it does |
|---|---|
| `strict.json` | 100% pass rate, raises impact on key criteria |
| `ai-only.json` | Disables all repo-health checks, focuses on AI tooling |
| `repo-health-only.json` | Disables AI checks, focuses on traditional quality |

Recommend these as starting points before writing a custom policy.

## Policy schema

```jsonc
{
  "name": "my-policy",
  "criteria": {
    "disable":  ["env-example", "observability", "dependabot"],
    "override": {
      "readme":      { "impact": "high", "level": 2 },
      "lint-config": { "title": "Linter required" }
    }
  },
  "extras": {
    "disable": ["pre-commit"]
  },
  "thresholds": {
    "passRate": 0.9
  }
}
```

### Impact weights

| Impact | Weight |
|---|---|
| critical | 5 |
| high | 4 |
| medium | 3 |
| low | 2 |
| info | 0 |

`Score = 1 − (deductions / max possible weight)`. Grades: **A** ≥ 0.9, **B** ≥ 0.8, **C** ≥ 0.7, **D** ≥ 0.6, **F** < 0.6.

## Sub-commands

### `show`
List policies currently in effect (from `agentrc.config.json` `policies` array, or none).

The rest: https://github.com/github/awesome-copilot/blob/HEAD/skills/acreadiness-policy/SKILL.md