Agent skill

Cto Advisor

by alirezarezvani in alirezarezvani/claude-skills

Technical leadership guidance for engineering teams, architecture decisions, and technology strategy.

MITAuto-check passedDevelopment

Install Cto Advisor

skills CLI
$ npx skills add alirezarezvani/claude-skills --skill cto-advisor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install alirezarezvani/claude-skills cto-advisor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/c-level-advisor/skills/cto-advisor .claude/skills/cto-advisor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cto-advisor
GitHub stars
28k
Used in
1 other repo
Token cost
~3k tokens
SKILL.md length
1,225 words
Files
6 (incl. scripts, references)
Skills in repo
342
Repo updated
First seen
Licence
MIT

At a glance

Technical leadership guidance for engineering teams, architecture decisions, and technology strategy.

  • Works in 5 steps: Technology Strategy → Engineering Team Leadership → Architecture Governance → …
  • Assessing technical debt
  • SKILL.md covers Keywords, Quick Start, Core Responsibilities and Workflows, plus 10 more sections
  • Runs Python scripts from its folder; calls python

What it does

Cto Advisor is an agent skill from alirezarezvani/claude-skills. Technical leadership guidance for engineering teams, architecture decisions, and technology strategy. Use when assessing technical debt, scaling engineering teams, evaluating technologies, making architecture decisions, establishing engineering metrics, or when user mentions CTO, tech debt, technical debt, team scaling, architecture decisions, technology evaluation, engineering metrics, DORA metrics, or technology strategy.

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `references/architecture_decision_records.md`, `references/engineering_metrics.md` and `references/technology_evaluation_framework.md`).

It sits in Development, covering Technical debt and Architecture decision records. The repository describes itself as: 380 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 380+ skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8… The licence is MIT.

When your agent uses it

  • Assessing technical debt
  • Scaling engineering teams
  • Evaluating technologies
  • Making architecture decisions

Example prompts

  • “/cto-advisor”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Technology Strategy
  2. Engineering Team Leadership
  3. Architecture Governance
  4. Vendor & Platform Management
  5. Crisis Management

What it can do on your machine

Read from SKILL.md and the folder at commit 19392f7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cto Advisor loads about 3k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 110 tokens; SKILL.md has 1,225 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~110
When it runs · the whole SKILL.md, loaded when a task matches
~3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~11k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from alirezarezvani/claude-skills at commit 19392f7, republished under its MIT licence (© alirezarezvani). 1,225 words, ~2,976 tokens.

Download SKILL.mdSave it as .claude/skills/cto-advisor/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
cto-advisor
description
Technical leadership guidance for engineering teams, architecture decisions, and technology strategy. Use when assessing technical debt, scaling engineering teams, evaluating technologies, making architecture decisions, establishing engineering metrics, or when user mentions CTO, tech debt, technical debt, team scaling, architecture decisions, technology evaluation, engineering metrics, DORA metrics, or technology strategy.
license
MIT
metadata.version
2.0.0
metadata.author
Alireza Rezvani
metadata.category
c-level
metadata.domain
cto-leadership
metadata.updated
2026-03-05
metadata.python-tools
tech_debt_analyzer.py, team_scaling_calculator.py
metadata.frameworks
architecture-decisions, engineering-metrics, technology-evaluation

CTO Advisor

Technical leadership frameworks for architecture, engineering teams, technology strategy, and technical decision-making.

Keywords

CTO, chief technology officer, tech debt, technical debt, architecture, engineering metrics, DORA, team scaling, technology evaluation, build vs buy, cloud migration, platform engineering, AI/ML strategy, system design, incident response, engineering culture

Quick Start

bash
python scripts/tech_debt_analyzer.py      # Assess technical debt severity and remediation plan
python scripts/team_scaling_calculator.py  # Model engineering team growth and cost

Core Responsibilities

1. Technology Strategy

Align technology investments with business priorities.

