CtrlK
BlogDocsLog inGet started
Tessl Logo

retrieval-reflex

When/what to retrieve — open the brain page for a salient entity before answering from memory.

56

Quality

64%

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 ./recipes/retrieval-reflex/skills/retrieval-reflex/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 tight, well-structured instruction-only skill: concrete tool names, an explicit escalation ladder with stop conditions, and clear trigger/skip policy. Remaining gaps are minor — a trimmable motivational opening, CLI syntax relegated to a comment, and a mild reflex-vs-judgment framing tension.

DimensionReasoningScore

Conciseness

The body is lean and policy-dense with no explanation of concepts Claude already knows; the opening address-book analogy ("A person doesn't bulk-load their whole address book into working memory…") is rhetorical framing that could be trimmed to one line. Not level 5 because those few motivational lines don't strictly earn their place; not level 3 because the padding is minor and everything else is tight.

4 / 5

Actionability

Concrete, executable guidance throughout: `get_page <slug>` (MCP), pulling `graph` / `backlinks`, and a 3-level escalation ladder with explicit stop conditions ("stop there", "only when relationship context is needed"). Not level 5 because the exact CLI command forms (`gbrain graph`, `gbrain backlinks`) live only in a frontmatter comment rather than the body, leaving a minor gap for non-MCP use.

4 / 5

Workflow Clarity

The WHEN-to-retrieve conditions, skip rules, and the numbered escalate-and-stop ladder form a clear, unambiguous sequence with built-in checkpoints ("stop there", "no bulk-loading"). Not level 5 because the framing "Encode that reflex" sits in unresolved tension with "Judgment first — retrieve when it changes the quality of the reply, not reflexively", leaving slight ambiguity about whether to act reflexively or deliberatively; not level 3 because the sequence and stop conditions are explicit, and the skill is read-only so no validation loop is required.

4 / 5

Progressive Disclosure

No bundle files exist and the skill is under 50 lines with well-organized sections (Trigger policy, Retrieval spec, failure rationale, See also). Per the rubric's simple-skill guidance, well-organized sections with no need for external references score 5; the "See also" pointers to sibling skills are one level deep and clearly signaled.

5 / 5

Total

17

/

20

Passed

Description

50%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 states a clear single action and hints at timing, but the "when" guidance is only implied and the vocabulary is project-internal jargon rather than natural user language. It also fails to distinguish itself from the closely related query/search skill. These are fixable with one added sentence.

Suggestions

Add an explicit trigger clause, e.g. "Use when a named entity (person, company, project) becomes the subject of the exchange or you are about to assert a detail about it from memory" — this moves completeness from weakly-implied to explicit.

Replace or supplement jargon like "salient entity" and "brain page" with natural phrases a user or Claude would actually encounter ("mentioned a person/company/project", "look them up before answering"), and include common variations such as "who is", "tell me about" with a note that direct lookup questions route to skills/query.

State the boundary with the sibling skill in the description itself (e.g. "for explicit search requests, use skills/query instead") so this fires on the ambient reflex rather than competing with the search skill.

DimensionReasoningScore

Specificity

Names the domain (memory retrieval) and one concrete action ("open the brain page for a salient entity before answering from memory"), but stops there. It is not level 4 because only a single action is given and "When/what to retrieve" gestures at scope rather than listing actions.

3 / 5

Completeness

The "what" is clear (open the entity's brain page before answering), but the "when" is only weakly implied by "When/what to retrieve" and "before answering from memory"; there is no explicit "Use when…" clause, which caps completeness at 3. Not level 2 because a discernible trigger condition is present alongside the clear what.

3 / 5

Trigger Term Quality

Relevant keywords are present ("retrieve", "brain page", "entity", "answering from memory") but they are internal jargon; natural user phrases like "who is" or "tell me about" appear only in a frontmatter comment and are explicitly routed to a different skill. Not level 4 because common natural-language variations users would actually say are missing from the description itself.

3 / 5

Distinctiveness Conflict Risk

"open the brain page for a salient entity before answering from memory" carves out a niche, but it overlaps heavily with the sibling skills/query search skill and the description does not disambiguate when this reflex applies versus an explicit search request. Not level 4 because that boundary lives in a comment, not the description.

3 / 5

Total

12

/

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
garrytan/gbrain
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.