Skip to content
Get packs

CTO Advisor

Gives agents CTO-level frameworks for tech debt, team scaling, architecture decisions and tech strategy

Source Download skill
Repository
alirezarezvani/claude-skills
Stars
29,149
Licence
MIT
Files
6 files

What it does

This skill gives an AI agent a set of technical leadership frameworks, so it can reason like a CTO advisor when you ask about technical debt, scaling an engineering team, choosing between build and buy, or writing architecture decision records. It includes step-by-step workflows, checklists, and reference guides on DORA metrics and technology evaluation. It also bundles two Python helper scripts that score technical debt and model team growth, though the scripts' output depends on the inputs you supply and their scoring is heuristic rather than empirically validated.

Great for

  • Engineering managers or tech leads preparing a tech debt review or remediation plan
  • Founders or early CTOs deciding how to structure and grow an engineering team
  • Teams writing architecture decision records and comparing build vs buy options

Skip it if

  • Authoritative financial, legal or hiring decisions: the TCO figures and team ratios are generic templates and need your own data and judgement
  • Automated scoring of a real codebase: the debt analyzer scores indicator lists you provide rather than scanning your code, so its output reflects your inputs

Try asking

  • “Help me prioritize our tech debt backlog using severity, blast radius and cost-to-fix”
  • “Draft an architecture decision record comparing building our own auth service versus buying one”
  • “How should we scale from 15 to 40 engineers over the next year?”
  • “Explain DORA metrics and which ones we should track first”
Step-by-step guide: how to use CTO AdvisorInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 6 original files, the MIT licence and an attribution note.

    cto-advisor.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip cto-advisor.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip cto-advisor.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Give the agent real figures (team size, incident counts, cost estimates) so the scripts and templates produce useful output rather than generic numbers
  • Review the script source before running it and treat its scores as a starting point for discussion, not a verdict
  • Ask for the ADR template when a decision affects multiple teams, and have the affected leads validate the TCO estimates

What's inside

  • references/architecture_decision_records.md
  • references/engineering_metrics.md
  • references/technology_evaluation_framework.md
  • scripts/team_scaling_calculator.py
  • scripts/tech_debt_analyzer.py
  • SKILL.md

Redistributed unmodified from alirezarezvani/claude-skills under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.