CtrlK
BlogDocsLog inGet started
Tessl Logo

cerebro-creation

Implement focused Cerebro issues or PR follow-ups from Droid Create workflows.

77

0.97x
Quality

66%

Does it follow best practices?

Impact

96%

0.97x

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-creation/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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-organized instruction sheet that respects the token budget and encodes genuinely non-obvious project constraints (Go package boundaries, Makefile flow, CI-side commit handling, stop conditions). Its main weakness is actionability: the test-running and verification steps reference commands and criteria without giving the concrete command forms or failure-handling guidance needed to be fully executable.

Suggestions

Replace 'Run targeted tests first' with a concrete example command (e.g., `go test ./source/... -run TestName`) so the step is executable rather than descriptive.

Clarify the 'when feasible' hedge on `make verify` — state when it should be skipped, or make it unconditional with an explicit fallback.

Add a brief feedback loop for step 5: what to do when targeted tests or `make verify` fail (fix, re-run, then stop conditions apply).

DimensionReasoningScore

Conciseness

The body is lean and efficient: six numbered instructions and two stop conditions, with no explanation of concepts Claude already knows and no padding. Every line adds project-specific constraint ('Match existing Go package boundaries... Makefile validation flow', 'Leave changes in the working tree; CI handles commit, push, and PR creation'), matching the anchor-5 example of 'every token earns its place'.

5 / 5

Actionability

Guidance is partially concrete — 'Run targeted tests first, then `make verify` when feasible' names a real command, and 'Leave changes in the working tree' is executable — but 'Run targeted tests' is unspecified (no example command like `go test ./pkg/...`), and 'when feasible' is a hedge that leaves the executor guessing. This lands at anchor 3 ('some concrete guidance but incomplete... missing key details') rather than 4, which requires mostly executable guidance with only minor gaps.

3 / 5

Workflow Clarity

The six-step sequence is clear and ordered (read context → identify change → match patterns → add tests → run tests then `make verify` → leave in working tree), with validation embedded in step 5 and explicit stop conditions as guardrails. It is not 5 because there is no feedback loop for what to do when tests or `make verify` fail, and 'when feasible' weakens the validation checkpoint — anchor 4 ('clear sequence with most checkpoints present; minor validation gaps').

4 / 5

Progressive Disclosure

This is a simple, single-purpose skill under 50 lines with no bundle files (no references/, scripts/, or assets/ exist) and no need for external references. Per the simple-skills scoring note, it qualifies for 5 with just well-organized sections — which it has ('Instructions' and 'Stop Conditions' are clearly separated and easy to navigate).

5 / 5

Total

17

/

20

Passed

Description

53%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, moderately specific 'what' anchored in distinct project-specific terms, but entirely lacks a 'when to use this' clause and offers thin natural-language trigger coverage. It reads as a terse internal label rather than a self-contained description.

Suggestions

Add an explicit trigger clause, e.g. 'Use when a Cerebro issue is assigned or a Droid Create PR needs a follow-up change.'

Enumerate one or two more concrete actions (e.g., 'read the issue thread, make the smallest production-quality change, add focused tests') to raise specificity.

Include natural trigger variations users would actually say, such as 'implement issue', 'address PR feedback', or 'fix failing checks'.

DimensionReasoningScore

Specificity

The description names a concrete domain ("Cerebro issues or PR follow-ups from Droid Create workflows") and one concrete action ("Implement focused... issues"), but stops there — anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') fits. It does not reach anchor 4 because it lists no secondary actions (e.g., reading reviews, adding tests, running validation), and it is above anchor 2 because the domain and primary action are explicitly stated rather than generic.

3 / 5

Completeness

The 'what' is clear — implement focused issues/PR follow-ups — but there is no 'Use when...' clause or equivalent explicit trigger guidance, so per the judging guidelines completeness is capped at 3. It fits anchor 3 ('has a clear what but when is missing or only weakly implied'); the implicit 'when' (when a Cerebro issue or Droid Create PR follow-up arrives) is not stated.

3 / 5

Trigger Term Quality

It includes some relevant keywords a user might echo ("issues", "PR follow-ups", "Cerebro", "Droid Create"), but misses common variations and synonyms (e.g., 'implement an issue', 'address PR feedback', 'fix a failing check'). This matches anchor 3 ('some relevant keywords but missing common variations or synonyms') — not 4, since natural phrasing coverage is thin, and not 2, since the terms present are domain-relevant rather than purely generic.

3 / 5

Distinctiveness Conflict Risk

The niche is mostly distinct — 'Cerebro' and 'Droid Create' are project-specific nouns that few other skills would claim, and 'issues/PR follow-ups' scopes it narrowly. It is not 5 because 'Implement... issues' could still overlap with general issue-implementation or code-review skills in the same repo; it is above 3 because the internal tool names provide a strong distinguishing signal.

4 / 5

Total

13

/

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.