cto-advisor

davila7/claude-code-templates · Agent Skill

Provides guidance on technical leadership, architectural decisions, and technology strategy for engineering teams.

Jump to install ↓

Overview

Publisherdavila7Community
Repositorydavila7/claude-code-templates ↗
Skill foldercto-advisor
Stars30,563
Bundled files1
LicenseMIT
Last updatedDecember 19, 2025
LinksSkill source ↗ · Repository ↗

Mozgi check

What we found in the skill files. Details come with a subscription.

Security
low risk · no obvious risks found — the full report shows the details
Compatibility
needs extra software
Similar skills
51 similar skills found
Also with subscription

Installation

A skill is a folder with a SKILL.md file. Pick your agent and run the commands in a terminal (macOS, Linux or Git Bash on Windows) from your project root.

Copy the prompt into Claude, Codex or another assistant: it will review the skill and install it for you.

Install the “cto-advisor” skill from mozgi.io (https://mozgi.io/skills/cto-advisor/) for me.

1. Download the archive: https://mozgi.io/skills/cto-advisor/download
   If it fails, take the skill folder from the source: https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/business-marketing/cto-advisor
2. Read SKILL.md and the other files. Check the skill is safe: no hidden commands, no sending data elsewhere, no scripts doing something other than described. If anything looks suspicious, stop and tell me.
3. Put the “cto-advisor” folder into your agent's skills folder: .claude/skills/ for Claude Code, .agents/skills/ for Codex, .cursor/skills/ for Cursor, .gemini/skills/ for Gemini CLI. Inside the project if we are in one, otherwise in the home folder (~/.claude/skills/ etc.).
4. Make sure <skills folder>/cto-advisor/SKILL.md exists.
5. Briefly tell me what this skill does and offer to try it on my task.

If you cannot do a step yourself, tell me what to click or type.

Review the source files

1 file Download Zip

Read SKILL.md and any companion files before deciding whether to install. Click a file to preview it.

SKILL.md contents

Original author text · read-only

CTO Advisor

Strategic frameworks and tools for technology leadership, team scaling, and engineering excellence.

Keywords

CTO, chief technology officer, technical leadership, tech debt, technical debt, engineering team, team scaling, architecture decisions, technology evaluation, engineering metrics, DORA metrics, ADR, architecture decision records, technology strategy, engineering leadership, engineering organization, team structure, hiring plan, technical strategy, vendor evaluation, technology selection

Quick Start

For Technical Debt Assessment

python scripts/tech_debt_analyzer.py

Analyzes system architecture and provides prioritized debt reduction plan.

For Team Scaling Planning

python scripts/team_scaling_calculator.py

Calculates optimal hiring plan and team structure for growth.

For Architecture Decisions

Review references/architecture_decision_records.md for ADR templates and examples.

For Technology Evaluation

Use framework in references/technology_evaluation_framework.md for vendor selection.

For Engineering Metrics

Implement KPIs from references/engineering_metrics.md for team performance tracking.

Core Responsibilities

1. Technology Strategy

Vision & Roadmap
  • Define 3-5 year technology vision
  • Create quarterly roadmaps
  • Align with business strategy
  • Communicate to stakeholders
Innovation Management
  • Allocate 20% time for innovation
  • Run hackathons quarterly
  • Evaluate emerging technologies
  • Build proof of concepts
Technical Debt Strategy
# Assess current debt
python scripts/tech_debt_analyzer.py

# Allocate capacity
- Critical debt: 40% capacity
- High debt: 25% capacity  
- Medium debt: 15% capacity
- Low debt: Ongoing maintenance

2. Team Leadership

Scaling Engineering
# Calculate scaling needs
python scripts/team_scaling_calculator.py

# Key ratios to maintain:
- Manager:Engineer = 1:8
- Senior:Mid:Junior = 3:4:2
- Product:Engineering = 1:10
- QA:Engineering = 1.5:10
Performance Management
  • Set clear OKRs quarterly
  • Conduct 1:1s weekly
  • Review performance quarterly
  • Provide growth opportunities
Culture Building
  • Define engineering values
  • Establish coding standards
  • Create learning programs
  • Foster collaboration

3. Architecture Governance

Decision Making

Use ADR template from references/architecture_decision_records.md:

1. Document context and problem

2. List all options considered

3. Record decision and rationale

4. Track consequences

Technology Standards
  • Language choices
  • Framework selection
  • Database standards
  • Security requirements
  • API design guidelines
System Design Review
  • Weekly architecture reviews
  • Design documentation standards
  • Prototype requirements
  • Performance criteria

4. Vendor Management

Evaluation Process

Follow framework in references/technology_evaluation_framework.md:

1. Gather requirements (Week 1)

2. Market research (Week 1-2)

3. Deep evaluation (Week 2-4)

4. Decision and documentation (Week 4)

Vendor Relationships
  • Quarterly business reviews
  • SLA monitoring
  • Cost optimization
  • Strategic partnerships

5. Engineering Excellence

Metrics Implementation

From references/engineering_metrics.md:

DORA Metrics (Deploy to production targets):

  • Deployment Frequency: >1/day
  • Lead Time: <1 day
  • MTTR: <1 hour
  • Change Failure Rate: <15%

Quality Metrics:

  • Test Coverage: >80%
  • Code Review: 100%
  • Technical Debt: <10%

Team Health:

  • Sprint Velocity: ±10% variance
  • Unplanned Work: <20%
  • On-call Incidents: <5/week

Weekly Cadence

Monday

  • Leadership team sync
  • Review metrics dashboard
  • Address escalations

Tuesday

  • Architecture review
  • Technical interviews
  • 1:1s with directs

Wednesday

  • Cross-functional meetings
  • Vendor meetings
  • Strategy work

Thursday

  • Team all-hands (monthly)
  • Sprint reviews (bi-weekly)
  • Technical deep dives

Friday

  • Strategic planning
  • Innovation time
  • Week recap and planning

Quarterly Planning

Q1 Focus: Foundation

  • Annual planning
  • Budget allocation
  • Team goal setting
  • Technology assessment

Q2 Focus: Execution

  • Major initiatives launch
  • Mid-year hiring push
  • Performance reviews
  • Architecture evolution

Q3 Focus: Innovation

  • Hackathon
  • Technology exploration
  • Team development
  • Process optimization

Q4 Focus: Planning

  • Next year strategy
  • Budget planning
  • Promotion cycles
  • Debt reduction sprint

Crisis Management

Incident Response

1. Immediate (0-15 min):

  • Assess severity
  • Activate incident team
  • Begin communication

2. Short-term (15-60 min):

  • Implement fixes
  • Update stakeholders
  • Monitor systems

3. Resolution (1-24 hours):

  • Verify fix
  • Document timeline
  • Customer communication

4. Post-mortem (48-72 hours):

  • Root cause analysis
  • Action items
  • Process improvements

Types of Crises

Security Breach
  • Isolate affected systems
  • Engage security team
  • Legal/compliance notification
  • Customer communication plan
Major Outage
  • All-hands response
  • Status page updates
  • Executive briefings
  • Customer outreach
Data Loss
  • Stop writes immediately
  • Assess recovery options
  • Begin restoration
  • Impact analysis

Stakeholder Management

Board/Executive Reporting

Monthly:

  • KPI dashboard
  • Risk register
  • Major initiatives status

Quarterly:

  • Technology strategy update
  • Team growth and health
  • Innovation highlights
  • Budget review

Cross-functional Partners

Product Team
  • Weekly roadmap sync
  • Sprint planning participation
  • Technical feasibility reviews
  • Feature estimation
Sales/Marketing
  • Technical sales support
  • Product capability briefings
  • Customer reference calls
  • Competitive analysis
Finance
  • Budget management
  • Cost optimization
  • Vendor negotiations
  • Capex planning

Strategic Initiatives

Digital Transformation

1. Assess current state

2. Define target architecture

3. Create migration plan

4. Execute in phases

5. Measure and adjust

Cloud Migration

1. Application assessment

2. Migration strategy (7Rs)

3. Pilot applications

4. Full migration

5. Optimization

Platform Engineering

1. Define platform vision

2. Build core services

3. Create self-service tools

4. Enable team adoption

5. Measure efficiency

AI/ML Integration

1. Identify use cases

2. Build data infrastructure

3. Develop models

4. Deploy and monitor

5. Scale adoption

Communication Templates

Technology Strategy Presentation

1. Executive Summary (1 slide)
2. Current State Assessment (2 slides)
3. Vision & Strategy (2 slides)
4. Roadmap & Milestones (3 slides)
5. Investment Required (1 slide)
6. Risks & Mitigation (1 slide)
7. Success Metrics (1 slide)

Team All-hands

1. Wins & Recognition (5 min)
2. Metrics Review (5 min)
3. Strategic Updates (10 min)
4. Demo/Deep Dive (15 min)
5. Q&A (10 min)

Board Update Email

Subject: Engineering Update - [Month]

Highlights:
• [Major achievement]
• [Key metric improvement]
• [Strategic progress]

Challenges:
• [Issue and mitigation]

Next Month:
• [Priority 1]
• [Priority 2]

Detailed metrics attached.

Tools & Resources

Essential Tools

  • Architecture: Draw.io, Lucidchart, C4 Model
  • Metrics: DataDog, Grafana, LinearB
  • Planning: Jira, Confluence, Notion
  • Communication: Slack, Zoom, Loom
  • Development: GitHub, GitLab, Bitbucket

Key Resources

  • Books:
  • "The Manager's Path" - Camille Fournier
  • "Accelerate" - Nicole Forsgren
  • "Team Topologies" - Skelton & Pais
  • Frameworks:
  • DORA metrics
  • SPACE framework
  • Team Topologies
  • Communities:
  • CTO Craft
  • Engineering Leadership Slack
  • LeadDev community

Success Indicators

✅ Technical Excellence

  • System uptime >99.9%
  • Deploy multiple times daily
  • Technical debt <10% capacity
  • Security incidents = 0

✅ Team Success

  • Team satisfaction >8/10
  • Attrition <10%
  • Filled positions >90%
  • Diversity improving

✅ Business Impact

  • Features on-time >80%
  • Engineering enables revenue
  • Cost per transaction decreasing
  • Innovation driving growth

Red Flags to Watch

⚠️ Increasing technical debt

⚠️ Rising attrition rate

⚠️ Slowing velocity

⚠️ Growing incidents

⚠️ Team morale declining

⚠️ Budget overruns

⚠️ Vendor dependencies

⚠️ Security vulnerabilities

Frequently asked questions

What does the cto-advisor skill do?

Provides guidance on technical leadership, architectural decisions, and technology strategy for engineering teams.

How do I install cto-advisor?

Open the “Installation” block on this page and pick your agent — Claude Code, Codex, Cursor or Gemini CLI — for ready-made commands that copy the skill folder to the right place. Or copy the prompt from the “Via assistant” tab and let the assistant review and install the skill.

Which AI models work with cto-advisor?

Skills are plain Markdown instructions (the Agent Skills format), so cto-advisor works with any agent that reads SKILL.md: Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and more. The model loads the instructions only when a task matches the skill's description.

Is cto-advisor free?

The skill is published openly by davila7 under the MIT license. The skill itself costs nothing — you only pay your AI provider for the tokens you use.

Is it safe to install skills?

A skill is a set of instructions your agent will follow, so read SKILL.md and its companion files before installing. Scripts in the skill folder only run if your agent runs them — keep an eye on what it does and do not grant unnecessary permissions.

How is a skill different from an MCP server or a plugin?

An MCP server or plugin gives the model new tools — code that runs and returns a result. A skill gives it knowledge and process: how to approach a task, which steps to follow and what good output looks like. It needs no server or API key.

Related skills

All skills →