CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

resolve-before-asking

Gate on identity questions to the user. Before any "who is X?" (or role / relationship question) reaches the user, exhaust the brain's lookup chain: think → search + page read → mounted sources → timeline/graph → web. If escalation survives the chain, ask WITH a hypothesis, never a bare unknown. Also owns the no-placeholders-at-ingest rule: pages created during bulk ingestion get their relationship/role resolved immediately.

Quality

87%

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

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

An exemplary operational skill body: an ordered lookup chain with explicit stop conditions, executable commands at every step, a validated batch ingest pass, error-recovery guidance, and clearly signaled one-level-deep cross-references. The only real weaknesses are mild rhetorical padding and a monolithic single-file layout where a reference file could offload the ingest-resolution detail.

Suggestions

Trim the motivational framing ('The Bug This Kills' anecdotes, 'The Standard' section) to their one-line essences — the contract and anti-patterns sections already carry the same enforcement signal.

Move the ingest-resolution detail (post-ingest pass, domain-shortcut table, batch sizing) into a references/ file (e.g., references/ingest-resolution.md) and keep a short summary plus clearly signaled link in SKILL.md, taking advantage of progressive disclosure the bundle currently doesn't use.

DimensionReasoningScore

Conciseness

The body is dense with operational content — commands, thresholds, a domain-shape table, anti-patterns — with only minor trimmable framing such as the 'The Bug This Kills' anecdotes and the rhetorical 'The Standard' closer. Efficient with minor instances of over-explanation (anchor 4), not 5 (the motivational sections don't strictly earn their tokens) and not 3 (there is no padding that teaches concepts Claude already knows).

4 / 5

Actionability

Fully executable throughout: copy-paste-ready commands ('gbrain think "Who is {entity}?..."', 'gbrain search "{entity}" --limit 5', 'gbrain timeline {entity-slug} --limit 20'), exact placeholder markers to scan for ('[To be filled', 'Unknown relationship', 'TBD'), concrete batch parameters ('batches of 10–20', '100+ pages'), and a complete escalation output template — specific examples cover the common cases.

5 / 5

Workflow Clarity

The six-step chain is explicitly ordered with 'STOP at the first clear answer' validation checkpoints, confidence thresholds define the stop/ask decision, the post-ingest batch pass opens with a validation/skip check (step 1 placeholder scan) plus a quality-bar acceptance test, and 'When it fails' provides a feedback loop ('revision_conflict: re-read and merge'). The batch-operation cap does not apply because validation and recovery steps are present.

5 / 5

Progressive Disclosure

Thirteen clearly headed sections with sibling-skill references (../conventions/brain-first.md, ../ask-user/SKILL.md, ../query/SKILL.md, etc.) that are one level deep and well-signaled via the top convention blockquotes and the sharp-boundary Dedup section. However, no bundle files exist (no references/, scripts/, or assets/), so all ~290 lines are inline — the ingest batch mechanics and domain-shortcut table could live in a separate reference file — which keeps it below the top anchor and outside the under-50-line simple-skill exception.

4 / 5

Total

18

/

20

Passed

Description

83%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: it names concrete, enumerated actions across both owned behaviors (the pre-ask lookup chain and the ingest placeholder rule) and states its when-condition inline. The main gaps are missing natural synonym variations in the description text itself and reliance on a separate when_to_use field for explicit trigger phrasing.

Suggestions

Fold one or two natural user variations into the description itself (e.g., 'who is this person' or 'unidentified contact') so the description alone carries the trigger coverage the triggers list provides.

Add an explicit 'Use when...' clause to the description text rather than relying on the separate when_to_use field, pushing completeness to the top anchor.

DimensionReasoningScore

Specificity

The description enumerates concrete actions: 'exhaust the brain's lookup chain: think → search + page read → mounted sources → timeline/graph → web', 'ask WITH a hypothesis, never a bare unknown', and 'pages created during bulk ingestion get their relationship/role resolved immediately' — comprehensive coverage of the skill's capabilities, matching the top anchor rather than the 'minor gaps' of a 4.

5 / 5

Completeness

The 'what' is explicit and multi-part (gate identity questions, run the lookup chain, escalate with a hypothesis, resolve placeholders at ingest), and a 'when' is present via 'Before any "who is X?" (or role / relationship question) reaches the user' — an equivalent trigger condition that clears the 3-cap. It is not a 5 because the explicit 'Use when...' phrasing with concrete trigger phrases lives in the separate when_to_use field rather than in the description itself.

4 / 5

Trigger Term Quality

Natural phrases like "who is X?", 'role / relationship question', 'placeholders', and 'bulk ingestion' are present, but common user variations ('who is this person', 'unidentified contact', 'unknown') appear only in the separate triggers field, not the description. Good coverage with a few natural terms missing — anchor 4, not 3 (keywords are relevant and naturally phrased, not generic) and not 5 (synonyms and variations are not included in the description text itself).

4 / 5

Distinctiveness Conflict Risk

'Gate on identity questions to the user' and the 'no-placeholders-at-ingest rule' define a clear, narrow niche — a decision gate on one class of question plus an ingest acceptance bar — with trigger conditions unique to this skill, so conflict risk with related lookup/asking skills is minimal.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 9 suspicious

Warning

Total

14

/

16

Passed

Repository

garrytan/gbrain

Path

plugin-variants/gbrain-coding/skills/resolve-before-asking/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.