CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

understand-chat

Use when you need to ask questions about a codebase or understand code using a knowledge graph

Quality

76%

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 ./understand-anything-plugin/skills/understand-chat/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 strong, well-structured instruction body: fully sequenced workflow with genuine validation and failure-handling logic (the freshness check is especially thorough), concrete commands, and no filler. The only deductions are minor — slight redundancy between the reading-tips section and the numbered steps, and a couple of semi-placeholder grep examples.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no space is spent on what knowledge graphs or grep are, and the Graph Structure Reference conveys genuinely unknown schema facts compactly. It falls short of 5 due to mild redundancy: "How to Read Efficiently" ("Use Grep to search... BEFORE reading the full file") restates what numbered steps 3-5 instruct again.

4 / 5

Actionability

Mostly executable guidance: concrete commands like `UA_DIR=$([ -d .understand-anything ] && echo .understand-anything || echo .ua)`, an exact five-command git freshness block, and precise file paths. Minor gaps keep it below 5: step 4's `grep -i "query_keyword"` is a placeholder rather than a literal command, and "Search `summary` fields for semantic matches" gives no concrete method for semantic search.

4 / 5

Workflow Clarity

Seven clearly sequenced steps with explicit validation checkpoints and error-recovery branches: step 1 verifies the graph file exists (with a recovery path: "tell the user to run `/understand` first"), step 2 validates freshness with per-failure-case handling (unresolvable commit → "best-effort warning and continue instead of blocking"), and step 7 handles the no-match case ("say so and suggest related terms"). This matches the anchor-5 pattern of explicit validation steps with feedback loops.

5 / 5

Progressive Disclosure

No bundle files exist, and the ~65-line body is well-sectioned (Graph Structure Reference / How to Read Efficiently / Instructions) with easy navigation and no nested references. It is a 4 rather than 5 because the body exceeds the ~50-line simple-skill threshold and the Graph Structure Reference section (~12 lines of schema detail) is exactly the kind of lookup material that could live in a reference file, though inlining it is defensible since it's needed on every invocation.

4 / 5

Total

17

/

20

Passed

Description

61%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 correctly includes an explicit "Use when..." trigger and a distinctive mechanism (knowledge graph), but it is written in second person ("Use when you need to"), lists only two generic actions, and misses common natural trigger synonyms. It sits just above the midpoint: functional but under-specified.

Suggestions

Rewrite in third person with verb-led actions, e.g. "Answers questions about a codebase by searching the project's knowledge graph for matching nodes, tracing imports/calls edges, and mapping results to architectural layers."

Add natural trigger synonyms users would actually say: "explain", "explore the codebase", "how does X work", "code navigation".

Include a fallback trigger for when the user mentions the knowledge graph or `.ua/` data directly, which sharpens distinctiveness from generic code-exploration skills.

DimensionReasoningScore

Specificity

"ask questions about a codebase" and "understand code using a knowledge graph" name the domain and 1-2 actions, matching the anchor-3 example ("Processes PDF files and extracts content"), but the rubric mandates a -1 penalty for second-person voice, and the description opens with "Use when you need to" — direct second person. It also never states the concrete mechanism (searching graph nodes, tracing edges, identifying layers).

2 / 5

Completeness

Both parts are explicitly present: the what ("ask questions about a codebase or understand code using a knowledge graph") and the when ("Use when you need to..."). It is not a 5 because the what is thin — it doesn't say the skill searches a knowledge-graph JSON and traces relationships — and the when, while explicit, leans on one general condition rather than concrete trigger phrases.

4 / 5

Trigger Term Quality

Natural trigger phrases are present: "ask questions about a codebase", "understand code", and the distinctive "knowledge graph". This is good coverage comparable to anchor 4 ("PDF files, forms, document extraction"), though common variations users would actually say — "explain this code", "explore the codebase", "how does X work" — are missing, keeping it below 5.

4 / 5

Distinctiveness Conflict Risk

"understand code" and "ask questions about a codebase" are broad phrases that overlap with general code-comprehension and exploration skills; only the "using a knowledge graph" qualifier carves out a niche. This matches anchor 3 ("somewhat specific but could still overlap with similar skills") and is above anchor 2 only because of that qualifier.

3 / 5

Total

13

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

Egonex-AI/Understand-Anything

Path

understand-anything-plugin/skills/understand-chat/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.