CtrlK
BlogDocsLog inGet started
Tessl Logo

zoom-out

Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.

56

Quality

65%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/agentic-engineering/skills/zoom-out/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

57%

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 has good structural completeness with an explicit 'Use when' clause, but suffers from vague capability specification—it doesn't describe concrete actions the skill performs. The trigger terms are reasonable but not comprehensive, and the skill's niche could easily overlap with other code understanding or documentation skills.

Suggestions

Replace vague language like 'zoom out and give broader context' with specific actions such as 'Summarizes module architecture, traces call chains, identifies dependencies, and explains how a code section relates to the broader codebase'.

Add more natural trigger terms users would say, such as 'explain this code', 'what does this module do', 'architecture overview', 'codebase walkthrough', or 'how does this function fit in'.

Clarify what distinguishes this from general code explanation or documentation skills to reduce conflict risk—e.g., specify it focuses on contextualizing unfamiliar code within a larger system rather than line-by-line explanation.

DimensionReasoningScore

Specificity

The description uses vague language like 'zoom out' and 'broader context' without listing concrete actions. It doesn't specify what the skill actually does—no mention of specific outputs like summaries, architecture diagrams, dependency maps, or call graphs.

1 / 3

Completeness

The description does answer both 'what' (tells the agent to zoom out and give broader context) and 'when' (use when unfamiliar with code or need to understand how it fits into the bigger picture), with an explicit 'Use when' clause.

3 / 3

Trigger Term Quality

Contains some relevant terms like 'broader context', 'higher-level perspective', 'bigger picture', and 'unfamiliar with a section of code', which users might naturally say. However, it misses common variations like 'explain this codebase', 'architecture overview', 'how does this work', or 'what does this module do'.

2 / 3

Distinctiveness Conflict Risk

The concept of 'broader context' and 'higher-level perspective' is somewhat specific to code comprehension, but could easily overlap with documentation skills, code review skills, or general explanation skills. The triggers are not niche enough to clearly distinguish it.

2 / 3

Total

8

/

12

Passed

Implementation

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a concise, focused prompt-style skill that efficiently communicates intent. Its main weakness is the lack of a concrete example of expected output format (e.g., a sample module map or dependency diagram), which would make it more actionable. The workflow is simple enough that the implicit single-step nature is acceptable, though a brief expected-output example would elevate it.

Suggestions

Add a brief example of the expected output format (e.g., a sample module/caller map) so Claude knows exactly what structure to produce.

Consider specifying what to do when CONTEXT.md is not present — e.g., infer domain vocabulary from code or ask the user.

DimensionReasoningScore

Conciseness

Extremely lean — two sentences that convey exactly what Claude should do without explaining concepts Claude already knows. Every token earns its place.

3 / 3

Actionability

It gives a clear directive ('go up a layer of abstraction', 'give me a map of all the relevant modules and callers') and references CONTEXT.md, but provides no concrete example of what the output should look like — no sample module map, no format template, no example output structure.

2 / 3

Workflow Clarity

For a simple single-task skill, the action is fairly unambiguous, but there's no explicit sequence: it doesn't specify whether to first check for CONTEXT.md, then enumerate modules, then show callers. The steps are implicit rather than sequenced.

2 / 3

Progressive Disclosure

This is a very short, single-purpose skill with no need for external references beyond the optional CONTEXT.md mention. The content is appropriately sized and well-organized for its scope.

3 / 3

Total

10

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
belchman/claude-skills
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.