CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cto-review

/cs:cto-review <plan> — Architecture and scaling interrogation. Tech debt, scaling cliffs, team scaling, build-vs-buy. Use when committing to an architecture, planning for 10x load, or weighing a rebuild against a vendor.

63

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./.gemini/skills/cto-review/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 well-built review skill: concrete commands, sharp forcing questions with example answers, a complete output template, and an explicit workflow with a tiered verdict. The main gaps are redundancy in command/routing mentions and externally-anchored script references with no stated usage.

Suggestions

State usage for the referenced scripts (arguments, expected output) or move them into the skill's scripts/ bundle so the commands are verifiably executable.

Deduplicate the cs-ciso-advisor handoff (Question 6, Workflow step 3, and Routing all repeat it) and drop the redundant standalone "Command:" line.

DimensionReasoningScore

Conciseness

The body is lean and question-driven with no padding explaining concepts Claude already knows, and includes genuinely useful concrete material (an example answer like "It breaks at 10× current load because the primary DB writes saturate", a full output template). Minor trims remain: the command name appears in the frontmatter, the H1, and a standalone "Command:" line, and cs-ciso-advisor routing is repeated in Question 6, the Workflow, and the Routing section — so not every token earns its place.

4 / 5

Actionability

Two concrete bash commands (tech_debt_analyzer.py, team_scaling_calculator.py) and a copy-paste-ready output template make the guidance mostly executable, fitting the 4 anchor. It is below 5 because the referenced scripts live outside the skill bundle via deep relative paths (../../../c-level-advisor/...) and take no stated arguments or inputs, leaving minor gaps.

4 / 5

Workflow Clarity

The Workflow section gives a clear four-step sequence (run analyzers → define scaling-cliff hypothesis → cross-check security → apply verdict), and the six questions plus the tiered 🟢/🟡/🔴 verdict act as a checklist with a decision checkpoint. It is not a destructive or batch operation so no 3-cap applies, but there is no explicit feedback/error-recovery loop (e.g. what to do when the break-point hypothesis cannot be confirmed), keeping it below the 5 anchor.

4 / 5

Progressive Disclosure

Sections are well-organized (When to Run, Six Questions, Workflow, Output Format, Routing, Related) and external references (cs-cto-advisor agent, cto-advisor skill, slo-architect) are one level deep and clearly signaled with paths, matching the good-structure anchor. It falls short of 5 because the analyzer scripts are invoked via deep inline relative paths rather than a clean, clearly-labeled script layout, and the linked resources sit outside the skill bundle.

4 / 5

Total

16

/

20

Passed

Description

75%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: explicit trigger guidance with concrete use-when phrases, natural CTO vocabulary, and a clearly bounded niche. Its main limitation is that the what is a compressed noun list — stating the output (six forcing questions with a verdict) would make it fully explicit.

Suggestions

State the output in the description, e.g. "Runs six forcing questions (scaling cliff, tech debt, team scaling, build-vs-buy, SLOs, security surface) and returns a SHIP/SHARPEN/BLOCK verdict."

Add common trigger synonyms such as "capacity planning", "SLOs/reliability", or "doubled the engineering team" to widen natural-term coverage.

DimensionReasoningScore

Specificity

"Architecture and scaling interrogation. Tech debt, scaling cliffs, team scaling, build-vs-buy." lists several specific focus areas with minor gaps (SLO/reliability omitted), matching the anchor for several specific items; it is below the 5 anchor because the items are noun topics rather than concrete actions like "Extract text... fill forms".

4 / 5

Completeness

Both parts exist: the what ("Architecture and scaling interrogation" plus four named areas) and an explicit "Use when committing to an architecture, planning for 10x load, or weighing a rebuild against a vendor." It falls short of the 5 anchor because the what is a telegraphic topic list that never states what the skill produces (a six-question interrogation with a SHIP/SHARPEN/BLOCK verdict).

4 / 5

Trigger Term Quality

Natural phrases a user would say are present — "committing to an architecture", "planning for 10x load", "tech debt", "build-vs-buy", "rebuild against a vendor" — but common synonyms like "SLO", "capacity planning", or "team growth" are missing, so it fits the good-but-not-comprehensive anchor.

4 / 5

Distinctiveness Conflict Risk

A clear CTO-level niche ("scaling interrogation", "10x load", build-vs-buy framing) distinguishes it from generic review skills, but it acknowledges overlap with siblings — build-vs-buy > $100K routes to cfo-review — matching the mostly-distinct anchor with minor overlap risk.

4 / 5

Total

16

/

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

relative_links

Relative link issues: 2 suspicious

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/cto-review/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.