Skip to main content
skill CX Codex

cto-advisor · borghei — Claude Code skill: what it does, how to install

cto-advisor — a skill for technology strategy, team scaling and architecture decisions. Helps plan engineering growth, prioritise technical debt and evaluate vendors.

LicenseRef-MIT-Commons-Clause 177 installs ★ 1,183 updated 2026-10-23

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add borghei/Claude-Skills --skill cto-advisor -a claude-code
Open on GitHub

What cto-advisor does

The skill provides Python scripts for debt analysis (tech_debt_analyzer.py) and team scaling (team_scaling_calculator.py), Architecture Decision Record templates and a vendor evaluation framework. The scaling calculator needs current headcount, target size and timeline to work — without those numbers, ratios such as one manager per eight engineers mean nothing. DORA metrics (deployment frequency, lead time, change failure rate) assume production systems; hardware or embedded teams may need different benchmarks.

The skill recommends allocating 40% of sprint capacity to critical debt, 25% to high-priority issues. For hiring it suggests a 3:4:2 senior-to-mid-to-junior ratio and caps quarterly growth at 25%. Scripts live in scripts/, ADR and metrics references in references/. If ~/.claude/company-context.md exists (written by cs-onboard), cto-advisor reads it first.

What it helps with

  • assess technical debt and build a prioritised remediation plan
  • calculate hiring needs and team structure for scaling up
  • document an architecture decision through an ADR template
  • evaluate vendors or technologies using a weighted scoring framework
  • track DORA metrics for deployment speed and failure rates

Example prompts for the agent

  • Run the debt analyser and show me a prioritised cleanup plan
  • Calculate a hiring plan: we have 12 engineers now, need 25 in six months
  • Create an ADR for choosing between PostgreSQL and MongoDB for the events service

How to install cto-advisor

1Skills CLI (Vercel)

npx skills add borghei/Claude-Skills --skill cto-advisor -a claude-code

2Manually: put the files in place

~/.claude/skills/cto-advisor/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cto-advisor/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about cto-advisor

How to install cto-advisor in Claude Code?

Run npx skills add borghei/Claude-Skills --skill cto-advisor -a claude-code. The skill will appear in ~/.claude/skills/cto-advisor/SKILL.md.

What does cto-advisor do?

It supports technical leadership: analyses debt, calculates hiring plans, provides ADR templates and a vendor evaluation framework. Includes two Python scripts, DORA metrics reference and technology assessment guides.

What do the planning scripts require?

team_scaling_calculator.py needs current team size, target headcount and timeline; tech_debt_analyzer.py requires a system criticality rating to assign debt priorities. Without these inputs the skill will ask before running calculations.

Similar skills

All skills for Agent setup: memory, context, orchestration →

cto-advisor by other authors comes first.

cto-advisor Alireza Rezvani cto-advisor guides technical debt reviews, architecture decisions and engineering team planning in Claude Code. CX Codex +1 892installs cs-cto-advisor alirezarezvani cs-cto-advisor is a Claude Code subagent for technical debt analysis, engineering team growth planning, and technology evaluation. It supports CTO-level decisions and technical strategy. CX Codex ★ 30,251repo stars cto-review Alireza Rezvani cto-review — a slash command that asks six hard questions about your architecture before you approve it. Useful before a big change, a hiring push, or a build-vs-buy call. CX Codex +1 399installs cto-toolkit camilooscargbaptista The cto-toolkit Claude Code plugin adds engineering review skills, codebase-scanning subagents, and automated hooks. Use it to inspect a project or prepare reports on architecture, security, and release readiness. ★ 8repo stars CAST Imaging Structural Quality Advisor Agent official github The CAST Imaging Structural Quality Advisor Agent subagent finds structural quality issues in CAST Imaging, traces affected objects, and shapes remediation advice around testing needs. CX Codex +1 ★ 41,430repo stars architecture-decision jwynia architecture-decision evaluates architectural trade-offs, guides pattern selection, and structures decisions as ADRs. Useful when choosing tech stacks or tackling debt. CX Codex +1 505installs code-architecture-review omer-metin code-architecture-review evaluates codebase structure for module dependencies and coupling. Catches architectural problems before they turn into debt. CX Codex +1 270installs

From the same set120

The whole set →
senior-ml-engineer The senior-ml-engineer Claude Code skill supports production work on ML models and LLM features. Use it to plan a deployment, design a RAG pipeline, or check for model drift. CX Codex +1 187installs database-schema-designer database-schema-designer — a Claude Code skill that turns product requirements into a normalized relational schema with tables, ORM models, RLS, indexes and migrations. Works across six platforms, including Codex, Cursor and Gemini CLI. CX Codex +1 183installs ml-ops-engineer ml-ops-engineer is a skill for MLOps automation: deploying models, orchestrating training pipelines, monitoring feature drift, and configuring feature stores. It addresses gaps in ML deployment workflows. CX Codex +1 180installs ma-playbook ma-playbook is a Claude Code skill that structures M&A target assessment, due diligence, and deal structuring. CX Codex +1 179installs database-designer The database-designer skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode reviews SQL schemas, suggests indexes, and creates migrations. Use it for DDL reviews, index tuning, or schema diffs. CX Codex +1 176installs api-design-reviewer api-design-reviewer — a skill for Claude Code inspects OpenAPI specs, catches breaking schema changes between versions, and grades REST API architecture maturity. CX Codex +1 167installs information-security-manager-iso27001 information-security-manager-iso27001 is a Claude Code skill for designing and auditing an ISO 27001:2022 ISMS, covering risk assessment, Annex A controls, and certification readiness. CX Codex +1 166installs agent-designer agent-designer — a skill for Claude Code and related platforms that plans multi-agent architectures. It generates tool definitions for Anthropic and OpenAI, diagrams communication flows, and parses runtime logs. CX Codex +1 161installs

Project sponsors

Companies that keep this analytics open