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, well-crafted skill description that excels across all dimensions. It provides specific tools and capabilities, comprehensive trigger terms that match natural user language, explicit 'Use when...' guidance, and occupies a distinct niche around engineering leadership and CTO-level concerns. The description is thorough without being unnecessarily verbose.
| 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, ADR templates) and 'when' (explicit 'Use when...' clause with detailed trigger scenarios and keyword mentions). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'CTO', 'tech debt', 'technical debt', 'team scaling', 'architecture decisions', 'technology evaluation', 'engineering metrics', 'DORA metrics', 'technology strategy'. These are terms engineers and leaders would naturally use. | 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', 'tech debt analyzer', and 'team scaling calculator' 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 reads more like a generic CTO handbook than an actionable skill for Claude. The vast majority of content is high-level management advice that Claude already knows, violating token efficiency. While it references scripts and reference files that could provide concrete value, none are included in the bundle, and the inline content is overwhelmingly descriptive rather than instructive.
Suggestions
Remove generic management content Claude already knows (weekly cadence, quarterly planning, stakeholder management, book/tool lists, communication templates) to reduce the file by 60-70%.
Provide the referenced bundle files (scripts and reference docs) or inline their key content, since the skill's actionability depends entirely on files that don't exist.
Add concrete examples with inputs and expected outputs—e.g., show a sample tech debt assessment output and how to interpret/act on it, or a filled-out ADR example.
Add validation checkpoints to multi-step workflows like 'Digital Transformation' and 'Cloud Migration'—currently they are just vague numbered lists with no feedback loops.
| 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. Time-sensitive tool recommendations and community references waste tokens. | 1 / 3 |
Actionability | References scripts (tech_debt_analyzer.py, team_scaling_calculator.py) and reference files, which is good, but no bundle files are provided so these are unverifiable. The content itself is mostly high-level guidance ('Define 3-5 year technology vision', 'Create quarterly roadmaps') rather than concrete, executable steps. Some sections like incident response and DORA metrics targets provide specific numbers, but most content describes rather than instructs. | 2 / 3 |
Workflow Clarity | Several multi-step processes are listed (incident response, vendor evaluation, cloud migration) with numbered steps, but they lack validation checkpoints and feedback loops. For example, the 'Digital Transformation' workflow is just 5 vague steps with no verification between them. The tech debt assessment references a script but doesn't explain what to do with the output or how to validate results. | 2 / 3 |
Progressive Disclosure | References to external files (references/architecture_decision_records.md, references/technology_evaluation_framework.md, references/engineering_metrics.md) are well-signaled, but no bundle files are provided, making these references unverifiable. Meanwhile, enormous amounts of content that could be in reference files (communication templates, weekly cadence, quarterly planning, tools & resources, book lists) are inlined in the main SKILL.md, bloating it significantly. | 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 | |
2c97748
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.