CtrlK
BlogDocsLog inGet started
Tessl Logo

using-glean

Use Glean MCP tools to answer questions about company documents, internal wikis, policies, RFCs, design docs, people, teams, meetings, decisions, action items, email, calendar events, internal code, and the user's own work activity. Reach for this whenever the answer lives in enterprise systems rather than the local codebase or public web. Trigger phrases include "find the doc about", "what's our policy on", "where is the spec for", "who works on", "who owns", "find someone who knows", "what was decided in the meeting", "action items from", "search my email", "what did I work on last week", and "find the implementation in our repos". Don't use it for questions answerable from the local working directory, the public web, or generic programming knowledge.

72

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 well-structured routing skill: a clean decision table with exact tool names, terse enforceable cross-tool rules, and correct use of progressive disclosure to defer parameter syntax to per-tool reference files. Weaknesses are minor — a few trimmable meta-commentary lines, an implicit rather than explicit usage sequence, and referenced bundle files that are not present in this evaluation bundle (with nonstandard 'reference/' path naming).

Suggestions

Trim self-referential meta-commentary ('This skill is the entry point. It maps a user's question to the right tool…', 'Internalize them, don't re-derive per call.') — the section structure already conveys this.

Add a brief numbered usage sequence (e.g., 1. confirm Glean tools in inventory → 2. match intent in the table → 3. open the tool's reference file → 4. apply cross-tool rules → 5. vet and cite) to make the workflow explicit rather than implied.

Ship the referenced bundle files with the skill and confirm the 'reference/' directory name matches the actual layout (standard naming is 'references/'), since every tool link currently points to an unverifiable path.

DimensionReasoningScore

Conciseness

The body is lean — a decision table plus five terse cross-tool rules, no explanation of concepts Claude already knows. A few meta-commentary lines could be trimmed ('This skill is the entry point. It maps a user's question…', 'Internalize them, don't re-derive per call.'), which keeps it below the 5 anchor's 'every token earns its place' but well above 3's 'some unnecessary explanation'.

4 / 5

Actionability

Concrete, executable routing guidance: an intent→tool decision table with exact bare tool names ('search', 'employee_search', 'meeting_lookup', 'code_search'…), the raw MCP naming pattern ('mcp__glean_[server-name]__[tool]'), a fallback action when tools are absent ('ask the user to set up Glean'), and hard rules like 'Never use search for people lookups… Use employee_search'. Per the rubric's instruction-skill note, the absence of code is not penalized because the guidance is fully actionable.

5 / 5

Workflow Clarity

The core single action (map intent → tool → open its reference file) is unambiguous via the decision table, and error handling is built into the cross-tool rules ('Permission-empty results are valid signals… report empty cleanly', 'No URL → likely fabricated', vetting before presenting). However, the flow (check inventory → route → open reference → apply rules → vet) is implied rather than laid out as an explicit sequence, so it falls between the 4 and 5 anchors rather than matching 5's explicit stepwise structure.

4 / 5

Progressive Disclosure

Textbook overview structure: every deep detail is pushed to clearly signaled one-level-deep reference files in the decision table and a dedicated cross-cutting reference section, matching the 5 anchor's shape. However, no bundle files ship with this skill (no references/, scripts/, or assets/ directories exist), so the 12+ referenced paths under 'reference/' cannot be verified and the directory name is nonstandard, leaving minor navigation uncertainty that holds it below 5.

4 / 5

Total

17

/

20

Passed

Description

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

A strong description: comprehensive domain enumeration, highly natural trigger phrases in the user's own voice, and explicit when/when-not boundary guidance that cleanly separates it from local-codebase and public-web skills. The only weakness is that the core action is stated as a single generic verb ('answer questions about') rather than multiple distinct concrete operations.

DimensionReasoningScore

Specificity

Names the domain comprehensively ('company documents, internal wikis, policies, RFCs, design docs, people, teams, meetings, decisions, action items, email, calendar events, internal code, and the user's own work activity') but the action itself is a single generic verb — 'answer questions about' — rather than several distinct concrete operations like the 5-anchor's 'extract, fill, merge, convert'. Comprehensive coverage with minor gaps places it above 3 (which expects only 1-2 concrete actions) and below 5 (multiple distinct actions).

4 / 5

Completeness

Explicitly answers both: what ('Use Glean MCP tools to answer questions about company documents… internal code, and the user's own work activity') and when ('Reach for this whenever the answer lives in enterprise systems rather than the local codebase or public web' plus concrete trigger phrases), and adds an explicit when-not clause. This matches the 5 anchor's structure of what + when with concrete triggers.

5 / 5

Trigger Term Quality

Includes ten natural trigger phrases users would actually say ('find the doc about', "what's our policy on", 'where is the spec for', 'who works on', 'who owns', 'find someone who knows', 'what was decided in the meeting', 'action items from', 'search my email', 'what did I work on last week', 'find the implementation in our repos') — comprehensive synonym-level coverage across the whole domain, matching the 5 anchor.

5 / 5

Distinctiveness Conflict Risk

Clear niche (enterprise knowledge via Glean MCP) with explicit boundary guidance: 'Don't use it for questions answerable from the local working directory, the public web, or generic programming knowledge.' This carves it away from local-code and web-search skills, minimizing overlap risk — matching the 5 anchor's 'clear niche with distinct triggers'.

5 / 5

Total

19

/

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: 15 missing

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.