Agent skill

Cto Review

by alirezarezvani in alirezarezvani/claude-skills

/cs:cto-review <plan — Architecture and scaling interrogation.

MITAuto-check passedDevOps & Cloud

Install Cto Review

skills CLI
$ npx skills add alirezarezvani/claude-skills --skill cto-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alirezarezvani/claude-skills cto-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/c-level-agents/skills/cto-review .claude/skills/cto-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cto-review
GitHub stars
28k
Token cost
~848 tokens
SKILL.md length
291 words
Files
1
Skills in repo
342
Repo updated
First seen
Licence
MIT

At a glance

/cs:cto-review <plan — Architecture and scaling interrogation.

  • Works in 6 steps: Scaling Cliff → Tech Debt Inventory → Team Scaling → …
  • Committing to an architecture
  • SKILL.md covers When to Run, The Six CTO Questions, Workflow and Output Format, plus 2 more sections
  • Calls python

What it does

Cto Review is an agent skill from alirezarezvani/claude-skills. /cs:cto-review <plan — Architecture and scaling interrogation. Tech debt, scaling cliffs, team scaling, build-vs-buy. Use when committing to an architecture, planning for 10x load, or weighing a rebuild against a vendor.

Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Technical debt and Site reliability engineering. The repository describes itself as: 380 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 380+ skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8… The licence is MIT.

When your agent uses it

  • Committing to an architecture
  • Planning for 10x load
  • Weighing a rebuild against a vendor

Example prompts

  • “/cto-review”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Scaling Cliff
  2. Tech Debt Inventory
  3. Team Scaling
  4. Build vs Buy
  5. SLO / Reliability
  6. Security & Compliance Surface

What it can do on your machine

Read from SKILL.md and the folder at commit 19392f7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cto Review loads about 848 tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 291 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~848

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from alirezarezvani/claude-skills at commit 19392f7, republished under its MIT licence (© alirezarezvani). 291 words, ~848 tokens.

