Pre Review
Testing & Qualitypre-reviewPre Review is an Agent Skill for testing & quality published in the arklexai/Agent-First-Organization repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Check your branch before opening a PR (lint, format, tests, title)
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/arklexai/Agent-First-Organization/blob/HEAD/.claude/skills/pre-review/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/pre-review, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Pre-review
Run local checks to catch issues before opening a PR.
Steps
1. Check branch and changes
git branch --show-current
git status
git log --oneline main..HEAD
2. Run ruff linter
ruff check .
If there are fixable issues, run ruff check --fix . and report what was fixed.
3. Run ruff formatter
ruff format --check .
If files would be reformatted, run ruff format . and report what changed.
4. Run tests
pytest tests/ -x --tb=short
Report pass/fail count and any failures.
5. Check coverage
pytest tests/ --cov=arklex --cov-fail-under=45 --cov-report=term-missing -q
Coverage minimum is 45%. Flag if below threshold.
6. Validate branch name
Branch should follow <type>/<short-description> pattern, e.g. feat/add-retry.
7. Suggest PR title
Based on the commits on this branch, suggest a Conventional Commits title:
- Format:
<type>(<scope>): <description> - Max 72 characters
- Types: feat, fix, docs, chore, ci, build, refactor, test, perf, style, revert
8. Report
Summarize results:
Lint: pass/fail
Format: pass/fail
Tests: X passed, Y failed
Coverage: XX% (minimum 45%)
Branch: <name> (valid/invalid)
Title: <suggested title>