A standalone Codex plugin containing the clean-code-review skill for concise, evidence-backed reviews of code changes and pull requests.
| What you want | Install |
|---|---|
| Implementation, fixes, and refactoring only | Clean Coding (clean-coding) |
| Code and pull-request reviews only | Clean Code Review (clean-code-review) |
| Both skills plus task routing and Git/delivery conventions | Clean Workflow |
Clean Workflow bundles both skills, so users of the full workflow do not need to install the standalone plugins as well. Each standalone plugin works without Clean Workflow and follows the user's existing project instructions. You can also install both standalone plugins if you want both skills without the workflow.
For the full bundle, use the installation instructions in the Clean Workflow README.
codex plugin marketplace add wgtechlabs/clean-code-review
codex plugin add clean-code-review@clean-code-reviewStart a new chat after installation and invoke $clean-code-review.
Agents supporting the Agent Skills format can load skills/clean-code-review/ directly.
Review correctness, security, maintainability, unnecessary complexity, and relevant UI accessibility and interaction behavior. Findings include exact locations, concrete consequences, and validation limits.
The skill is self-contained and requires no other skills. Repository access and task-specific verification tools are still needed. Publishing reviews requires authorization; permission to comment alone does not authorize approval. Read-only requests are respected. Installing this skill does not authorize merging, deploying, or resolving other reviewers' threads.
Before adding findings, validate existing reviews and threads against the current code. Reuse existing findings rather than duplicate them, and publish new evidence-backed findings when reviewing a PR unless the user requests otherwise. Implementation and review-thread resolution belong to Clean Coding.
Extracted from Clean Workflow. The skill includes its source lineage and the Codelynx article that inspired the workflow.
This repository is the canonical source for clean-code-review. Make changes to this
skill here; Clean Workflow consumes released updates as reviewed downstream
imports. The bundle can lag behind the standalone release until its update PR
is reviewed and merged.
Use short-lived feature branches from dev, squash merge feature PRs into dev, and promote dev to main with a regular merge commit. Follow Clean Commit message conventions.
Pushes to main run Release Build Flow.
The workflow plans a SemVer release from Clean Commit history, updates the plugin
manifest, then commits it with the changelog before creating the tag and GitHub Release.
The initial release is 0.1.0. No release runs on dev.
The workflow uses the built-in GITHUB_TOKEN with contents: write; no PAT secret
is required. Branch rules must allow its release commit. Token-generated pushes
do not trigger another release run. After a release, sync main back into dev
to retain generated version and changelog changes.
MIT. See LICENSE.