Download SKILL.mdSave it as .claude/skills/cto-review/SKILL.md (or your agent's skills folder).
name
cto-review
description
/cs:cto-review <plan> — Architecture and scaling interrogation. Tech debt, scaling cliffs, team scaling, build-vs-buy. Use when committing to an architecture, planning for 10x load, or weighing a rebuild against a vendor.

/cs:cto-review — CTO Forcing Questions

Command: /cs:cto-review <plan>

Pressure-tests architecture and engineering scaling decisions. Six questions to surface the next scaling cliff before you hit it.

When to Run

  • Before approving a major architecture change
  • Before doubling the engineering team
  • Before a build-vs-buy decision > $100K/year
  • When a system is showing reliability stress (SLOs missed)
  • Before committing to a new platform / language / DB

The Six CTO Questions

1. Scaling Cliff

Where does the current architecture break, in terms of users / requests / data volume?

  • Be specific. "It breaks at 10× current load because the primary DB writes saturate."
  • If you don't know, run a load test before deciding.
2. Tech Debt Inventory

What's the top tech debt item, what's it costing per week, and when does it become blocking?

bash
python ../../../c-level-advisor/skills/cto-advisor/scripts/tech_debt_analyzer.py
3. Team Scaling

For each open req, what's the ramp time and contribution model?

bash
python ../../../c-level-advisor/skills/cto-advisor/scripts/team_scaling_calculator.py
4. Build vs Buy

Why are we building this instead of buying it — and what's the 3-year TCO of each?

  • If "we want control" or "it's not that hard" — push back.
  • If the answer is "this is our core moat," build.
5. SLO / Reliability

What are the SLOs for this system and what's the current error budget burn?

  • Without an SLO, you can't reason about reliability tradeoffs.
  • See engineering/slo-architect for SLO design.
6. Security & Compliance Surface

What does this expose, and has cs-ciso-advisor signed off?

  • Architecture decisions are compliance decisions.
  • Loop in cs-ciso-advisor before commit.

Workflow

  1. Run the tech debt analyzer + team scaling calculator
  2. Define the scaling-cliff hypothesis explicitly
  3. Cross-check with cs-ciso-advisor for security implications
  4. Apply the verdict

Output Format

markdown
# CTO Review: <plan>
**Date:** YYYY-MM-DD

## Scaling Cliff
- Current capacity: <metric>
- Break point: <metric>
- Headroom: X months at current growth

## Tech Debt
- Top item: <description>
- Cost per week: $X or N eng-hours
- Blocking date estimate: <date>

## Team
- Open reqs: N
- Median ramp: X months
- Contribution model: <pairing / squad / area>

## Build vs Buy
- 3-year build TCO: $X
- 3-year buy TCO: $X
- Strategic fit: <core / context>
- Decision: BUILD | BUY

## Reliability
- SLO defined: yes / no
- Error budget burn: X% (target < Y%)

## Security
- cs-ciso sign-off: ✅ / ❌

## Verdict
🟢 SHIP | 🟡 SHARPEN | 🔴 BLOCK

## Next Steps
[3 concrete actions]

Routing

  • /cs:ciso-review — mandatory if data surface changes
  • /cs:cfo-review — for build-vs-buy > $100K
  • /cs:execute — quarterly plan
  • /cs:boardroom — for architecture pivots

Version: 1.0.0

© alirezarezvani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in c-level-agents/skills/cto-review of alirezarezvani/claude-skills.

Open the folder on GitHubat commit 19392f7

Compare with similar skills

Cto Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cto Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cto Review this skillalirezarezvani/claude-skills28k—~848Automated safety check: PassMIT
Repo Hygiene Scan and FixQwenLM/qwen-code28k—~1.7kAutomated safety check: PassApache-2.0
Broken API InterviewerPrepLabsAI/InterviewMentor112—~2.6kAutomated safety check: PassMIT
PR Reviewagentic-community/mcp-gateway-registry968—~4.7kAutomated safety check: NotesApache-2.0
Roadmap Planningmanager-dot-dev/manager-skills114—~4.9kAutomated safety check: PassMIT
Factor Of Safety Failure Marginhashgraph-online/awesome-codex-plugins1.3k—~1.9kAutomated safety check: PassApache-2.0

Similar skills

  • Scheduled CI skill that scans a repository for small, certain docs, test and code hygiene issues and fixes them on one branch with a commit per finding.

    28k GitHub stars~1.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Broken API Interviewer

    PrepLabsAI/InterviewMentor

    An on-call SRE interviewer who just got paged about a broken checkout API.

    112 GitHub stars~2.6k tokensUpdated 3 days ago
    DevOps & CloudAuto-check passed
  • PR Review

    agentic-community/mcp-gateway-registry

    Review a GitHub pull request using multiple expert personas.

    968 GitHub stars~4.7k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Roadmap Planning

    manager-dot-dev/manager-skills

    Helps engineering managers plan roadmaps, prioritize work, and communicate priorities effectively — produces the 20% tech debt framework (and its 5 traps), a phased release pressure-test, a…

    114 GitHub stars~4.9k tokensUpdated 5 mo ago
    Product & Project ManagementAuto-check passed
  • Factor Of Safety Failure Margin

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when planning capacity, redundancy, graceful degradation, or recovery for systems that must keep working under stress — performance budgets, dependency failure handling…

    1.3k GitHub stars~1.9k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Release Engineering

    magnus919/agent-skills

    Design, automate, and operate end-to-end software releases: release process models and pipelines (trunk-based development, CD stages, release trains), progressive delivery and feature flags…

    115 GitHub stars~3.9k tokensUpdated today
    DevOps & CloudAuto-check passed

More from alirezarezvani/claude-skills

All 342 skills in this repo
  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Auto-check passed
  • Product Strategist

    alirezarezvani/claude-skills

    OKR cascade toolkit for product leaders: generates aligned company-to-team OKRs from five strategy types and scores how well they line up.

    28k GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • App Store Optimization

    alirezarezvani/claude-skills

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.

    28k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AWS Solution Architect

    alirezarezvani/claude-skills

    Design AWS architectures for startups using serverless patterns and IaC templates.

    28k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Campaign Analytics

    alirezarezvani/claude-skills

    Calculates attribution, funnel and ROI figures for marketing campaigns with three Python scripts that need only the standard library.

    28k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • Code to PRD

    alirezarezvani/claude-skills

    Reverse-engineers a frontend, backend or fullstack codebase into a product requirements document with per-page docs, an enum dictionary and an API inventory.

    28k GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed

Questions about Cto Review

What does Cto Review do?

/cs:cto-review <plan — Architecture and scaling interrogation. Cto Review is an agent skill from alirezarezvani/claude-skills. /cs:cto-review <plan — Architecture and scaling interrogation.

When should I use Cto Review?

Cto Review fits situations like: committing to an architecture; planning for 10x load; weighing a rebuild against a vendor.

How do I install Cto Review in Claude Code?

Run `npx skills add alirezarezvani/claude-skills --skill cto-review -a claude-code`. Or copy the skill folder (c-level-agents/skills/cto-review in alirezarezvani/claude-skills) into .claude/skills/cto-review in your project. Claude Code loads it when a task matches its description.

How do I install Cto Review in Codex?

Run `npx skills add alirezarezvani/claude-skills --skill cto-review -a codex`. Or copy the skill folder (c-level-agents/skills/cto-review in alirezarezvani/claude-skills) into .agents/skills/cto-review in your project. Codex loads it when a task matches its description.

Can I use Cto Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alirezarezvani/claude-skills --skill cto-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cto-review, .gemini/skills/cto-review, .github/skills/cto-review and .opencode/skills/cto-review in your project.

What does Cto Review need to run?

Going by SKILL.md and its folder, Cto Review needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Cto Review access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Cto Review safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cto Review use?

Cto Review is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cto Review use?

About 848 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Cto Review?

Skills that share tags, products or a category with Cto Review: Repo Hygiene Scan and Fix (QwenLM/qwen-code, 28k stars), Broken API Interviewer (PrepLabsAI/InterviewMentor, 112 stars), PR Review (agentic-community/mcp-gateway-registry, 968 stars) and Roadmap Planning (manager-dot-dev/manager-skills, 114 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cto Review?

alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-skills, which has 27,938 GitHub stars. The repository holds 342 skills in this directory. The repository was last updated on August 30, 2026.

Source: alirezarezvani/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.