cto-review

cto-review is a skill for Codex from bestagentkits/agency-skills. It costs 53 tokens per session (882 once invoked), scanned A, original, MIT.

A set of questions for testing whether a proposed software architecture and engineering plan can handle future growth and changing team needs.

In plain words
What is it for?
Use it before major architecture changes, platform or language choices, large hiring plans, vendor decisions, or efforts to support much higher traffic.
Why use it?
It exposes scaling limits, technical debt, staffing concerns, and build-versus-buy trade-offs before they become expensive problems.

Skill for Codex

Written for Codex: agents/openai.yaml present.

Needs its repository: it reads a path above its own folder, which exists only inside the repository. The line is python ../../../skills/cto-advisor/scripts/tech_debt_analyzer.py.

Good fit Use it before major architecture changes, platform or language choices, large hiring plans, vendor decisions, or efforts to support much higher traffic.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo
git clone --depth 1 https://github.com/bestagentkits/agency-skills
agentmods
npx agentmods add skills/bestagentkits/agency-skills/cto-review

Made for: Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for cto-review

README.md
[![agentmods](https://agentmods.dev/badge/skills/bestagentkits/agency-skills/cto-review/github.svg)](https://agentmods.dev/skills/bestagentkits/agency-skills/cto-review)
Your own site
<a href="https://agentmods.dev/skills/bestagentkits/agency-skills/cto-review"><img src="https://agentmods.dev/badge/skills/bestagentkits/agency-skills/cto-review/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for cto-review

Your own site · 80×15
<a href="https://agentmods.dev/skills/bestagentkits/agency-skills/cto-review"><img src="https://agentmods.dev/badge/skills/bestagentkits/agency-skills/cto-review.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 53 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 882 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00053 $0.00882
Opus 5 $0.00026 $0.00441
Sonnet 5 $0.00011 $0.00176
Haiku 4.5 $0.00005 $0.00088

Measured 9d ago against content hash c800c8619626, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

cto-review scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/claude-skills/cto-review/SKILL.md · 118 lines

How it starts

The opening of the file, as written. The whole thing — 118 lines — stays where its author put it; the contents beside it link to each section on GitHub.

/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?

python ../../../skills/cto-advisor/scripts/tech_debt_analyzer.py

3. Team Scaling

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

python ../../../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

# 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]

Read the full file on GitHub · 118 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 118 lines · 53 tokens per session scan A c800c8619626

Subscribe to this mod's changes

cto-review is a skill published in the GitHub repository bestagentkits/agency-skills (12 stars, last pushed 2mo ago), licensed MIT. It adds 53 tokens to every session and 882 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

build-custom-mcp-server

Build a custom MCP (Model Context Protocol) server that exposes domain-specific tools to AI assistants. Covers server implementation in Node.js or R, tool definitions, transport configuration, and testing with Claude Code. Use when you need to expose custom functionality beyond what mcptools provides, when building…

pjt222/agent-almanac · 80 tokens

design-serialization-schema

Design serialization schemas using JSON Schema, Protocol Buffer definitions, or Apache Avro. Covers schema versioning, backwards compatibility, validation rules, and evolution strategies for long-lived data formats. Use when defining a new API contract or data interchange format, adding fields to an existing schema…

pjt222/agent-almanac · 82 tokens

configure-nginx

Configure Nginx as a web server and reverse proxy. Covers static file serving, reverse proxy to upstream services, SSL/TLS termination with Let's Encrypt, location blocks, load balancing, rate limiting, and security headers. Use when serving static files in production, reverse proxying to backend services (Node.js…

pjt222/agent-almanac · 95 tokens

configure-reverse-proxy

Configure reverse proxy patterns across multiple tools including Nginx, Traefik, and ShinyProxy. Covers WebSocket proxying, path-based and host-based routing, SSL termination, and Docker label auto-discovery. Use when routing multiple services behind a single entry point, proxying WebSocket connections (Shiny…

pjt222/agent-almanac · 98 tokens

debridge

Complete deBridge Protocol SDK for building cross-chain bridges, message passing, and token transfers on Solana. Use when building cross-chain applications, bridging assets between Solana and EVM chains, or implementing trustless external calls.

sendaifun/skills · 48 tokens

lifi

Integrate LI.FI for cross-chain swaps, bridging, payments, route discovery, and transfer status tracking across Solana, EVM, Bitcoin, and Sui. Use when building Solana applications or AI agents that need quotes, routes, executable transactions, supported chains/tokens/tools, or cross-chain transfer monitoring.

sendaifun/skills · 67 tokens