compliance-readiness — Claude Code skill: what it does, how to install
Runs a 6-question compliance officer interrogation to pressure-test compliance programs before audits or new framework adoption. Maps overlapping controls and flags gaps.
/plugin marketplace add alirezarezvani/claude-skills
/plugin install compliance-os@claude-code-skillsWhat compliance-readiness does
This skill runs a structured pressure test on any compliance program before certification stage 1 or annual audit planning. It applies six forcing questions. Checks cover scope across standards like HIPAA, FINMA, or ISO 42001, auditor independence under Clause 9.2, and unified management reviews under Clause 9.3.
The workflow relies on four Python utilities from compliance-os. Specifically, framework_selector.py processes company profiles, cross_framework_mapper.py calculates control overlap, evidence_pool_generator.py tracks evidence ownership, and audit_simulator.py tests finding distribution. At the end, it outputs a status verdict (READY, STAGE-2-CANDIDATE, or NOT-READY) with three next actions.
You need Python and JSON input files (profile.json, program.json, scope.json) to run these checks. Install this skill if you manage multiple overlapping frameworks at once. Teams targeting a single standard with no cross-framework overlap can skip it.
What it helps with
- map overlapping controls across frameworks to reuse evidence records
- organize annual audit schedules while maintaining auditor independence under Clause 9.2
- run a mock audit using
audit_simulator.pyto evaluate finding severity distribution - detect unowned or stale compliance evidence before formal audits
Example prompts for the agent
- /compliance-os:compliance-readiness enterprise-program
- Pressure-test our compliance program before finalizing the annual audit calendar
- Run the 6-question compliance readiness check on program.json
How to install compliance-readiness
1Plugin marketplace
/plugin marketplace add alirezarezvani/claude-skills/plugin install compliance-os@claude-code-skillsThis installs the whole compliance-os plugin with all its skills
2Skills CLI (Vercel)
npx skills add alirezarezvani/claude-skills --skill compliance-readiness -a claude-code3Manually: put the files in place
~/.claude/skills/compliance-readiness/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/compliance-readiness/
Manually: put the files in place
.agents/skills/compliance-readiness/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/compliance-readiness/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install alirezarezvani/claude-skills compliance-readiness2Manually: put the files in place
.github/skills/compliance-readiness/SKILL.mdPlatform CLI
gemini skills install https://github.com/alirezarezvani/claude-skills --path compliance-os/skills/compliance-readinessManually: put the files in place
.devin/skills/compliance-readiness/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set349
The whole set →Similar
Questions about compliance-readiness
How to install compliance-readiness in Claude Code?
Run /plugin marketplace add alirezarezvani/claude-skills, then install it with /plugin install compliance-os@claude-code-skills. Alternatively, run npx skills add alirezarezvani/claude-skills --skill compliance-readiness -a claude-code.
What does compliance-readiness do?
It conducts a six-question interrogation of a compliance program, maps shared controls across frameworks, and issues a readiness verdict before audits or framework additions.
What prerequisites are required to run the workflow?
You need Python installed locally along with input JSON files such as profile.json, program.json, and scope.json for the analysis scripts to run.
Source text
SKILL.md · MIT
---
name: "compliance-readiness"
description: "/compliance-os:compliance-readiness [program] — Multi-framework compliance officer 6-question forcing interrogation of any compliance program. Use before starting a new framework, planning the annual audit calendar, or preparing for certification stage 1."
---
# /compliance-os:compliance-readiness — Compliance Officer Forcing Questions
**Command:** `/compliance-os:compliance-readiness <program>`
The multi-framework compliance officer pressure-tests any compliance program. Six questions before any new-framework commitment, audit cycle planning, or certification readiness sign-off.
## When to Run
- Before adopting a new compliance framework
- Before annual audit calendar finalization
- Before certification stage 1 readiness sign-off
- Before management review (Clause 9.3 across frameworks)
- When evidence-collection effort has grown 50%+ year-over-year (a smell)
- When an audit produced > 15% critical findings
## The Six Compliance Officer Questions
### 1. Have you named every applicable framework?
**No framework selector run, no defensible scope.**
- Run `framework_selector.py` with company profile
- Forgetting a framework means rebuilding the audit program later
- Pay attention to industry-specific overlays (financial: NYDFS, FINMA; healthcare: HIPAA, ISO 13485; AI: ISO 42001 + EU AI Act)
### 2. Where do the frameworks overlap, and what's the reuse leverage?
**Single evidence -> N controls = the cornerstone of multi-framework efficiency.**
- Run `cross_framework_mapper.py` with enabled frameworks
- HIGH-confidence mappings: same evidence; MEDIUM: existing + overlay; LOW: new artefact
- Without overlap analysis, you'll collect the same access-review records 3 times
### 3. Who owns each artefact, and what's the reuse-leverage score?
**Joint ownership without accountability is the most common cause of stale evidence.**
- Run `evidence_pool_generator.py` for the artefact inventory
- HIGH-leverage artefacts (≥ 5 mappings) get built first
- Each artefact needs one accountable owner
- Stale evidence is an effective gap — even if the artefact existed historically
### 4. What's the audit calendar, and is auditor independence respected?
**Surveillance audits stacking in the same week is a smell.**
- Use per-framework audit-plan tools (aims_audit_scheduler, isms_audit_scheduler, audit_schedule_optimizer)
- Auditor cannot audit their own work (Clause 9.2 across all ISO standards)
- For small teams: rotate auditors + occasional external auditor
### 5. What does a mock audit produce, and is the severity distribution healthy?
**No mock audit, no readiness signal.**
- Run `audit_simulator.py` with framework + scope
- Healthy distribution: ≥ 40% observation, ≤ 15% critical
- All-critical findings = destructive audit OR genuinely failing program
- All-observation findings = audit too superficial
### 6. What's the management review cadence across frameworks?
**Each framework wants its own management review; an integrated review (per Annex SL) saves 5x exec time.**
- Schedule one quarterly cross-framework review covering all enabled frameworks' Clause 9.3 inputs
- Inputs: risk register changes, open nonconformities, audit findings, incidents, drift, KPIs
- Outputs: action items, resource decisions, scope adjustments
## Workflow
```bash
# 1. Framework selection
python ../../skills/compliance-os/scripts/framework_selector.py profile.json
# 2. Cross-framework overlap
python ../../skills/compliance-os/scripts/cross_framework_mapper.py program.json
# 3. Evidence pool consolidation
python ../../skills/compliance-os/scripts/evidence_pool_generator.py program.json
# 4. Mock audit (per framework)
python ../../skills/compliance-os/scripts/audit_simulator.py scope.json
```
## Output Format
```markdown
# Compliance Readiness: <program>
**Date:** YYYY-MM-DD
## The Decision Being Made
[framework-set | audit-calendar | certification-readiness | evidence-consolidation]
## Framework Set
- Applicable: <list>
- Binding (regulations): <count>
- Certifiable: <count>
- Missing dependencies: <list>
## Cross-Framework Overlap
- Total merged controls in scope: N
- High-leverage artefacts (≥ 5 mappings): M
- Top reuse opportunities: <top 5 artefacts>
## Evidence Pool
- Artefacts in catalog: N
- High-leverage count: M
- Stale evidence rate: X%
- Unowned artefacts: K
## Audit Calendar
- Frameworks scheduled this year: <list>
- Auditor independence respected: Y/N
- Conflicts: <list>
## Mock Audit Results (per framework)
- <framework>: total findings N, critical X%, observation Y%, healthy distribution: Y/N
## Verdict
🟢 READY | 🟡 STAGE-2-CANDIDATE | 🔴 NOT-READY
## Top 3 Actions
[3 concrete next steps with owners + dates]
```
## Routing
- `/compliance-os:aims-audit` — for ISO 42001-specific forcing questions
- `/compliance-os:ai-act-readiness` — for EU AI Act-specific forcing questions
- `/c-level-agents:ciso-review` — for cybersecurity strategy
- `/c-level-agents:caio-review` — for executive AI strategy
- `/c-level-agents:gc-review` — for novel-case legal review
- `/c-level-agents:decide` — to log the verdict
- `/c-level-agents:freeze 30` — on certification commitments (multi-year financial impact)
## Related
- Agent: [`cs-compliance-officer`](../../agents/cs-compliance-officer.md)
- Skill: [`compliance-os`](../compliance-os/SKILL.md)
- Adjacent: `${CLAUDE_PLUGIN_ROOT}/vendor/ra-qm-team/iso42001-specialist/`, `${CLAUDE_PLUGIN_ROOT}/vendor/ra-qm-team/eu-ai-act-specialist/`, `${CLAUDE_PLUGIN_ROOT}/vendor/ra-qm-team/information-security-manager-iso27001/`, `${CLAUDE_PLUGIN_ROOT}/vendor/ra-qm-team/soc2-compliance/`, `${CLAUDE_PLUGIN_ROOT}/vendor/ra-qm-team/gdpr-dsgvo-expert/`
---
**Version:** 1.0.0
© Alireza Rezvani · MIT · alirezarezvani/claude-skills