CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

brain-ingest-gate

Pre-write quality gate for content entering the brain. No raw copies: a bare cp/mv into the brain repo is a bug. Before any new page lands, resolve named entities registry-first (a vector score is a floor for prose, never a gate for named things), then run the read-the-top-hit dedup decision tree (clear-dup / plausible-dup / clear). Owns dedup; delegates enrichment to the shipped ingestion skills. Routing convention, not an operation-boundary enforcement.

Quality

78%

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/skills/brain-ingest-gate/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 exceptionally actionable, well-sequenced gate specification: concrete gbrain commands at every step, an explicit decision tree, dedup-skip carve-outs, verification with a recovery loop, and clear delegation boundaries. Its main weaknesses are repetition (the vector-score rule stated three times, a Contract section that restates the body) and its monolithic length when a couple of sections could be split into reference files.

DimensionReasoningScore

Conciseness

The body is dense with genuinely non-obvious, gbrain-specific rules (native pipeline dedup limits, fused-score warning, write_pending exit 10), but it repeats itself: the 'vector score is a floor for prose, never a gate for named things' point is made three times (The Rule, the Named-Entity Gate intro, rule 3), and the Contract section fully restates body rules while admitting 'this section exists for the conformance test'. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') better than anchor 4's 'minor instances'.

3 / 5

Actionability

Fully executable commands are given for every step: 'gbrain entity "<name>"', 'gbrain query "<name>" --limit 3', 'gbrain search "<core claim>" --limit 5', 'gbrain get <slug>', 'gbrain link' / 'gbrain timeline-add', and the verification trio (check-backlinks check, backlinks <new-slug>, re-search). The band table, decision tree, and a filled-in output-format example cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

The two-gate sequence is explicit and ordered (Named-Entity Resolution Gate 'runs FIRST', Dedup Gate 'runs SECOND'), an ASCII decision tree encodes the full flow, and the batch/destructive-adjacent operation has both a trial-first reference ('gate 3-5 items and inspect the decisions') and a Verification section with a feedback loop ('If check-backlinks check reports gaps... route back through enrich before declaring the ingest done'). This matches anchor 5: clear sequence, explicit validation, error-recovery loop.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so all guidance is inline; the body compensates with a clear Owns-vs-Delegates table and clearly signaled one-level-deep links to sibling skills and conventions (../conventions/brain-first.md, ../enrich/SKILL.md, etc.), all of which are path-relative references rather than shipped bundle files. At ~290 lines with a sharp-boundaries comparison section and a self-admitted duplicate Contract section that could live in separate reference files, this sits at anchor 4 ('good structure; most content appropriately placed; minor organization gaps') rather than 5's 'content appropriately split'.

4 / 5

Total

17

/

20

Passed

Description

67%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 highly specific, well-bounded description that clearly states what the gate does and how it differs from sibling ingestion skills, but it omits explicit 'use when' trigger guidance and the natural user phrases from its text — those live only in separate frontmatter fields. The internal jargon ('read-the-top-hit dedup decision tree') is precise but not user-phrased.

Suggestions

Append an explicit 'Use when...' sentence to the description field itself, e.g. 'Use when the user asks to move, migrate, or copy files into the brain, or to check whether something is already in the brain before writing.'

Fold the natural trigger phrases ('move this to brain', 'migrate to brain', 'is this already in the brain') into the description text so the natural keywords surface during skill matching, not only in the separate when_to_use field.

Soften one jargon-dense phrase ('the read-the-top-hit dedup decision tree') to plainer wording so a user-facing match on 'check for duplicates before writing' is more likely.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with comprehensive coverage of the gate's scope: 'resolve named entities registry-first', 'run the read-the-top-hit dedup decision tree (clear-dup / plausible-dup / clear)', 'Owns dedup; delegates enrichment to the shipped ingestion skills'. Anti-drift check against anchor 4 ('minor gaps in coverage'): coverage of what the gate does (entity resolution, dedup bands, delegation boundary) is complete, so 5 fits better than 4.

5 / 5

Completeness

The 'what' is clear and concrete ('Pre-write quality gate for content entering the brain', resolve named entities, run the dedup decision tree), but the description field itself contains no 'Use when...' clause or equivalent explicit trigger guidance — the when-guidance is only in the separate when_to_use field. Per the judging guideline, a missing 'Use when...' clause caps completeness at 3, matching anchor 3 ('clear what but when is missing or only weakly implied').

3 / 5

Trigger Term Quality

Relevant keywords present include 'content entering the brain', 'a bare cp/mv into the brain repo', and 'dedup decision tree', but the natural phrases a user would actually say ('move this to brain', 'migrate to brain', 'copy these files into the brain', 'is this already in the brain') live in the separate when_to_use/triggers fields, not the description. This matches anchor 3 ('some relevant keywords but missing common variations or synonyms') rather than anchor 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche and explicitly draws the boundary against sibling skills: 'Owns dedup; delegates enrichment to the shipped ingestion skills', and the dedup band vocabulary (clear-dup / plausible-dup / clear) is unique to this gate. Anti-drift check against anchor 4 ('minor overlap risk with closely related skills'): the explicit owns/delegates sentence resolves the overlap risk, so 5 fits.

5 / 5

Total

16

/

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: 17 suspicious

Warning

Total

14

/

16

Passed

Repository

garrytan/gbrain

Path

plugin/skills/brain-ingest-gate/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.