https://github.com/scottconverse/codex-audit-skills
Codex-native audit-lite and audit-full skills with evidence-first review workflows
https://github.com/scottconverse/codex-audit-skills
ai-agents audit codex codex-skills release-gates
Last synced: about 1 month ago
JSON representation
Codex-native audit-lite and audit-full skills with evidence-first review workflows
- Host: GitHub
- URL: https://github.com/scottconverse/codex-audit-skills
- Owner: scottconverse
- License: mit
- Created: 2026-05-26T05:18:26.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-26T05:49:50.000Z (2 months ago)
- Last Synced: 2026-05-26T07:27:29.975Z (2 months ago)
- Topics: ai-agents, audit, codex, codex-skills, release-gates
- Language: Python
- Homepage: https://scottconverse.github.io/codex-audit-skills/
- Size: 1.22 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Codex Audit Skills
Codex-native audit skills adapted from a Claude audit workflow.
This repository packages three installable Codex skills:
- `audit-lite`: a fast, evidence-based audit for bounded changes.
- `audit-full`: a deep multi-role audit packet for release gates and broad reviews.
- `audit-team`: the full five-role audit-team workflow under its original prompt name.
The goal is simple: make Codex audits harder to fake and easier to act on. Findings must cite evidence, classify severity, state blast radius when needed, and give a concrete fix path.
## Fidelity To The Source Skills
These are full-function Codex adaptations of the Claude skills in `source-originals/claude/`, not summaries.
- `skills/audit-lite/SKILL.md` preserves the original compact reviewer workflow, report template, severity framework, blast-radius rules, commitments, guardrails, and sign-off checklist.
- `skills/audit-team/SKILL.md` preserves the original single-file five-role workflow and bundles the role references/templates so its links resolve in Codex.
- `skills/audit-full/SKILL.md` preserves the original bundled `audit-team-full` workflow under the Codex-native `audit-full` name.
Only Claude-specific tool references were adapted, such as replacing `present_files` with Codex final-response file paths and replacing `AskUserQuestion` with a direct user question followed by waiting.
## Install
PowerShell:
```powershell
.\scripts\install.ps1
```
Bash:
```bash
./scripts/install.sh
```
Manual install:
```text
copy skills/audit-lite -> %USERPROFILE%\.codex\skills\audit-lite
copy skills/audit-full -> %USERPROFILE%\.codex\skills\audit-full
copy skills/audit-team -> %USERPROFILE%\.codex\skills\audit-team
```
Restart Codex after installation so the skill list refreshes.
## Use
Examples:
```text
Use $audit-lite to verify this PR before merge.
```
```text
Use $audit-full to perform a release-gate audit of this repo.
```
```text
Use $audit-team to review this project.
```
`audit-team` and `audit-full` both provide the full multi-role audit capability. `audit-full` is the Codex-native name; `audit-team` preserves older handoff compatibility.
## Documentation
- [User Manual](docs/manuals/USER_MANUAL.md)
- [Architecture](docs/architecture/ARCHITECTURE.md)
- [Landing Page](docs/index.html)
- [Discussion Seeds](docs/discussions/)
## Validate
```bash
python scripts/validate_skills.py
```
The validator checks required skill files, frontmatter names, metadata, bundled references, templates, and documentation surfaces.
## Repository Layout
```text
skills/
audit-lite/
audit-full/
audit-team/
docs/
architecture/
manuals/
discussions/
scripts/
tests/
```
## License
MIT