CtrlK
BlogDocsLog inGet started
Tessl Logo

advogado-especialista

Advogado especialista em todas as areas do Direito brasileiro: familia, criminal, trabalhista, tributario, consumidor, imobiliario, empresarial, civil e constitucional.

45

Quality

47%

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

Quality

Content

50%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-intentioned progressive-disclosure router: concise, with clear trigger, anti-trigger, and limitations sections, delegating substance to a 1,100-line detailed guide. However, it delegates so completely that nothing in the body is directly actionable, and the bundle structure has real navigation gaps — an orphaned fontes.md and a broken cross-reference in the guide.

Suggestions

Add a brief inline quick-start (e.g., the first two steps of the guide's identification workflow, or one short worked example) so the skill is actionable before the full 1,100-line guide is loaded.

Link references/fontes.md from SKILL.md (e.g., a 'Sources' line in the Detailed Guide section) so the bundle's legislation-reference file is discoverable.

Fix or remove the `advogado-criminal/SKILL.md` pointer in references/detailed-guide.md (lines 196 and 233), since that path does not exist in this bundle.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no concept explanations, no padding, just a delegation instruction ("Read [the detailed guide](references/detailed-guide.md) before executing this skill") plus trigger and limitation sections. It falls short of anchor 5 only because the 'When to Use' list repeats the filler phrase 'or related topics' six times, which could collapse into one line; there is no verbosity approaching anchor 3's unnecessary explanation.

4 / 5

Actionability

The only executable directive in the body is to read the reference file; there is no inline quick-start, example, or concrete step for the actual task (legal analysis), so the body 'describes rather than instructs' with just a high-level pointer. This matches anchor 2 (high-level hints, missing specific steps to execute); it is above anchor 1 because the delegation path and trigger conditions are concrete, but below anchor 3-4 because nothing in the body itself is actionable without loading the guide.

2 / 5

Workflow Clarity

The body contains no sequence or validation checkpoints whatsoever — the multi-step legal workflow lives entirely in references/detailed-guide.md, so from the body alone the process is 'delegated but invisible.' This sits at anchor 3 (sequence present but checkpoints missing/implicit — here implicit via the reference); it is below anchor 4 because no step or checkpoint is surfaced in the body, and above anchor 2 because the delegation is unambiguous and the guide does carry a structured workflow. The skill is not destructive/batch, so no cap applies.

3 / 5

Progressive Disclosure

Scored against the actual bundle: SKILL.md is a clean overview pointing one level deep to a clearly signaled references/detailed-guide.md, but references/fontes.md (5KB of legislation sources) is never referenced from SKILL.md or the guide — an unreachable bundle file — and detailed-guide.md itself points to `advogado-criminal/SKILL.md`, a path that does not exist in this bundle (a broken second-level reference). This fits anchor 3 (some structure, but references not fully discoverable/organized); the orphaned file and dead pointer are more than the 'minor organization gaps' of anchor 4.

3 / 5

Total

12

/

20

Passed

Description

45%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 identifies a clear domain (Brazilian law across nine areas) but is a role claim rather than a capability statement: it lists no actions and includes no 'when to use' trigger guidance. Domain enumeration provides moderate keyword value, though everyday phrasings like divorcio, guarda, or processo are missing.

Suggestions

Add an explicit 'Use when...' clause with concrete trigger phrases, e.g. 'Use when the user asks about divorcio, guarda, pensao alimenticia, demandas trabalistas, or any Brazilian legal matter.'

Replace the role claim with 2-3 concrete actions, e.g. 'Analyzes legal questions, cites applicable Brazilian legislation and jurisprudence, and drafts petitions/opinions across family, criminal, labor...'.

Include natural synonyms and statute names users actually say (divorcio, inventario, CLT, CDC, Maria da Penha) to improve trigger-term coverage.

DimensionReasoningScore

Specificity

The description claims a role — "Advogado especialista em todas as areas do Direito brasileiro" — and lists nine domains ("familia, criminal, trabalhista, tributario, consumidor, imobiliario, empresarial, civil e constitucional"), but names zero concrete actions (e.g., analyze cases, cite legislation, draft petitions). This matches anchor 2 (domain named, actions minimal or generic); it does not reach anchor 3, which requires 1-2 concrete actions, and is above anchor 1 because the domain enumeration is specific, not pure abstraction.

2 / 5

Completeness

The 'what' is reasonably clear in scope (specialist coverage of nine named law areas) but there is no 'when' clause at all — no "Use when..." or equivalent trigger guidance in the description, which caps completeness at 3 per the judging guidelines. It is above anchor 2 because the 'what' is not vague (domains are enumerated), but below anchor 4 because 'when' is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

It includes some natural keywords a Brazilian user would say — "Advogado", "Direito brasileiro", and the area names "familia", "criminal", "trabalhista" — but misses the common variations and synonyms users actually lead with ("divorcio", "guarda", "pensao", "acao", "processo", "CLT", "CDC"). This fits anchor 3 (relevant keywords but missing common variations/synonyms); not anchor 4 because the everyday phrasings are largely absent, not just 'a few' missing.

3 / 5

Distinctiveness Conflict Risk

The Brazilian-law and Portuguese framing gives it a recognizable niche, but "todas as areas do Direito" (all areas of law) spans nine broad domains, creating overlap risk with any general legal-assistance or jurisdiction-specific skill. This matches anchor 3 (somewhat specific but could still overlap with similar skills); it is below anchor 4 because the 'all areas' breadth invites conflicts, and above anchor 2 because the Brazilian/Portuguese scope is far from generic.

3 / 5

Total

11

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
sickn33/agentic-awesome-skills
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.