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.

73

Quality

92%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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.

A high-quality instructional body: concrete commands, formulas, templates, and thresholds make it directly actionable, and the three workflows carry explicit validation checklists. Detail is appropriately offloaded to three real reference files and two scripts, with the only notable inefficiency being the redundant Keywords section that duplicates the frontmatter triggers.

DimensionReasoningScore

Conciseness

Mostly lean, bullet-driven content that assumes Claude's competence (e.g., "Manager:IC ratio: 5-8 direct reports optimal", "Every 3x in team size requires a reorg") with no basic-concept padding, matching the efficient-with-minor-trimmable-instances anchor. Not 5: the "## Keywords" section duplicates the frontmatter trigger terms verbatim, and a few sections (e.g., the C-suite integration matrix) could be tightened; not 3: over-explanation is minor, not pervasive.

4 / 5

Actionability

Fully executable guidance: copy-paste commands ("python scripts/tech_debt_analyzer.py --output report.json"), a concrete prioritization formula ("(Severity × Blast Radius) / Cost-to-fix"), a ready-to-use ADR template with TCO/risk fields, a weighted build-vs-buy scoring table, and specific numeric targets ("< 25%", "< 200ms") covering the common cases. Both referenced scripts exist in scripts/, so the commands are real.

5 / 5

Workflow Clarity

Three multi-step workflows with clear sequencing and explicit validation checkpoints: the Tech Debt workflow ends in a Step 4 validation checklist ("Every P0/P1 item has an owner and a target date"), the ADR workflow has a Step 3 validation checkpoint, and the Build vs Buy workflow routes into the ADR validation via "Document the decision as an ADR". Not 4: no validation gaps remain; the operations are analytical rather than destructive/batch, so error-recovery loops are not required.

5 / 5

Progressive Disclosure

The body is an overview with well-signaled, one-level-deep references that all exist on disk: inline pointers ("See references/technology_evaluation_framework.md for the full evaluation framework") plus a Resources section annotating each of the three reference files, with the two Python tools properly offloaded to scripts/. Not 4: navigation is clean, references are neither buried nor nested, and nothing reference-worthy is left inline.

5 / 5

Total

19

/

20

Passed

Description

87%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 that explicitly states both what the skill does and when to use it, with natural trigger terms including synonyms. Trigger coverage is good but could absorb a few natural phrases (build vs buy, cloud migration) from the body's keyword list, and capability coverage omits a couple of responsibilities the body documents.

DimensionReasoningScore

Specificity

Lists several concrete actions — "assessing technical debt, scaling engineering teams, evaluating technologies, making architecture decisions, establishing engineering metrics" — matching the several-specific-actions-with-minor-gaps anchor. Not 5: coverage is not comprehensive (crisis management, vendor evaluation, and incident response from the body are absent); not 3: it names far more than 1-2 actions.

4 / 5

Completeness

Clearly answers both what ("Technical leadership guidance for engineering teams, architecture decisions, and technology strategy") and when ("Use when assessing... or when user mentions CTO, tech debt, technical debt, team scaling...") with concrete trigger phrases, matching the top anchor exactly. Not 4: the when-clause is explicit and enumerates specific triggers rather than being merely adequate.

5 / 5

Trigger Term Quality

Good natural keyword coverage including synonyms ("tech debt, technical debt", "team scaling", "DORA metrics", "CTO"), so it sits at the good-coverage-with-a-few-missing anchor. Not 5: common natural phrases users would say, such as "build vs buy", "cloud migration", or "system design", appear in the body's Keywords section but are omitted from the description.

4 / 5

Distinctiveness Conflict Risk

Anchored on a clear niche (CTO-level technical leadership) with distinct triggers — "CTO", "DORA metrics", "tech debt" — that few other skills would claim, matching the clear-niche anchor. Not 4: no meaningful overlap with closely related skills; the triggers are role-specific rather than generically technical.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

alirezarezvani/claude-skills

Path

c-level-advisor/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.