CtrlK
BlogDocsLog inGet started
Tessl Logo

code-walk-thru

Use this when user wants you to walk through (code or text) files in a EDITOR to either explain how some code works, or to show the user what changes you made, etc. You would typically use this repeatedly to show the user your changes or code files one by one, sometimes with specific line-numbers. This way the user is easily able to follow along in their favorite EDITOR as you point at various files possibly at specific line numbers within those files.

68

Quality

85%

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.

The body is an exemplar of a lean, single-purpose skill: it states the decision rule, an explicit interaction checkpoint, five concrete editor commands, and a failure fallback with zero padding. The only notable flaw is inconsistent placeholder style across the command examples.

DimensionReasoningScore

Conciseness

The ~45-line body is lean and assumes Claude's competence: no explanations of what editors or CLIs are, just the decision rule ("Depending on which EDITOR the user says they are using... If no editor specified, you must ask"), the critical interaction constraint ("you MUST wait for the user to say something before moving on"), five terse command blocks, and a one-line failure fallback ("If any of these fail tell the user to install the corresponding CLI tool"). Every token earns its place.

5 / 5

Actionability

Concrete, executable commands are given for five editors ("code --goto <file_path>:<line_number>", "pycharm --line <line_number> <file_path>", etc.), covering the common cases. It sits below a 5 because the placeholder formats are inconsistent across examples (<file_path>:<line_number> vs. "path/to/file.md:43" vs. "+42 blah.py") and the IntelliJ command name is stated without the general parameter convention used for the others.

4 / 5

Workflow Clarity

For this simple, single-purpose skill the sequence is unambiguous: determine the user's editor (asking if unspecified), show a file at an optional line, and the explicit checkpoint "you MUST wait for the user to say something before moving on to the next file", plus an error-recovery instruction if a CLI command fails. No destructive or batch operations are involved, so no validation cap applies.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files (references/, scripts/, assets/ are absent) and no need for external references. Per the simple-skill guideline, well-organized sections alone warrant a 5: the single "## Instructions" section cleanly separates the decision rule, the one-by-one/wait constraint, per-editor commands, and the failure fallback.

5 / 5

Total

19

/

20

Passed

Description

70%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 clearly answers both what the skill does and when to use it, with a distinctive editor-navigation niche and mostly natural trigger language. Its weaknesses are second-person voice, a repetitive and slightly padded structure, and an "etc." that blurs the capability list.

Suggestions

Rewrite in third person (e.g., "Walks through code or text files in the user's editor... points at specific line numbers") to remove the second-person phrasing the rubric penalizes.

Cut the repetition ("sometimes with specific line-numbers... possibly at specific line numbers" says the same thing twice) and replace "etc." with the remaining concrete use cases.

Add natural trigger synonyms a user would actually say, such as "walk me through", "show me your changes", or "open the file at line N", to broaden keyword coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "walk through (code or text) files in a EDITOR", "explain how some code works", "show the user what changes you made", "at specific line numbers" — which would rate a 4, but it is written in second person ("user wants you to walk through", "You would typically use this", "This way the user is easily able"), which the guidelines penalize by one point.

3 / 5

Completeness

Both parts are present: the 'when' is explicit ("Use this when user wants you to walk through... files in a EDITOR") and the 'what' names concrete actions (explain code, show changes, point at line numbers). It falls short of a 5 because the 'what' is diluted by repetition ("sometimes with specific line-numbers... possibly at specific line numbers") and hedged with "etc.", leaving the capability list less crisp than the anchor-5 example.

4 / 5

Trigger Term Quality

Good natural-keyword coverage: "walk through", "code or text files", "explain how some code works", "show the user what changes", "line numbers", "editor" are phrases a user would plausibly say. Common variations like "walk me through", "show me your changes", or "open file at line N" are missing, keeping it below a 5.

4 / 5

Distinctiveness Conflict Risk

The editor-walkthrough-with-line-numbers niche is mostly distinct — no other typical skill triggers on navigating the user's editor to a specific file/line. There is minor overlap risk with code-review or code-explanation skills via the generic phrase "explain how some code works", which keeps it from a 5.

4 / 5

Total

15

/

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
pchalasani/claude-code-tools
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.