# cto-advisor

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

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 177 installs · ★ 1183 repo stars
- Author: borghei
- License: LicenseRef-MIT-Commons-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/borghei/Claude-Skills/tree/HEAD/c-level-advisor/cto-advisor/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/borghei-cto-advisor

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill cto-advisor -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/cto-advisor/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/cto-advisor/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill cto-advisor -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/cto-advisor/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill cto-advisor -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/cto-advisor/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install borghei/Claude-Skills c-level-advisor/cto-advisor/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/cto-advisor/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill cto-advisor -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/borghei/Claude-Skills --path c-level-advisor/cto-advisor
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/cto-advisor/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill cto-advisor -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/borghei/Claude-Skills/tree/HEAD/c-level-advisor/cto-advisor/SKILL.md

## When to use it
- 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
- 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

## Similar
- [cs-cto-advisor](https://affpapa.org/en/nevibecode/agents/cs-cto-advisor.md) — subagent · ★ 30251 repo stars
- [cto-review](https://affpapa.org/en/nevibecode/skills/cto-review.md) — skill · 399 installs
- [cto-toolkit](https://affpapa.org/en/nevibecode/plugins/cto-toolkit.md) — plugin · ★ 8 repo stars
- [CAST Imaging Structural Quality Advisor Agent](https://affpapa.org/en/nevibecode/agents/cast-imaging-structural-quality-advisor-agent.md) — subagent · ★ 41430 repo stars
- [architecture-decision](https://affpapa.org/en/nevibecode/skills/architecture-decision.md) — skill · 505 installs
- [code-architecture-review](https://affpapa.org/en/nevibecode/skills/code-architecture-review.md) — skill · 270 installs

## Other versions with the same name
- [cto-advisor · alirezarezvani](https://affpapa.org/en/nevibecode/skills/cto-advisor.md) — 892 installs

From the same set: [borghei/claude-skills](https://affpapa.org/en/nevibecode/by/borghei/claude-skills.md) — 120 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
