Technical leadership guidance for engineering teams, architecture decisions, and technology strategy. Includes tech debt analyzer, team scaling calculator, engineering metrics frameworks, technology evaluation tools, and ADR templates. 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.
78
67%
Does it follow best practices?
Impact
99%
1.73xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/c-level/cto-advisor/SKILL.mdQuality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that clearly defines its domain (CTO/technical leadership), lists specific tools and capabilities, and provides comprehensive trigger terms in an explicit 'Use when...' clause. It uses proper third-person voice throughout and covers both common and specialized terminology that users would naturally employ.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and tools: tech debt analyzer, team scaling calculator, engineering metrics frameworks, technology evaluation tools, and ADR templates. Also specifies concrete use cases like assessing technical debt, scaling engineering teams, and making architecture decisions. | 3 / 3 |
Completeness | Clearly answers both 'what' (technical leadership guidance, specific tools like tech debt analyzer, team scaling calculator, etc.) and 'when' with an explicit 'Use when...' clause listing specific trigger scenarios and terms. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: CTO, tech debt, technical debt, team scaling, architecture decisions, technology evaluation, engineering metrics, DORA metrics, technology strategy. Includes both abbreviations and full forms (e.g., 'tech debt' and 'technical debt'). | 3 / 3 |
Distinctiveness Conflict Risk | Occupies a clear niche around CTO-level technical leadership and engineering management. The specific triggers like 'DORA metrics', 'ADR templates', 'team scaling calculator', and 'tech debt analyzer' are highly distinctive and unlikely to conflict with general coding or project management skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is far too verbose and reads more like a CTO handbook or job description than an actionable skill for Claude. The majority of content (weekly cadences, quarterly planning, stakeholder management, book recommendations, tool lists) is generic management knowledge that Claude already possesses and wastes significant token budget. The strongest elements are the references to concrete scripts and external framework files, but these are buried in hundreds of lines of unnecessary context.
Suggestions
Cut the file by 70%+: Remove Weekly Cadence, Quarterly Planning, Stakeholder Management, Tools & Resources, Books, Communities, Communication Templates, and Strategic Initiatives sections—these are generic CTO knowledge Claude already has.
Focus the skill on what's unique: the scripts (tech_debt_analyzer.py, team_scaling_calculator.py), the reference files (ADR templates, evaluation framework, metrics), and how to use them together for specific user requests.
Add concrete examples of script input/output so Claude knows what to expect when running them and how to interpret results for the user.
Add validation steps after script execution (e.g., 'Review the output for X, verify Y before presenting recommendations to user').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at ~350+ lines. Much of the content is generic management advice Claude already knows (weekly cadence templates, quarterly planning cycles, stakeholder management, book recommendations, tool lists). The 'Weekly Cadence' and 'Quarterly Planning' sections are particularly egregious—they describe standard CTO responsibilities that add no novel instruction. Token budget is severely wasted. | 1 / 3 |
Actionability | References concrete scripts (tech_debt_analyzer.py, team_scaling_calculator.py) and specific reference files, which is good. However, most content is high-level guidance rather than executable instructions—bullet points like 'Define 3-5 year technology vision' and 'Foster collaboration' are vague directives, not actionable steps Claude can execute. The scripts themselves aren't shown, so actionability depends on those external files. | 2 / 3 |
Workflow Clarity | Some workflows are sequenced (incident response has clear time-boxed steps, vendor evaluation has a 4-week timeline, ADR process has 4 steps). However, most multi-step processes lack validation checkpoints or feedback loops. The tech debt and team scaling workflows just say 'run script' without explaining what to do with output or how to validate results. Crisis management steps are reasonable but generic. | 2 / 3 |
Progressive Disclosure | References external files appropriately (references/architecture_decision_records.md, references/technology_evaluation_framework.md, references/engineering_metrics.md, scripts/). However, the SKILL.md itself is a monolithic wall of text that inlines enormous amounts of content that should either be in reference files or omitted entirely. The communication templates, weekly cadence, quarterly planning, tools & resources, and book lists should not be in the main skill file. | 2 / 3 |
Total | 7 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_field | 'metadata' should map string keys to string values | Warning |
Total | 10 / 11 Passed | |
d156cd1
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.