CtrlK
BlogDocsLog inGet started
Tessl Logo

cto-advisor

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

1.73x
Quality

67%

Does it follow best practices?

Impact

99%

1.73x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/c-level/cto-advisor/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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').

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

Total

10

/

11

Passed

Repository
majiayu000/claude-skill-registry
Reviewed

Table of Contents

Is this your skill?

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.