rgvai

Code Architect — Design skill for Claude Code

Design community

A Claude Code Agent skill for software architecture design, code structure planning, and technical documentation.

How to install Code Architect

This entry records only its repository, not the path inside it, so there is no exact command to give. Open rgvai/code-architect and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Code Architect does

A Claude Code Agent skill for software architecture design, code structure planning, and technical documentation.

Alternatives in Design

Part 3 — Technical Design Document Generator — I'll help you create a Technical Design Document for your MVP 2.1k ★
Icm Architect — Claude skill: design any process, idea, or problem into an ICM workspace (folder structure as agent architectu 1.3k ★
Scaffold Project — Scaffold a new design-product project that matches the recommended Claude Code layout (the reference structure 781 ★

README

Code Architect v2

🔍 External code review powered by OpenAI's GPT-5.2-Codex

A Claude Custom Skill that provides intelligent code reviews using OpenAI's most advanced coding model. Get a "second pair of eyes" on your code changes with detailed feedback on bugs, security vulnerabilities, performance issues, and best practices.

✨ Features

Multi-Runtime Support - Automatically detects and uses Node.js (preferred) or Python
Auto-Dependency Installation - Installs the OpenAI package if missing
Multiple Review Types - Standard, security, architecture, and performance focused reviews
Adjustable Reasoning Depth - From quick checks to deep analysis
Structured Output - JSON schema-validated responses with severity-ranked findings
CI/CD Ready - Exit codes for automation, JSON output option

📋 Prerequisites

**OpenAI API Key**
```
export OPENAI_API_KEY="sk-..."
```
**Runtime** (one of):
- Node.js 18+ (preferred)
- Python 3.8+

🚀 Quick Start

As a Claude Custom Skill

Download or clone this repository
Zip the code-architect-v2 folder
Upload to Claude via Settings > Skills
Enable the skill

Then just ask Claude:

"Review my code changes"
"Get a second opinion on this PR"
"Security review of my authentication code"

Standalone Usage

# Review staged git changes
bash scripts/code_review.sh --diff "$(git diff --staged)"

# Review specific files
bash scripts/code_review.sh --files src/auth.js src/api.js

# Security-focused review with high reasoning effort
bash scripts/code_review.sh --diff "$(git diff)" --review-type security --effort high

# Pipe diff directly
git diff HEAD~3 | bash scripts/code_review.sh

📖 Usage

Command Line Options

Usage: code_review.sh [options]

Input Options:
  -d, --diff          Code diff to review
  -f, --files        File paths to review
  -c, --context       Additional context about changes

Review Config