CtrlK
BlogDocsLog inGet started
Tessl Logo

using-glean-code

Search and analyze internal source code across the organization's repositories — use when asked how something is implemented, where the code for a system lives, who has been working on a codebase, or to find similar patterns across teams. Trigger phrases include how is X implemented, where is the code for, find the implementation of, what repos contain, who wrote the code for, how do other teams handle, find similar code to, examples of using, prior art for. Do not use for code in the current working directory (prefer local Grep/Glob), for design docs (use the using-glean skill's search reference), or for finding people without code context (use the using-glean skill's employee-search reference).

67

Quality

84%

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

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 a well-structured overview with genuinely actionable tool-selection and vetting guidance, and it correctly delegates deep parameter detail to a canonical reference. Its weaknesses are internal duplication (local-vs-Glean point and filter criteria stated twice) and references that point to files absent from the bundle.

Suggestions

Delete the 'Key differentiator' section (or fold its three example questions into 'When to reach for this') — the opening paragraph already makes the local-vs-cross-repo distinction, and the section repeats it verbatim.

Remove the redundant 'Filter out:' sentence in the Vetting section — the Quality/Recency/Relevance tests and the section's first line already cover those criteria.

Ship the referenced files (reference/exploration.md, reference/plan-prep.md) in the bundle or inline their one-line summaries, so the clearly-signaled links are not dangling.

DimensionReasoningScore

Conciseness

Mostly efficient with no over-explanation of known concepts, but it could be tightened: the local-vs-Glean distinction is stated in the opening paragraph ("Local tools (`Grep`, `Glob`, `Read`) see only the current repo") and repeated almost verbatim in the "Key differentiator" section, and the Vetting section's "Filter out:" line duplicates the criteria already given in the Quality/Recency/Relevance tests and the section's opening sentence. Not 4 because the duplication is noticeable across three sections, not minor trimming.

3 / 5

Actionability

Concrete guidance throughout: exact tool names (`code_search`, `search`, `employee_search`, `read_document`) in a selection table keyed to user intent, vetting criteria with specific thresholds ("Commits in past 3 months", "12+ months"), and specific presentation rules (full URL, last-update date, group by repo, flag drift). Per the code_vs_instruction note, absent code is not penalized since the guidance is actionable; it falls short of 5 only because no example `code_search` invocation or concrete search pattern appears inline — full param shape is delegated to the reference file.

4 / 5

Workflow Clarity

The sections read in workflow order (when to reach for it → tool selection → vetting → output expectations) and vetting functions as an explicit validation checkpoint with pass/fail tiers (GOOD/ACCEPTABLE/POOR, ACTIVE/SLOWING/STALE, RELEVANT/RELATED/TANGENTIAL) before surfacing results. Not 5 because the search → vet → present sequence is implicit rather than stated as steps, and there is no error-recovery guidance (e.g., what to do when a search returns nothing or only POOR matches). Not a destructive/batch skill, so no validation cap applies.

4 / 5

Progressive Disclosure

References are clearly signaled, one level deep, with descriptive labels, and the body stays an overview — but the bundle contains no files at all, so the promised `reference/exploration.md` and `reference/plan-prep.md` (plus the cross-skill `../using-glean/reference/...` paths) are dangling. Not 4 because missing own-bundle reference files are more than a minor organization gap: navigation to the referenced workflow material fails as shipped.

3 / 5

Total

14

/

20

Passed

Description

100%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 is exemplary: it states concrete capabilities in third person, gives an explicit 'use when' clause backed by nine natural trigger phrases, and closes with three precise 'do not use for' carve-outs that eliminate overlap with neighboring skills. Its only cost is length, but every clause is functional rather than padded.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities: "Search and analyze internal source code across the organization's repositories", locating where code lives, finding who has been working on a codebase, and finding similar patterns across teams — comprehensive coverage of the skill's actions, matching the top anchor. Not 4 because no capability area is left uncovered.

5 / 5

Completeness

Both halves are explicit: what ("Search and analyze internal source code across the organization's repositories") and when ("use when asked how something is implemented, where the code for a system lives...") with concrete trigger phrases, plus explicit negative triggers ("Do not use for code in the current working directory..."). This matches the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

Nine natural trigger phrases users would actually say are enumerated: "how is X implemented, where is the code for, find the implementation of, what repos contain, who wrote the code for, how do other teams handle, find similar code to, examples of using, prior art for" — including synonyms like "prior art". Not 4 because the coverage is comprehensive rather than 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

A clear niche is staked out (cross-org code search vs. local tools), with explicit disambiguation against local Grep/Glob, the using-glean skill's search reference for design docs, and its employee-search reference for people lookups — minimal conflict risk.

5 / 5

Total

20

/

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

relative_links

Relative link issues: 4 missing, 2 suspicious

Warning

Total

15

/

16

Passed

Repository
gleanwork/claude-plugins
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.