# Pre Review

> Check your branch before opening a PR (lint, format, tests, title) Use when this capability is needed.

- Skill: `tomevault-io/pre-review` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/pre-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/pre-review/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/pre-review

---


# Pre-review

Run local checks to catch issues before opening a PR.

## Steps

### 1. Check branch and changes

```bash
git branch --show-current
git status
git log --oneline main..HEAD
```

### 2. Run ruff linter

```bash
ruff check .
```

If there are fixable issues, run `ruff check --fix .` and report what was fixed.

### 3. Run ruff formatter

```bash
ruff format --check .
```

If files would be reformatted, run `ruff format .` and report what changed.

### 4. Run tests

```bash
pytest tests/ -x --tb=short
```

Report pass/fail count and any failures.

### 5. Check coverage

```bash
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>
```

---
> Source: [arklexai/Agent-First-Organization](https://github.com/arklexai/Agent-First-Organization) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-24 -->