CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

claude-coach

Personal coach that teaches users to become Claude power users. Use this skill the FIRST time a user asks to "learn Claude", "be a power user", "coach me", "teach me Claude tricks", "what can Claude do", "make me better at prompting", or any variation. After activation, also use it on EVERY subsequent turn to detect missed optimization opportunities (vague prompts, ignored capabilities, manual work Claude could automate) and surface a single power-user tip. Trigger generously — most users do not know what they do not know, so err on the side of coaching.

59

Quality

74%

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/claude-coach/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

52%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 with concrete output formats and a clear first-activation workflow, but it is undermined by a bundle that does not exist: the core Step 2 depends on reading `references/cheat-codes.md`, which is absent, along with all three referenced scripts. A duplicated README-style tail (Name, Description, Usage, Features) restates frontmatter and earlier sections, inflating token cost without adding guidance.

Suggestions

Ship the referenced bundle files (`references/cheat-codes.md`, `references/coaching-rules.md`, and the three `scripts/*.py`) or remove the references and inline the minimum needed content — the first-activation flow's Step 2 cannot execute without `references/cheat-codes.md`.

Delete the duplicated README tail ("## Name", "## Description", "## Features", "## Usage", "## Examples", "## Scripts" sections) — it restates frontmatter and repeats the activation phrases and examples already covered, cutting the body by roughly a third.

Fix the frontmatter hygiene: duplicate keys with conflicting values (`Name`/`name` and `Version: 1.0.0` vs `version: 2.9.0`) and unexplained metadata (`Tier: POWERFUL`, `Category: meta`) invite parsing ambiguity and drift.

DimensionReasoningScore

Conciseness

The rules core (Rules 1-7, tone guidance) is tight, but the tail duplicates material: a "## Name" / "## Description" section restating frontmatter, "## Usage" re-listing the same activation phrases already given under "When to invoke this skill" ("Coach me on Claude", "Make me a Claude power user" appear twice), and "## Features"/"## Examples" re-describing what earlier sections already prescribe. Mostly efficient but clearly could be tightened by roughly a third; it is not anchor 2 because the padding is duplication rather than concept explanation, and the core sections earn their tokens.

3 / 5

Actionability

Concrete, copy-paste-ready formats exist (the ⚡ tip template, the structured "rate that prompt" block, the first-activation 3-step sequence), but the pivotal Step 2 instructs "Read `references/cheat-codes.md`" and three `scripts/*.py` files are listed — none of which exist in the bundle — so the personalized glossary, the skill's core deliverable, cannot be produced as instructed. Not anchor 4 because key executable material is missing; not anchor 2 because substantial specific guidance and exact output formats are present.

3 / 5

Workflow Clarity

The first-activation flow is a clearly sequenced 3-step process with an explicit conditional checkpoint ("If the user already mentioned their use case in the activating message, skip this question and proceed"), and ongoing behavior is enumerated as Rules 1-7 with explicit do/do-not trigger lists. No destructive or batch operations, so no validation loop is required. Not anchor 5 because there are no error-recovery or feedback checkpoints (e.g., what to do if the glossary cannot be built or the user pushes back mid-flow — the opt-out appears only in the Features tail).

4 / 5

Progressive Disclosure

The body cites `references/cheat-codes.md` ("Read on first activation"), `references/coaching-rules.md`, and three scripts — but the bundle contains no references/, scripts/, or assets/ directories, so every referenced path is a dead end and the claimed file split is undelivered. The design intent is good (one-level-deep, clearly signaled references), but scoring against the actual bundle structure the navigation fails outright, and the README-style tail inlines frontmatter content (Name/Description) that does not belong in the body. Not anchor 1 because references are clearly signaled, one level deep, and not nested.

2 / 5

Total

12

/

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 clearly answers both what the skill does and when to fire it, with an excellent set of natural trigger phrases. Its main risks are over-triggering language ("EVERY subsequent turn", "Trigger generously", "any variation") and omission of the skill's on-demand features (prompt rating, progress check, opt-out).

DimensionReasoningScore

Specificity

The description lists several concrete actions — "teaches users to become Claude power users", "detect missed optimization opportunities (vague prompts, ignored capabilities, manual work Claude could automate)", "surface a single power-user tip" — but omits key capabilities the skill body advertises ("rate that prompt" feedback, progress checks, the "stop with the tips" opt-out), leaving minor gaps in coverage. It is above anchor 3 (more than 1-2 actions named) but below anchor 5 (not comprehensive).

4 / 5

Completeness

Both questions are explicitly answered: the what ("Personal coach that teaches users to become Claude power users... detect missed optimization opportunities... surface a single power-user tip") and the when ("the FIRST time a user asks to..." plus "on EVERY subsequent turn" after activation) with concrete trigger phrases. This mirrors the anchor-5 good example's what+when-with-triggers structure; anchor 4 would mean the 'when' was present but less explicit.

5 / 5

Trigger Term Quality

It quotes natural phrases users would actually say — "learn Claude", "be a power user", "coach me", "teach me Claude tricks", "what can Claude do", "make me better at prompting" — and adds "or any variation", giving comprehensive synonym coverage. This matches the anchor-5 pattern of full natural-term coverage; anchor 4 would require a few missing terms, which is not the case.

5 / 5

Distinctiveness Conflict Risk

The coaching niche is named and moderately distinct, but the directives "also use it on EVERY subsequent turn", "Trigger generously", and "or any variation" push it toward over-triggering across all conversation turns, and "what can Claude do" is generic enough to collide with capability-overview skills. It does not fall to anchor 2 (the domain is specific, not 'document files'-level broad) but the overlap risk is more than the 'minor' allowed by anchor 4.

3 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 7 missing

Warning

Total

14

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/claude-coach/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.