Strategy components:

  • Technology vision (3-year: where the platform is going)
  • Architecture roadmap (what to build, refactor, or replace)
  • Innovation budget (10-20% of engineering capacity for experimentation)
  • Build vs buy decisions (default: buy unless it's your core IP)
  • Technical debt strategy (management, not elimination)

See references/technology_evaluation_framework.md for the full evaluation framework.

2. Engineering Team Leadership

Scale the engineering org's productivity — not individual output.

Scaling engineering:

  • Hire for the next stage, not the current one
  • Every 3x in team size requires a reorg
  • Manager:IC ratio: 5-8 direct reports optimal
  • Senior:junior ratio: at least 1:2 (invert and you'll drown in mentoring)

Culture:

  • Blameless post-mortems (incidents are system failures, not people failures)
  • Documentation as a first-class citizen
  • Code review as mentoring, not gatekeeping
  • On-call that's sustainable (not heroic)

See references/engineering_metrics.md for DORA metrics and the engineering health dashboard.

3. Architecture Governance

Create the framework for making good decisions — not making every decision yourself.

Architecture Decision Records (ADRs):

  • Every significant decision gets documented: context, options, decision, consequences
  • Decisions are discoverable (not buried in Slack)
  • Decisions can be superseded (not permanent)

See references/architecture_decision_records.md for ADR templates and the decision review process.

4. Vendor & Platform Management

Every vendor is a dependency. Every dependency is a risk.

Evaluation criteria: Does it solve a real problem? Can we migrate away? Is the vendor stable? What's the total cost (license + integration + maintenance)?

5. Crisis Management

Incident response, security breaches, major outages, data loss.

Your role in a crisis: Ensure the right people are on it, communication is flowing, and the business is informed. Post-crisis: blameless retrospective within 48 hours.

Workflows

Tech Debt Assessment Workflow

Step 1 — Run the analyzer

bash
python scripts/tech_debt_analyzer.py --output report.json

Step 2 — Interpret results The analyzer produces a severity-scored inventory. Review each item against:

  • Severity (P0–P3): how much is it blocking velocity or creating risk?
  • Cost-to-fix: engineering days estimated to remediate
  • Blast radius: how many systems / teams are affected?

Step 3 — Build a prioritized remediation plan Sort by: (Severity × Blast Radius) / Cost-to-fix — highest score = fix first. Group items into: (a) immediate sprint, (b) next quarter, (c) tracked backlog.

Step 4 — Validate before presenting to stakeholders

  • Every P0/P1 item has an owner and a target date
  • Cost-to-fix estimates reviewed with the relevant tech lead
  • Debt ratio calculated: maintenance work / total engineering capacity (target: < 25%)
  • Remediation plan fits within capacity (don't promise 40 points of debt reduction in a 2-week sprint)

Example output — Tech Debt Inventory:

Item                  | Severity | Cost-to-Fix | Blast Radius | Priority Score
----------------------|----------|-------------|--------------|---------------
Auth service (v1 API) | P1       | 8 days      | 6 services   | HIGH
Unindexed DB queries  | P2       | 3 days      | 2 services   | MEDIUM
Legacy deploy scripts | P3       | 5 days      | 1 service    | LOW

ADR Creation Workflow

Step 1 — Identify the decision Trigger an ADR when: the decision affects more than one team, is hard to reverse, or has cost/risk implications > 1 sprint of effort.

Step 2 — Draft the ADR Use the template from references/architecture_decision_records.md:

Title: [Short noun phrase]
Status: Proposed | Accepted | Superseded
Context: What is the problem? What constraints exist?
Options Considered:
  - Option A: [description] — TCO: $X | Risk: Low/Med/High
  - Option B: [description] — TCO: $X | Risk: Low/Med/High
Decision: [Chosen option and rationale]
Consequences: [What becomes easier? What becomes harder?]

Step 3 — Validation checkpoint (before finalizing)

  • All options include a 3-year TCO estimate
  • At least one "do nothing" or "buy" alternative is documented
  • Affected team leads have reviewed and signed off
  • Consequences section addresses reversibility and migration path
  • ADR is committed to the repository (not left in a doc or Slack thread)

Step 4 — Communicate and close Share the accepted ADR in the engineering all-hands or architecture sync. Link it from the relevant service's README.


Build vs Buy Analysis Workflow

Step 1 — Define requirements (functional + non-functional) Step 2 — Identify candidate vendors or internal build scope Step 3 — Score each option:

Criterion              | Weight | Build Score | Vendor A Score | Vendor B Score
-----------------------|--------|-------------|----------------|---------------
Solves core problem    | 30%    | 9           | 8              | 7
Migration risk         | 20%    | 2 (low risk)| 7              | 6
3-year TCO             | 25%    | $X          | $Y             | $Z
Vendor stability       | 15%    | N/A         | 8              | 5
Integration effort     | 10%    | 3           | 7              | 8

Step 4 — Default rule: Buy unless it is core IP or no vendor meets ≥ 70% of requirements. Step 5 — Document the decision as an ADR (see ADR workflow above).

Key Questions a CTO Asks

  • "What's our biggest technical risk right now — not the most annoying, the most dangerous?"
  • "If we 10x our traffic tomorrow, what breaks first?"
  • "How much of our engineering time goes to maintenance vs new features?"
  • "What would a new engineer say about our codebase after their first week?"
  • "Which technical decision from 2 years ago is hurting us most today?"
  • "Are we building this because it's the right solution, or because it's the interesting one?"
  • "What's our bus factor on critical systems?"
Show full SKILL.md (516 more words)Show less

CTO Metrics Dashboard

CategoryMetricTargetFrequency
VelocityDeployment frequencyDaily (or per-commit)Weekly
VelocityLead time for changes< 1 dayWeekly
QualityChange failure rate< 5%Weekly
QualityMean time to recovery (MTTR)< 1 hourWeekly
DebtTech debt ratio (maintenance/total)< 25%Monthly
DebtP0 bugs open0Daily
TeamEngineering satisfaction> 7/10Quarterly
TeamRegrettable attrition< 10%Monthly
ArchitectureSystem uptime> 99.9%Monthly
ArchitectureAPI response time (p95)< 200msWeekly
CostCloud spend / revenue ratioDeclining trendMonthly

Red Flags

  • Tech debt ratio > 30% and growing faster than it's being paid down
  • Deployment frequency declining over 4+ weeks
  • No ADRs for the last 3 major decisions
  • The CTO is the only person who can deploy to production
  • Build times exceed 10 minutes
  • Single points of failure on critical systems with no mitigation plan
  • The team dreads on-call rotation

Integration with C-Suite Roles

When...CTO works with...To...
Roadmap planningCPOAlign technical and product roadmaps
Hiring engineersCHRODefine roles, comp bands, hiring criteria
Budget planningCFOCloud costs, tooling, headcount budget
Security postureCISOArchitecture review, compliance requirements
Scaling operationsCOOInfrastructure capacity vs growth plans
Revenue commitmentsCROTechnical feasibility of enterprise deals
Technical marketingCMODeveloper relations, technical content
Strategic decisionsCEOTechnology as competitive advantage
Hard callsExecutive Mentor"Should we rewrite?" "Should we switch stacks?"

Proactive Triggers

Surface these without being asked when you detect them in company context:

  • Deployment frequency dropping → early signal of team health issues
  • Tech debt ratio > 30% → recommend a tech debt sprint
  • No ADRs filed in 30+ days → architecture decisions going undocumented
  • Single point of failure on critical system → flag bus factor risk
  • Cloud costs growing faster than revenue → cost optimization review
  • Security audit overdue (> 12 months) → escalate to CISO

Output Artifacts

RequestYou Produce
"Assess our tech debt"Tech debt inventory with severity, cost-to-fix, and prioritized plan
"Should we build or buy X?"Build vs buy analysis with 3-year TCO
"We need to scale the team"Hiring plan with roles, timing, ramp model, and budget
"Review this architecture"ADR with options evaluated, decision, consequences
"How's engineering doing?"Engineering health dashboard (DORA + debt + team)

Reasoning Technique: ReAct (Reason then Act)

Research the technical landscape first. Analyze options against constraints (time, team skill, cost, risk). Then recommend action. Always ground recommendations in evidence — benchmarks, case studies, or measured data from your own systems. "I think" is not enough — show the data.

Communication

All output passes the Internal Quality Loop before reaching the founder (see ../agent-protocol/SKILL.md).

  • Self-verify: source attribution, assumption audit, confidence scoring
  • Peer-verify: cross-functional claims validated by the owning role
  • Critic pre-screen: high-stakes decisions reviewed by Executive Mentor
  • Output format: Bottom Line → What (with confidence) → Why → How to Act → Your Decision
  • Results only. Every finding tagged: 🟢 verified, 🟡 medium, 🔴 assumed.

Context Integration

  • Always read company-context.md before responding (if it exists)
  • During board meetings: Use only your own analysis in Phase 2 (no cross-pollination)
  • Invocation: You can request input from other roles: [INVOKE:role|question]

Resources

  • references/technology_evaluation_framework.md — Build vs buy, vendor evaluation, technology radar
  • references/engineering_metrics.md — DORA metrics, engineering health dashboard, team productivity
  • references/architecture_decision_records.md — ADR templates, decision governance, review process

© alirezarezvani, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, references) in c-level-advisor/skills/cto-advisor of alirezarezvani/claude-skills.

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

Open the folder on GitHubat commit 19392f7

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in alirezarezvani/claude-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Cto Advisor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cto Advisor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cto Advisor this skillalirezarezvani/claude-skills28k1 repos~3kAutomated safety check: PassMIT
Cto AdvisorIbrahim-3d/orchestrator-supaconductor3814 repos~2.4kAutomated safety check: PassMIT
Architecture Decisionjwynia/agent-skills1691 repos~1.5kAutomated safety check: PassMIT
Modernization AssessmentEmeaAppGbb/spec2cloud100—~1.9kAutomated safety check: PassMIT
PR Design DocOpenHands/OpenHands90k—~2.4kAutomated safety check: PassMIT
Systematic Code Refactoringluongnv89/claude-howto42k—~3kAutomated safety check: PassMIT

Similar skills

  • Cto Advisor

    Ibrahim-3d/orchestrator-supaconductor

    Technical leadership guidance for engineering teams, architecture decisions, and technology strategy.

    381 GitHub starsUsed in 4 repos~2.4k tokens
    DevelopmentAuto-check passed
  • Architecture Decision

    jwynia/agent-skills

    Systematically evaluate architecture decisions, document trade-offs, and select appropriate patterns.

    169 GitHub starsUsed in 1 repo~1.5k tokens
    DevelopmentAuto-check passed
  • Modernization Assessment

    EmeaAppGbb/spec2cloud

    Assess codebase for modernization opportunities — tech debt, deprecated dependencies, outdated patterns, architectural improvements.

    100 GitHub stars~1.9k tokensUpdated 5 mo ago
    DevelopmentAuto-check passed
  • PR Design Doc

    OpenHands/OpenHands

    For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…

    90k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Systematic Code Refactoring

    luongnv89/claude-howto

    Guides refactoring in phases based on Martin Fowler's method: research, test coverage check, planning and small tested steps, with your approval at each phase.

    42k GitHub stars~3k tokensUpdated 9 days ago
    DevelopmentAuto-check passed
  • Finds and implements evidence-backed simplifications in the ego-lite repository, such as dead code, duplicated state and speculative abstractions, without hiding behavior changes.

    17k GitHub stars~1.2k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from alirezarezvani/claude-skills

All 342 skills in this repo
  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Auto-check passed
  • Product Strategist

    alirezarezvani/claude-skills

    OKR cascade toolkit for product leaders: generates aligned company-to-team OKRs from five strategy types and scores how well they line up.

    28k GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • App Store Optimization

    alirezarezvani/claude-skills

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.

    28k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AWS Solution Architect

    alirezarezvani/claude-skills

    Design AWS architectures for startups using serverless patterns and IaC templates.

    28k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Campaign Analytics

    alirezarezvani/claude-skills

    Calculates attribution, funnel and ROI figures for marketing campaigns with three Python scripts that need only the standard library.

    28k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • Code to PRD

    alirezarezvani/claude-skills

    Reverse-engineers a frontend, backend or fullstack codebase into a product requirements document with per-page docs, an enum dictionary and an API inventory.

    28k GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed

Categories

Questions about Cto Advisor

What does Cto Advisor do?

Technical leadership guidance for engineering teams, architecture decisions, and technology strategy. Cto Advisor is an agent skill from alirezarezvani/claude-skills. Technical leadership guidance for engineering teams, architecture decisions, and technology strategy.

When should I use Cto Advisor?

Cto Advisor fits situations like: assessing technical debt; scaling engineering teams; evaluating technologies; making architecture decisions.

How do I install Cto Advisor in Claude Code?

Run `npx skills add alirezarezvani/claude-skills --skill cto-advisor -a claude-code`. Or copy the skill folder (c-level-advisor/skills/cto-advisor in alirezarezvani/claude-skills) into .claude/skills/cto-advisor in your project. Claude Code loads it when a task matches its description.

How do I install Cto Advisor in Codex?

Run `npx skills add alirezarezvani/claude-skills --skill cto-advisor -a codex`. Or copy the skill folder (c-level-advisor/skills/cto-advisor in alirezarezvani/claude-skills) into .agents/skills/cto-advisor in your project. Codex loads it when a task matches its description.

Can I use Cto Advisor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add alirezarezvani/claude-skills --skill cto-advisor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cto-advisor, .gemini/skills/cto-advisor, .github/skills/cto-advisor and .opencode/skills/cto-advisor in your project.

What does Cto Advisor need to run?

Going by SKILL.md and its folder, Cto Advisor needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Cto Advisor access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Cto Advisor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Cto Advisor use?

Cto Advisor is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cto Advisor use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.7k tokens, read only when the agent opens those files.

What are the alternatives to Cto Advisor?

Skills that share tags, products or a category with Cto Advisor: Cto Advisor (Ibrahim-3d/orchestrator-supaconductor, 381 stars), Architecture Decision (jwynia/agent-skills, 169 stars), Modernization Assessment (EmeaAppGbb/spec2cloud, 100 stars) and PR Design Doc (OpenHands/OpenHands, 90k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cto Advisor?

alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-skills, which has 27,891 GitHub stars. The repository holds 342 skills in this directory. The repository was last updated on August 30, 2026.

Source: alirezarezvani/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.