CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bob-check

Rodar `bob check`, ler o JSON e iterar até exit 0. Use ao verificar um diff, antes de abrir ou atualizar um PR, ou quando um gate falhar.

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

73%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 highly actionable with a crystal-clear exit-code-driven iteration loop and concrete commands throughout. Its main defect is token efficiency: the same facts (gate defaults, exit-4 semantics, the usage-error signature) are repeated two or three times, inflating the skill without adding information.

Suggestions

State the usage-error signature (stderr starts with `usage: bob`, contains `error:`, no baseline mention) exactly once — in the Exit codes section — and have steps 1 and 5 reference it instead of restating it verbatim.

Delete one of the two adjacent statements of the hook/CI gate defaults (the prose sentence or the bullet list).

Merge the two consecutive exit-4 descriptions into a single entry covering both configuration/tool errors and CLI misuse.

DimensionReasoningScore

Conciseness

Several passages are duplicated verbatim: the local-hook/CI gate defaults are stated twice back-to-back ("Por padrão, o hook local roda `bob check --gates crap,dry,deps`... O CI roda..." followed by a bullet list repeating both commands), exit-4 is described twice in consecutive lines ("erro de configuração ou ferramenta ausente" then "O `4` é erro de configuração ou ferramenta ausente..."), and the `usage: bob` stderr signature appears three times (Exit codes section plus steps 1 and 5), as does "Não é o exit 2". This is noticeably more than minor tightening; not score 1 because there is no padding with concepts Claude already knows.

2 / 5

Actionability

The Invocar block gives the full CLI signature with all flags, and remediation is copy-paste ready ("bob waive <file::function|Target> --reason \"texto de uma linha\"", "bob doctor", "bob check --format both"). Exact report paths (.bob/report.json) and the meaning of each verdict symbol make the guidance fully executable.

5 / 5

Workflow Clarity

The Iterar section is a numbered loop keyed to exit codes, each with an explicit done-condition ("Feito quando o check é reexecutado") and concrete remediation, plus an overall completion criterion ("bob check sai com `0`"). This is a textbook validate→fix→rerun feedback loop.

5 / 5

Progressive Disclosure

A single-file skill with no bundle directories and well-sectioned headers (Quando, Invocar, Exit codes, Ler o JSON, Iterar); all content is appropriately inline. Not 5 because the body slightly exceeds the simple-skill length allowance, carries redundancy that hurts organization, and cites "docs/exit-codes.md#exit-4" which is not part of any bundle.

4 / 5

Total

16

/

20

Passed

Description

87%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 compact and well-formed: concrete actions, an explicit "Use quando" trigger clause, and a clear niche around the `bob` CLI. Its only weakness is that capability coverage stops at "iterar até exit 0" without hinting at the fix/waive remediation loop.

Suggestions

Name one remediation capability in the description, e.g. "corrigir o que o veredito nomeia ou aplicar waivers" after "ler o JSON", so the what covers the full loop.

Add one or two natural synonyms such as "mutation testing" or "code quality gates" to broaden trigger coverage.

DimensionReasoningScore

Specificity

"Rodar `bob check`, ler o JSON e iterar até exit 0" lists several concrete actions (run the CLI, read the JSON verdict, iterate to exit 0), but the remediation half of the loop (fixing gates, waiving mutants) is only implied by "iterar", leaving minor gaps in coverage.

4 / 5

Completeness

Explicitly answers both what ("Rodar `bob check`, ler o JSON e iterar até exit 0") and when ("Use ao verificar um diff, antes de abrir ou atualizar um PR, ou quando um gate falhar") with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

"verificar um diff", "abrir ou atualizar um PR", "quando um gate falhar", plus the command name `bob check`, are phrases a user would naturally say. Missing common synonyms such as quality checks, mutation testing, or coverage terms, so not comprehensive.

4 / 5

Distinctiveness Conflict Risk

Anchored to the `bob` CLI niche with distinct triggers (gates, exit codes, PR verification); it is clearly distinguishable from generic lint/test skills and unlikely to fire for the wrong skill. Voice is third person (infinitives), so no voice penalty applies.

5 / 5

Total

18

/

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

fazedordecodigo/bob

Path

skills/bob-check/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.