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
npx skills add borghei/Claude-Skills --skill cto-advisor -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/cto-advisor/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cto-advisor/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill cto-advisor -a codex2Manually: put the files in place
.agents/skills/cto-advisor/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill cto-advisor -a cursor2Manually: put the files in place
.cursor/skills/cto-advisor/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install borghei/Claude-Skills c-level-advisor/cto-advisor/SKILL.md2Manually: put the files in place
.github/skills/cto-advisor/SKILL.md1Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill cto-advisor -a gemini-cli2Platform CLI
gemini skills install https://github.com/borghei/Claude-Skills --path c-level-advisor/cto-advisorManually: put the files in place
.devin/skills/cto-advisor/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill cto-advisor -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.