CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cto-advisor

Technical leadership guidance for engineering teams, architecture decisions, and technology strategy. 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.

64

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is cto-advisor in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

63%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is well-organized, dense with actionable CTO-specific heuristics, and its workflows include validation checklists — but it is undermined by referencing five bundle files (two scripts, three references) that do not exist, making the Quick Start commands unrunnable and all deep navigation broken. Weakest on actionability and progressive disclosure for this reason.

Suggestions

Create the referenced bundle files — scripts/tech_debt_analyzer.py, scripts/team_scaling_calculator.py, and the three references/*.md files — or remove the references; every Quick Start command and 'See references/...' pointer currently targets a nonexistent file.

Add error-recovery/feedback guidance to the workflows (e.g., what to do when an ADR validation checkpoint fails or when no Build vs Buy option meets the 70% threshold), and add a validation step to the Build vs Buy workflow.

Trim the 'Keywords' section (it duplicates the frontmatter description's triggers) and the generic 'Reasoning Technique: ReAct' section, which explains a reasoning pattern Claude already knows.

DimensionReasoningScore

Conciseness

The body is dense with domain-specific heuristics Claude doesn't know ("Every 3x in team size requires a reorg", "Manager:IC ratio: 5-8", "innovation budget 10-20%") organized as tables and checklists, but the "Keywords" section duplicates the description's triggers and the "Reasoning Technique: ReAct" section explains a generic reasoning pattern Claude already knows. Minor over-explanation that could be trimmed — anchor 4, not 5.

4 / 5

Actionability

The Quick Start and workflow commands ("python scripts/tech_debt_analyzer.py --output report.json", "python scripts/team_scaling_calculator.py") reference scripts that do not exist in the bundle, so the centerpiece commands are not executable. The rest is genuinely concrete (prioritization formula "(Severity × Blast Radius) / Cost-to-fix", a full ADR template, a scored decision matrix), but the broken primary commands are a major gap, matching anchor 3 (incomplete guidance, missing key details) rather than 4 (minor gaps).

3 / 5

Workflow Clarity

All three workflows have clear step sequences, and two have explicit validation checklists ("Step 4 — Validate before presenting to stakeholders" with a 4-item checklist; ADR "Step 3 — Validation checkpoint" with a 5-item checklist). However, the Build vs Buy workflow has no validation step and no workflow specifies error-recovery feedback (what to do when a checklist item fails), matching anchor 4 (most checkpoints present, minor gaps) rather than 5 (feedback loops plus checklists).

4 / 5

Progressive Disclosure

The design intent is good — a clear overview with well-signaled, one-level-deep references ("See references/architecture_decision_records.md for ADR templates and the decision review process") and a Resources section — but no references/, scripts/, or assets/ directories exist, so all five referenced files are dangling and the navigation is non-functional. Structure and signaling are better than anchor 3's example, but scoring against the actual (empty) bundle structure keeps it below 4.

3 / 5

Total

14

/

20

Passed

Description

91%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person, concrete, with an explicit and trigger-rich 'Use when' clause covering synonyms (tech debt / technical debt) and natural terms like CTO and DORA metrics. Minor room to sharpen the opening 'what' clause from domain naming to concrete actions.

DimensionReasoningScore

Specificity

The description lists several concrete actions ("assessing technical debt, scaling engineering teams, evaluating technologies, making architecture decisions, establishing engineering metrics"), but the opening clause "Technical leadership guidance for..." is domain-level rather than action-level, and body areas like vendor management and crisis management are not covered. This matches anchor 4 (several specific actions, minor gaps) rather than 5 (comprehensive coverage).

4 / 5

Completeness

It explicitly answers both questions: the what ("Technical leadership guidance for engineering teams, architecture decisions, and technology strategy") and an explicit, trigger-rich when ("Use when assessing technical debt... or when user mentions CTO, tech debt..."). Matches the anchor 5 example structure almost exactly; the when-clause is maximally explicit, ruling out 4.

5 / 5

Trigger Term Quality

Trigger terms are comprehensive and natural, including a synonym pair ("tech debt, technical debt") plus "CTO", "team scaling", "architecture decisions", "engineering metrics", "DORA metrics, or technology strategy" — a user needing this skill would plausibly say these. Matches anchor 5 (comprehensive natural terms including synonyms).

5 / 5

Distinctiveness Conflict Risk

The CTO framing and "Technical leadership" anchor a clear niche with minimal wrong-skill risk, but terms like "architecture decisions", "engineering metrics", and "team scaling" are shared vocabulary that could overlap with dedicated architecture, metrics, or people-ops skills. Mostly distinct with minor overlap risk — anchor 4, not 5.

4 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 10 missing

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/cto-advisor/SKILL.md

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.