CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

signal-detector

Opt-in ambient signal capture. After explicit enablement, applies on substantive inbound messages to detect original thinking and entity mentions. Use an authorized sub-agent where supported; otherwise detect inline. Aim to never block the main response.

Quality

69%

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 ./plugin-variants/gbrain-coding/skills/signal-detector/SKILL.md

The canonical home for this skill is signal-detector in garrytan/gbrain

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, largely actionable instruction skill with clear phases, concrete gbrain commands, exact formats, and thoughtful failure handling for a consent-sensitive ambient process. Its main weaknesses are redundant restatement of the authorization rules across five sections, undefined notability criteria, and dangling external references that break navigation.

Suggestions

Consolidate the consent/opt-in rules into a single section — they are currently repeated in 'Contract', 'Enablement before capture', 'Per-User Storage Policy', 'When it fails', and 'Anti-Patterns' — and replace the slogan lines ('An unlinked mention is a broken brain') with the operative rule only.

Fix or inline the dangling references: neither 'skills/conventions/quality.md' nor '../conventions/agent-operator-protocol.md' exists in this bundle; either ship them or inline the relevant error-handling steps.

Define the notability criteria for entity creation (Phase 2 currently says only 'If notable, save the supplied information') and specify the page structure to write, so the capture steps are fully executable.

DimensionReasoningScore

Conciseness

Mostly efficient with concrete commands, but the consent/authorization rules are restated across 'Contract', 'Enablement before capture', 'Per-User Storage Policy', 'When it fails', and 'Anti-Patterns', and slogan lines ('Ideas are the intellectual capital. Entities are bookkeeping.', 'An unlinked mention is a broken brain.') pad the token budget. Matches 'mostly efficient but includes some unnecessary explanation or could be tightened' — the padding is repetition rather than explanation of known concepts, so above 2 but below 4.

3 / 5

Actionability

Concrete executable guidance throughout: 'gbrain search "name"', 'gbrain timeline-add <slug> <date> "<summary>"', exact back-link format '- **YYYY-MM-DD** | Referenced in [page title](path) — brief context', page paths like 'originals/{slug}', and signal-log line formats. Minor gaps keep it from 5: notability criteria are undefined ('If notable, save...') and the structure of pages to write is unspecified.

4 / 5

Workflow Clarity

Phases are clearly sequenced (idea detection → entity handling with search/thin/rich branches → signal logging) with skip conditions, explicit failure handling ('write_pending ... exit 10 ... poll the receipt or re-read and merge on the next turn'), and a readback verification checkpoint ('verify captured content with an actual readback'). Not 5: validation is mentioned but not woven into an explicit fix-and-retry loop; not 3: checkpoints and error recovery are explicit.

4 / 5

Progressive Disclosure

Well-sectioned single file, but both referenced paths ('skills/conventions/quality.md', '../conventions/agent-operator-protocol.md') are dangling — neither exists in this bundle — and the Iron Law back-link procedure and the long 'memory.auto_writeback'/Stop-hook paragraph are inlined detail that belongs in reference files. Some structure and organization, but broken references and inline bulk prevent a 4.

3 / 5

Total

14

/

20

Passed

Description

62%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 clearly defines a niche opt-in capability with an explicit enablement condition, but it undersells the skill's concrete actions (page creation, enrichment, back-linking, timeline logging) and lacks the natural user-facing trigger phrasings that would make it discoverable. It reads more like an internal contract summary than a user-facing trigger description.

Suggestions

Add the concrete write actions to the description (create/enrich brain pages, back-links, timeline entries) so specificity reflects what the skill actually does, e.g. 'Captures the user's original thinking verbatim and creates/enriches brain pages for mentioned people, companies, and concepts, with back-links and timeline entries.'

Include natural user trigger phrasings users would actually say — e.g. 'remember my ideas', 'capture what I'm saying', 'note this person/company' — instead of only jargon terms like 'ambient signal capture'.

Append an explicit 'Use when...' clause with concrete trigger conditions (e.g. 'Use when the user has enabled automatic capture and sends a substantive message containing ideas, observations, or entity mentions.') to reach full completeness.

DimensionReasoningScore

Specificity

Names the domain ('ambient signal capture') and two detection actions ('detect original thinking and entity mentions', 'use an authorized sub-agent ... otherwise detect inline'), but omits the concrete write actions the skill performs (create/enrich brain pages, back-links, timeline entries). This matches 'names domain and 1-2 concrete actions, but not comprehensive' rather than score 4's 'several specific actions; minor gaps'.

3 / 5

Completeness

Both 'what' (detect original thinking and entity mentions) and 'when' ('After explicit enablement, applies on substantive inbound messages') are explicitly stated. Not 5 because the when-clause states a precondition/state rather than a concrete user trigger phrase, and not 3 because the when is explicit, not merely implied.

4 / 5

Trigger Term Quality

Terms like 'ambient signal capture', 'original thinking', and 'entity mentions' are somewhat relevant but jargon-leaning; natural user phrasings ('remember my ideas', 'capture what I say', 'brain capture') and synonyms are missing. Some relevant keywords but missing common variations, so not 4; more than one or two generic keywords, so above 2.

3 / 5

Distinctiveness Conflict Risk

The opt-in ambient brain-capture niche with sub-agent routing is mostly distinct with a clear trigger condition, with only minor overlap risk against general memory/note-taking skills. Not 5: 'signal capture' and 'entity mentions' could still collide with memory or note-taking skills.

4 / 5

Total

14

/

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: 1 missing, 1 suspicious

Warning

Total

14

/

16

Passed

Repository

garrytan/gbrain

Path

plugin-variants/gbrain-coding/skills/signal-detector/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.