CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

claude-code-guide

Master guide for using Claude Code effectively. Includes configuration templates, prompting strategies "Thinking" keywords, debugging techniques, and best practices for interacting with the agent.

Quality

70%

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 ./cli-tool/components/skills/ai-research/claude-code-guide/SKILL.md

The canonical home for this skill is claude-code-guide in sickn33/agentic-awesome-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-structured into clear sections with a concrete, copy-paste-ready CLAUDE.md template and no unnecessary file indirection. However, it spends tokens on generic prompting advice Claude already knows, its debugging guidance is vague rather than executable, and the Purpose section duplicates the frontmatter, dragging down conciseness and actionability.

Suggestions

Delete the "Purpose" section — it duplicates the frontmatter description and adds no new information.

Replace abstract debugging directions ("check the logs", "be extremely specific") with executable steps or commands (e.g., the actual verbose flag, how to start a fresh session, what to restate when context is confused).

Cut or move the generic prompting folklore ("Think step-by-step" keywords, small-contexts advice) that Claude already knows, keeping only tool-specific, non-obvious guidance.

DimensionReasoningScore

Conciseness

The body is mostly tight, but the "Purpose" section restates the frontmatter description and the "Best Practices" section explains concepts Claude already knows ("Use `grep` or `find` to locate relevant files first", ask for small changes and verify). This matches 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than anchor 4's 'minor instances of over-explanation'.

3 / 5

Actionability

The CLAUDE.md template is concrete and copy-paste ready, but the remaining guidance is abstract direction rather than executable steps — "Be extremely specific about paths, filenames, and desired outcomes", "ask the agent to 'check the logs'" — with no commands or example prompts. This fits 'some concrete guidance but incomplete' rather than anchor 4's 'mostly executable guidance'.

3 / 5

Workflow Clarity

As a reference-style skill with no multi-step or destructive operations, no validation checkpoints are required, and the sections are coherently ordered (configuration → advanced features → best practices). It does not reach 5 because no explicit guidance tells Claude when or how to apply each section (e.g., when to offer the CLAUDE.md template).

4 / 5

Progressive Disclosure

The body is short (~63 lines), well-organized with clear section headers, and requires no external references — the only link is a one-level attribution to the upstream GitHub repo, and no bundle files exist to manage. Per the short-skill guideline, well-organized sections alone warrant a 5; there is no inlined content that belongs in separate files.

5 / 5

Total

15

/

20

Passed

Description

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

The description uses third-person voice and names several concrete content areas, giving reasonable specificity and keyword coverage. However, it lacks any explicit 'Use when...' trigger clause (capping completeness) and its 'master guide' framing over-claims the whole Claude Code domain, creating overlap risk with more targeted skills.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks about setting up CLAUDE.md, configuring Claude Code, improving prompts, or debugging unresponsive agent sessions."

Replace vague padding like "best practices for interacting with the agent" with concrete deliverables (e.g., "CLAUDE.md templates, thinking-keyword prompts, debugging checklists").

Include concrete trigger synonyms and file names (CLAUDE.md, settings, configuration) and narrow the 'master guide' scope so it is distinguishable from other Claude Code skills.

DimensionReasoningScore

Specificity

The description lists several concrete content categories — "configuration templates, prompting strategies 'Thinking' keywords, debugging techniques" — matching the anchor for several specific items with minor gaps; vague padding ("best practices for interacting with the agent") keeps it below 5, while its 4 concrete items exceed the 1-2 actions of the anchor 3 example.

4 / 5

Completeness

It has a clear 'what' (master guide with configuration templates, prompting strategies, debugging techniques) but no 'Use when...' clause or equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 3. It is not a 4 because the 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

It includes natural phrases users would say in this domain ("using Claude Code", "configuration", "prompting", "debugging"), giving good keyword coverage, though a few natural terms are missing (e.g., CLAUDE.md, settings, setup). Coverage is broader than the anchor 3 example ('Works with PDF files'), so it is not a 3.

4 / 5

Distinctiveness Conflict Risk

"Master guide for using Claude Code effectively" is scoped to a specific tool but claims the entire usage domain, so it could overlap with configuration, prompting, and debugging skills. It is not a 4 because the broad 'master guide' framing invites triggering on nearly any Claude Code question rather than a distinct niche.

3 / 5

Total

14

/

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

davila7/claude-code-templates

Path

cli-tool/components/skills/ai-research/claude-code-guide/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.