cto-advisor

Analyze technical debt, plan engineering team scaling, and document architecture decisions.

2|1|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/bhaktofmahakal/ai-counsellor-hf --skill cto-advisor-bhaktofmahakal
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cto-advisor
Source: https://github.com/bhaktofmahakal/ai-counsellor-hf/tree/main/.claude/skills/cto-advisor
Command: npx skills add https://github.com/bhaktofmahakal/ai-counsellor-hf --skill cto-advisor-bhaktofmahakal

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Engineering leaders often lack structured frameworks for assessing technical debt, planning team growth, and documenting architecture decisions, leading to ad-hoc choices and unmeasured engineering health. ## Core Features & Use Cases - Technical Debt Analysis: Run the tech_debt_analyzer.py script to score debt across architecture, code quality, infrastructure, security, and performance, then get prioritized remediation actions and effort estimates. - Team Scaling Planning: Use team_scaling_calculator.py to generate hiring plans, role distributions, budget projections, and organizational structures based on current headcount and growth targets. - Architecture & Metrics Frameworks: Apply ADR templates, DORA metrics targets, and a technology evaluation framework from the references directory for governance and vendor selection. - Use Case: A CTO inheriting a legacy platform can score its debt level, estimate the sprints needed for remediation, and produce a quarterly hiring plan to support the migration. ## Quick Start Ask the assistant to analyze technical debt for your system or calculate a team scaling plan from your current headcount and target size.

Frequently Asked Questions about cto-advisor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I assess technical debt in a legacy system?▼

Run the tech_debt_analyzer.py script with scores for architecture, code quality, infrastructure, security, and performance indicators. It returns an overall debt score, risk assessment, prioritized actions, and sprint-based effort estimates.

How to plan engineering team scaling and hiring?▼

Use team_scaling_calculator.py with your current headcount, role distribution, and target size. It generates a quarterly hiring timeline, role priorities, budget projection, and recommended organizational structure based on team size stage.

What are DORA metrics and what targets should engineering teams hit?▼

DORA metrics measure deployment frequency, lead time for changes, MTTR, and change failure rate. Elite targets are multiple daily deploys, under one hour lead time, under one hour MTTR, and under 15% change failure rate.

When should I write an Architecture Decision Record?▼

Write an ADR when a decision has significant impact, multiple options were considered, or the choice is hard to reverse. The references include a template covering context, decision drivers, options, and consequences.

Does the team scaling calculator account for rapid growth risks?▼

Yes, it applies Brooks' Law diminishing returns, caps quarterly onboarding at 25% of current headcount, and flags risks like culture dilution and high attrition when growth exceeds 100%.