CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

brave-breakdown

Use this skill to guide a developer or designer through a BRAVE framework breakdown of a task before they start work. Trigger whenever someone wants to think through a ticket, break down a card, plan their approach before starting, validate a task before picking it up, or prepare a breakdown to share with a teammate or client. Also trigger for any of these phrases or close variations: "BRAVE this", "brave it", "break down this card", "think through this ticket", "help me plan this out before I start", "want to make sure I understand this before I start coding", "want to revalidate this card", "help me think through this before my standup/meeting", or "I'm about to pick up a card and want to break it down". If someone mentions starting work on a card and wants help planning, validating, or understanding it first — this skill should run.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 well-crafted instruction-only skill: the three-phase conversation workflow is explicitly sequenced with confirmation checkpoints and feedback loops, guidance is concrete down to tool names, numeric rules, and an output template, and detail is properly pushed to three well-signaled, one-level-deep reference files that all exist. The only flaw is minor — a few framing sentences are restated and could be trimmed for token efficiency.

DimensionReasoningScore

Conciseness

The body is efficient, directive instruction with no filler explaining concepts Claude already knows, but a handful of motivational sentences restate the same idea — "not as a checklist, but as a genuine conversation that surfaces assumptions" and the "confident sharing with a senior teammate or client" framing appear in near-duplicate form across the intro and the breakdown section, and could be trimmed. It is noticeably above the mostly-efficient-with-unnecessary-explanation anchor, but not lean enough that every token earns its place.

4 / 5

Actionability

For an instruction-only skill the guidance is fully concrete and executable: exact MCP tool names (mcp__claude_ai_Linear__get_issue, list_issues filtered by projectId), a literal question to ask ("What's the most useful context for me to have before we dig in..."), per-phase question examples, a numeric buffer rule (add 15%, scale up for 32+ point cards), and a copy-paste-ready markdown template for the output document. Per the rubric's scoring notes, the absence of code is not penalized when the guidance is this actionable.

5 / 5

Workflow Clarity

The three phases (Get Oriented, Brainstorm, Reflect via AVE) are clearly sequenced with explicit validation checkpoints and feedback loops: summarize the card and "ask the user if that framing sounds right before continuing", "always ask one question at a time. Wait for the response, reflect back", and after producing the document "ask if anything feels off or incomplete". This is conversational rather than destructive/batch work, so the missing-validation cap does not apply, and the explicit confirm-reflect-review loop matches the top anchor.

5 / 5

Progressive Disclosure

The body is a clear orchestration overview that points to three real, one-level-deep reference files, each well-signaled with its purpose and load timing — brave-framework.md "before beginning", estimating.md "during the Estimate phase", brave-craftsmanship.md for calibrating to the developer's level. All three files exist in the bundle, none reference further files, and the content is appropriately split: procedural orchestration inline, framework detail and the point scale in references.

5 / 5

Total

19

/

20

Passed

Description

86%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 strong description with an explicit what, an explicit when, and unusually thorough natural-language trigger coverage including colloquial variations. The main weaknesses are a thin enumeration of concrete capabilities (one composite action) and slight overlap risk with generic planning skills.

DimensionReasoningScore

Specificity

The description names its domain and one composite action — "guide a developer or designer through a BRAVE framework breakdown of a task before they start work" — with sub-clauses like "prepare a breakdown to share with a teammate or client" adding only 1-2 concrete actions. It does not enumerate several distinct capabilities the way the score-4/5 anchors do; most of the remaining text is trigger phrasing rather than what the skill concretely does.

3 / 5

Completeness

It explicitly answers both what ("guide a developer or designer through a BRAVE framework breakdown of a task before they start work") and when ("Trigger whenever someone wants to think through a ticket, break down a card..." plus concrete quoted trigger phrases), matching the anchor for a clear and explicit what-and-when with concrete trigger phrases.

5 / 5

Trigger Term Quality

The description explicitly lists natural user phrases and close variations — "BRAVE this", "brave it", "break down this card", "think through this ticket", "help me plan this out before I start", "want to revalidate this card", "I'm about to pick up a card and want to break it down" — achieving comprehensive coverage of the natural terms a user would say, with a supporting triggers metadata field as well.

5 / 5

Distinctiveness Conflict Risk

The BRAVE/card-breakdown framing is a clear niche with distinct triggers like "BRAVE this" and "break down this card", but broadly worded triggers such as "help me plan this out before I start" overlap with generic planning or scaffolding skills, leaving minor conflict risk with closely related skills rather than minimal.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

RoleModel/rolemodel-skills

Path

skills/brave-breakdown/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.