diff --git a/agents/Mathews-Tom__code-reviewer/README.md b/agents/Mathews-Tom__code-reviewer/README.md
new file mode 100644
index 0000000..cfc0414
--- /dev/null
+++ b/agents/Mathews-Tom__code-reviewer/README.md
@@ -0,0 +1,42 @@
+# code-reviewer
+
+Multi-phase code quality reviewer that systematically analyzes naming conventions, cyclomatic complexity, error handling, DRY violations, security surface, and test coverage gaps. Produces severity-ranked findings with file:line precision and actionable fix recommendations.
+
+## Run
+
+```bash
+npx @open-gitagent/gitagent run -r https://github.com/Mathews-Tom/code-reviewer
+```
+
+## What It Can Do
+
+- **Naming Analysis** — checks variable, function, file, constant, and type naming against language conventions and project-specific config
+- **Complexity Detection** — flags functions exceeding cyclomatic complexity thresholds, deep nesting, excessive parameters, and long function bodies
+- **Error Handling Audit** — identifies bare except/catch blocks, silent failures, missing error handling on I/O operations, and generic error messages
+- **DRY Violation Detection** — finds copy-paste code blocks, repeated patterns, magic numbers, and configuration duplication with extraction recommendations
+- **Security Surface Scan** — lightweight check for hardcoded secrets, SQL concatenation, unvalidated input, and path traversal
+- **Test Coverage Gaps** — identifies untested public API, missing edge case coverage, error path testing gaps, and over-mocking
+
+## Structure
+
+```
+code-reviewer/
+├── .gitignore
+├── LICENSE
+├── README.md
+├── RULES.md
+├── SOUL.md
+├── agent.yaml
+├── assets/
+│   ├── icon.png
+│   └── banner.png
+└── knowledge/
+    ├── complexity-metrics.md
+    ├── naming-conventions.md
+    ├── error-handling-patterns.md
+    └── dry-violations.md
+```
+
+## Built with
+
+Built for the [gitagent](https://gitagent.sh) ecosystem.
diff --git a/agents/Mathews-Tom__code-reviewer/banner.png b/agents/Mathews-Tom__code-reviewer/banner.png
new file mode 100644
index 0000000..bd2a4bb
Binary files /dev/null and b/agents/Mathews-Tom__code-reviewer/banner.png differ
diff --git a/agents/Mathews-Tom__code-reviewer/icon.png b/agents/Mathews-Tom__code-reviewer/icon.png
new file mode 100644
index 0000000..47ecc4a
Binary files /dev/null and b/agents/Mathews-Tom__code-reviewer/icon.png differ
diff --git a/agents/Mathews-Tom__code-reviewer/metadata.json b/agents/Mathews-Tom__code-reviewer/metadata.json
new file mode 100644
index 0000000..c191427
--- /dev/null
+++ b/agents/Mathews-Tom__code-reviewer/metadata.json
@@ -0,0 +1,14 @@
+{
+  "name": "code-reviewer",
+  "author": "Mathews-Tom",
+  "description": "Multi-phase code review with severity-ranked findings across naming, complexity, error handling, DRY violations, and test coverage gaps",
+  "repository": "https://github.com/Mathews-Tom/code-reviewer",
+  "version": "1.0.0",
+  "category": "testing",
+  "tags": ["code-review", "quality", "complexity", "dry", "testing", "linting", "best-practices"],
+  "license": "MIT",
+  "model": "claude-sonnet-4-5-20250929",
+  "adapters": ["claude-code", "system-prompt"],
+  "icon": true,
+  "banner": true
+}