CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

setup

Add keyless GBrain memory to an existing agent, or connect a hosted brain while preserving identity and configuration

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 ./skills/setup/SKILL.md
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.

The body is a well-engineered, high-signal setup workflow: concrete commands throughout, clearly sequenced phases with genuine validation and error-recovery feedback loops, and disciplined delegation to external guides. Its only structural weakness is that substantial branch-specific material (search-mode matrix protocol, Postgres modes, hosted alternative) is inlined rather than split into reference files.

DimensionReasoningScore

Conciseness

The body is dense, telegraphic, and high-signal with no explanations of concepts Claude already knows, but a few points are repeated across sections ('never replace existing memory to recover' appears in Phase 2, When it fails, and Anti-Patterns) and a couple of paragraphs (the Postgres mode note) could be tightened. This matches 'efficient; minor instances of over-explanation that could be trimmed' rather than the fully lean level 5.

4 / 5

Actionability

The main paths are fully executable with copy-paste commands ('bun install -g github:garrytan/gbrain#latest-stable', 'gbrain init --pglite --no-embedding', 'gbrain connect https://brain.example.com/mcp --harness codex --credentials-file /absolute/private/agent-example.json --install', 'gbrain doctor --json', 'gbrain mcp verify'), concrete paths, and explicitly named delegation targets for the remaining branches. This matches 'fully executable; copy-paste ready commands covering the common cases'; level 4 would require notable gaps that are not present.

5 / 5

Workflow Clarity

Phases 1-4 give a clear sequence (choose path, inspect/install/repair, attach instruction, verify) with explicit validation checkpoints — randomized write/readback, correction, withdrawal verification, cross-conversation recall check, and exit-code interpretation for 'partial' — plus an error-recovery table providing feedback loops. This matches the level-5 anchor for explicit validation steps with error-recovery feedback loops; it exceeds level 4, which tolerates missing checkpoints.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the body is well-sectioned with clearly signaled, one-level-deep links to sibling skills and external guides. However, ~227 lines of inline content — the search-mode matrix protocol, Postgres classic/managed mode rules, and the hosted alternative — would fit better in dedicated reference files. This matches 'good structure; references mostly clear; minor organization gaps' rather than the fully split level 5.

4 / 5

Total

18

/

20

Passed

Description

61%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, concrete 'what' with a distinctive product name, but it lacks any explicit 'when to use' guidance and misses several natural trigger phrasings (set up, install, persistent memory). Its 'connect a hosted brain' clause also blurs the boundary with the sibling mcp-access skill.

Suggestions

Append a 'Use when...' clause to the description, e.g. 'Use when the user asks to set up, initialize, or add GBrain memory to an agent, or connect an existing hosted brain.'

Include more natural trigger variations in the description itself — 'set up', 'install', 'persistent memory', 'recall' — so users phrasing the request differently still match.

Sharpen the boundary with sibling skills: make clear this is the initial-setup entry point (delegating hosted connections to mcp-access) rather than both setup and hosted connection.

DimensionReasoningScore

Specificity

The description names the domain ('GBrain memory') and two concrete actions ('Add keyless GBrain memory to an existing agent', 'connect a hosted brain') plus a preservation constraint, but omits other core capabilities of the skill (installation, verification, search-mode selection). This matches the anchor for naming the domain with 1-2 concrete actions without comprehensive coverage, and falls short of level 4 which requires several specific actions.

3 / 5

Completeness

The 'what' is clearly stated (add keyless memory to an existing agent, or connect a hosted brain), but there is no 'Use when...' clause or equivalent explicit trigger guidance in the description field, which caps completeness at 3 per the judging guidelines. It is not level 4 because the 'when' is entirely absent rather than merely implicit.

3 / 5

Trigger Term Quality

It includes good natural keywords a user would say — 'GBrain memory', 'agent', 'connect a hosted brain', 'identity' — but misses common variations like 'set up', 'install', 'persistent memory', or 'recall'. Coverage is good with a few natural terms missing, matching the level-4 anchor; it is not level 5 because synonyms and setup/install phrasings are absent from the description itself.

4 / 5

Distinctiveness Conflict Risk

The named product 'GBrain' and phrases like 'keyless GBrain memory' establish a clear niche with minimal conflict against unrelated skills, but 'connect a hosted brain' overlaps the territory of the sibling mcp-access skill referenced in the body. This is mostly distinct with minor overlap risk against a closely related skill, matching level 4 rather than the minimal-conflict level 5.

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

Warning

Total

14

/

16

Passed

Repository

garrytan/gbrain

Path

skills/setup/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.