advogado-especialista
Advogado especialista em todas as areas do Direito brasileiro: familia, criminal, trabalhista, tributario, consumidor, imobiliario, empresarial, civil e constitucional.
30
24%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/antigravity-awesome-skills-claude/skills/advogado-especialista/SKILL.mdQuality
Discovery
22%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This description is essentially a role declaration ('specialist lawyer') rather than a skill description. It lists legal domains but fails to specify concrete actions the skill performs and entirely lacks trigger guidance for when Claude should select it. The use of first-person framing ('Advogado especialista') rather than third-person action verbs further weakens it.
Suggestions
Replace the role declaration with concrete actions in third person, e.g., 'Analisa questões jurídicas, redige petições, elabora pareceres, e orienta sobre legislação brasileira nas áreas de família, criminal, trabalhista, tributário, consumidor, imobiliário, empresarial, civil e constitucional.'
Add an explicit 'Use when...' clause with natural trigger terms, e.g., 'Use when the user asks about Brazilian law, legal advice, petições, contratos, processos judiciais, direitos do consumidor, or mentions specific Brazilian legislation like CLT, CDC, or Código Civil.'
Include action-oriented keywords users would naturally say, such as 'petição inicial', 'recurso', 'contrato', 'consulta jurídica', 'legislação', 'jurisprudência', to improve trigger term coverage.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description only states the skill is a 'specialist lawyer in all areas of Brazilian law' and lists legal domains, but does not describe any concrete actions (e.g., draft petitions, analyze contracts, review case law). Listing areas of law is not the same as listing capabilities. | 1 / 3 |
Completeness | The description partially answers 'what' (specialist in Brazilian law areas) but very weakly, and completely lacks any 'when should Claude use it' guidance. There is no 'Use when...' clause or equivalent trigger guidance. | 1 / 3 |
Trigger Term Quality | It includes some relevant domain keywords like 'família', 'criminal', 'trabalhista', 'tributário', 'consumidor', 'imobiliário', 'empresarial', 'civil', 'constitucional' that users might mention, but lacks natural trigger phrases users would actually say (e.g., 'petição', 'contrato', 'processo', 'consulta jurídica'). Also missing file types or action-oriented terms. | 2 / 3 |
Distinctiveness Conflict Risk | The focus on Brazilian law ('Direito brasileiro') provides some distinctiveness, but the extremely broad scope ('all areas') and lack of specific actions means it could overlap with any general legal or writing skill. | 2 / 3 |
Total | 6 / 12 Passed |
Implementation
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is essentially a Brazilian legal encyclopedia dumped into a single SKILL.md file, containing extensive reference tables of laws, penalties, and jurisprudence that Claude already has knowledge of. While the 12-step case analysis workflow and parecer template provide some useful structure, the overwhelming majority of content is verbose reference material that wastes context window tokens. The skill would benefit enormously from being split into separate reference files with a concise overview in SKILL.md.
Suggestions
Reduce SKILL.md to a concise overview (under 100 lines) with the routing table, 12-step workflow, parecer template, and restrictions—move all legal reference tables (Modules 1-14, sumulas, prazos) into separate bundle files like FAMILIA.md, CRIMINAL.md, CONSUMIDOR.md, etc.
Remove the self-aggrandizing persona description ('Jurista de nivel supremo', '30+ anos') and the generic best practices/common pitfalls boilerplate—these waste tokens without adding actionable value.
Add concrete examples showing how to apply the 12-step workflow to a real case scenario (e.g., a sample divorce case analysis with filled-in parecer template) rather than just listing abstract legal references.
Add validation checkpoints to the 12-step workflow, such as 'If client has not provided X document, stop and request it before proceeding to Step 5' to prevent incomplete analyses.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | This skill is extremely verbose at 700+ lines, containing encyclopedic legal reference material that Claude already knows (Brazilian law codes, article numbers, penalty ranges, jurisprudence summaries). The introductory section wastes tokens with self-aggrandizing persona descriptions ('Jurista de nivel supremo', '30+ anos de atuacao'). Most of the content is a legal textbook dump rather than actionable skill instructions. | 1 / 3 |
Actionability | The 12-step workflow template and the final parecer template provide some concrete, structured guidance. However, the vast majority of content is reference tables listing laws and penalties rather than executable instructions. There are no concrete examples of how to actually analyze a case or produce output—just abstract frameworks and legal encyclopedic data. | 2 / 3 |
Workflow Clarity | The 12-step case analysis workflow is clearly sequenced and provides a useful framework with a structured output template. However, it lacks validation checkpoints or feedback loops—there's no guidance on what to do if information is missing at a given step, no verification steps, and no error recovery. The initial routing table (Module 1-14) references modules that are just inline sections rather than a clear decision tree. | 2 / 3 |
Progressive Disclosure | This is a monolithic wall of text with 700+ lines of inline content that should be split across multiple files. The skill references external skills like 'advogado-criminal' but dumps 14 modules of detailed legal reference material directly into the SKILL.md. There's no meaningful separation between overview and detailed content—everything is crammed into one file with no bundle files to support progressive disclosure. | 1 / 3 |
Total | 6 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (1115 lines); consider splitting into references/ and linking | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
- Repository
- sickn33/antigravity-awesome-skills
- Commit
22710e9
- 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.