CtrlK
BlogDocsLog inGet started
Tessl Logo

cerebro-source-integration

Scaffold Cerebro source integrations following existing source, preview, runtime, and test patterns.

80

1.21x
Quality

71%

Does it follow best practices?

Impact

95%

1.21x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.factory/skills/cerebro-source-integration/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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 lean, well-structured instruction skill: no wasted tokens, concrete guidance, a clear sequenced workflow with verification, and clean organization. The main gaps are the absent fix-and-retry loop after test failures and the lack of any example or template pointer to make the first step fully executable.

Suggestions

Add an explicit feedback loop after verification, e.g. "If focused tests or `make verify` fail, fix the issues and re-run before proceeding" — this would lift workflow_clarity to 5.

Make step 1 more executable by naming how to identify the closest integration (e.g. a glob like `ls sources/*/` or a short criterion for matching by protocol/type), removing the remaining guesswork.

DimensionReasoningScore

Conciseness

The body is ~20 lines of pure instruction with zero padding — every line directs an action ("Implement config parsing with safe defaults, strict validation, and clear error mapping", "Run focused source package tests, then `make verify`"). No concepts Claude already knows are explained, matching anchor 5 ("lean and efficient; assumes Claude's competence; every token earns its place").

5 / 5

Actionability

This is an instruction-only skill and the guidance is concrete: it names the template location (`sources/`), specific test categories ("config validation, preview decoding, pagination, and error handling"), specific threats ("loopback, unsafe schemes, malformed URLs, unbounded responses, and pagination loops"), and an executable command (`make verify`). It falls short of anchor 5 only because no example integration, file layout, or command for scaffolding is given, leaving minor gaps in executable detail.

4 / 5

Workflow Clarity

The six numbered steps give a coherent sequence (find template → implement config → add preview/runtime → harden network settings → write tests → run tests and `make verify`), with validation present in steps 5-6. It misses anchor 5 because there is no explicit feedback loop — nothing says "fix failures and re-run" after tests or verify fail — though the scaffolding context is not destructive/batch so the score-3 cap does not apply.

4 / 5

Progressive Disclosure

The skill is under 50 lines, needs no external references (none exist in the bundle), and is organized into two clearly labeled sections ("Instructions", "Boundaries"). Per the rubric's guideline for such skills, well-organized sections alone merit anchor 5.

5 / 5

Total

18

/

20

Passed

Description

57%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 is concise, third-person, and highly distinct, but it only states what the skill does without any "Use when..." trigger guidance, which both caps completeness and weakens trigger-term coverage. A user or Claude deciding when to invoke it must infer the trigger from the noun phrase alone.

Suggestions

Add an explicit trigger clause, e.g. "Use when adding a new data source or connector to Cerebro, or when the user asks to integrate a new feed/endpoint."

Include natural synonyms and variations users would actually say — "add a source", "connector", "data feed", "wire up an endpoint" — alongside "source integrations" to broaden trigger-term coverage.

Optionally name the concrete deliverables (config parsing, preview handler, runtime sync, package tests) in the description to lift specificity from one action to several.

DimensionReasoningScore

Specificity

"Scaffold Cerebro source integrations" names the domain and one concrete action, and "source, preview, runtime, and test patterns" enumerates the pattern areas, but it stops short of listing multiple concrete actions like the anchor-5 examples ("extract text", "fill forms", "merge documents"). It sits above score 2 (which would be a generic action with no pattern detail) and below score 4 (which would list several distinct executable capabilities).

3 / 5

Completeness

The "what" is clear — scaffolding Cerebro source integrations — but there is no "Use when..." clause or equivalent explicit trigger guidance, so per the judging guidelines completeness is capped at 3. It is above score 2 because the "what" is concrete rather than vague, but below score 4 because "when" is entirely absent rather than merely implicit or incomplete.

3 / 5

Trigger Term Quality

Relevant keywords are present — "Cerebro", "source integrations", "scaffold" — but natural user phrasings such as "add a new data source", "connector", or "hook up a feed" are missing, and there are no synonyms or variations of the trigger terms. This matches anchor 3 ("some relevant keywords but missing common variations or synonyms"), not anchor 4 which would require broader natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

"Cerebro source integrations" carves out a clear niche with distinct terms ("Cerebro", "source", "integration", "scaffold") that virtually no other skill would claim, giving minimal conflict risk. It clearly matches anchor 5 ("clear niche with distinct triggers; minimal conflict risk") rather than anchor 4, which presumes overlap risk with closely related skills.

5 / 5

Total

14

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
writer/cerebro
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.