# Review Code

> High-level code review audit of local changes when preparing to send a PR for review

- Skill: `bazelbuild/review-code` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add bazelbuild/review-code`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bazelbuild/review-code/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: bazelbuild (https://skillmd.com/u/bazelbuild)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/bazelbuild/review-code

---


When preparing to send a Pull Request for review, invoke **separate, concurrent
sub-agents** (`invoke_subagent`), where each sub-agent focuses exclusively on
its assigned checklist category.

**CRITICAL**: Do NOT use a single sub-agent to validate multiple or all
dimensions at once. Each sub-agent must be launched with its own distinct prompt
file from `.agents/skills/review-code/`:

### Audit Checklist & Sub-Agent Prompts

1. **Starlark / Bazel Sub-Agent** (`Role: "Starlark Code Auditor"`):
   - Prompt file:
     `.agents/skills/review-code/review-starlark-prompt.md`
   - Focus: Audits Starlark / Bazel changes (`*.bzl`, `BUILD`, `*.bazel` files)
     in `git diff` against `.agents/rules/bzl.md` and Starlark rules in
     `AGENTS.md`.

2. **Python Code Sub-Agent** (`Role: "Python Code Auditor"`):
   - Prompt file:
     `.agents/skills/review-code/review-python-prompt.md`
   - Focus: Audits Python source and test changes in `git diff` against
     `.agents/rules/python.md` and Python and pytest conventions in `AGENTS.md`.

3. **Documentation Sub-Agent** (`Role: "Documentation Auditor"`):
   - Prompt file:
     `.agents/skills/review-code/review-docs-prompt.md`
   - Focus: Audits documentation (`.md`) changes and docs build targets against
     `.agents/rules/docs.md`, `.agents/rules/news.md`, and `AGENTS.md`.

4. **Contribution Guidelines Sub-Agent** (`Role: "Contributing Auditor"`):
   - Prompt file:
     `.agents/skills/review-code/review-contributing-prompt.md`
   - Focus: Audits changes, requirements updates, directives, and news entry
     files (`news/<id>.<category>.md`) against `CONTRIBUTING.md` and
     `.agents/rules/news.md`.

5. **Project Conventions Sub-Agent** (`Role: "Project Conventions Auditor"`):
   - Prompt file:
     `.agents/skills/review-code/review-agents-prompt.md`
   - Focus: Audits overall workspace compliance against `AGENTS.md`.

6. **Pull Request Standards Sub-Agent** (`Role: "PR Standards Auditor"`):
   - Prompt file:
     `.agents/skills/review-code/review-pr-standards-prompt.md`
   - Focus: Audits PR titles and descriptions against Conventional Commits
     formatting and PR update rules in `CONTRIBUTING.md`.

7. **GitHub Workflows Sub-Agent** (`Role: "GitHub Workflows Auditor"`):
   - Prompt file:
     `.agents/skills/review-code/review-workflows-prompt.md`
   - Focus: Audits workflow files (`.github/**`) and workflow tests against
     `.agents/rules/github_actions_workflows.md` (e.g. `chmod +x` executable
     permissions, shebangs, action versions, fallback jobs).

### Action Instructions
- Immediately create a user-facing review artifact named
  `code-review-results.md` in the conversation artifact directory so progress
  is visible right away.
- Launch all sub-agents concurrently using `invoke_subagent`.
- Update `code-review-results.md` as sub-agent responses come in.
- The artifact must include:
  - Overall summary and verdict across audit categories.
  - Detailed analysis and findings from each sub-agent.
  - Actionable findings and fix suggestions with specific code snippets, diffs,
    and clickable file links for any violations found.
- Once all sub-agents finish, finalize `code-review-results.md` and provide a
  concise summary with the overall verdict and a clickable markdown link to
  `code-review-results.md` in the response.