Content
92%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
An exemplary operational skill body: concrete script-level guidance for every common operation, a mandatory chaining order with rationale, lossless-first and verification gates baked into the workflow, and an appropriate split between the inline overview table and a verified one-level-deep catalog reference. The only room for improvement is trimming a few explanatory rationale sentences.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with tables, rules, and operational guidance with virtually no teaching of concepts Claude already knows (no 'what is FFmpeg' or 'how codecs work' filler). Minor trimmable over-explanations remain ("Razão prática: mudanças de frame (color, cut, fit) precisam acontecer antes de legenda/overlay, porque texto posicionado antes de um crop/pad fica com tamanho ou posição errados" and "cada reencode desnecessário degrada qualidade e multiplica tempo de processamento"), matching anchor 4 rather than the every-token-earns-its-place level of 5. | 4 / 5 |
Actionability | A 22-row intent→script→flags table with concrete flags (--start, --end, --accurate, --fit pad|crop|blur, -I <LUFS>, --tp), a copy-paste command with expected structured output ("python scripts/loudness.py video.mp4 -I -14 --tp -1 --json" → measured_lufs_before/after), CRF 18 for intermediate reencodes, and a preset table with concrete LUFS/aspect values. The common cases are fully executable; only long-tail scripts get vague hints ("(parâmetros de suavização)"). | 5 / 5 |
Workflow Clarity | A 5-step protocol with a prescribed chaining order (color/look → cut → join → silence → fit → caption/overlay → sync → audio → loudness → export), explicit validation gates (--dry-run, "Confiar no --json, nunca num número resumido em texto solto", "rodar verify.py/check.py no arquivo final antes de considerar a tarefa concluída"), an error-multiplication guard ("Batch (batch.py) só depois de validar em 1 arquivo"), and an "Evidencia de Conclusao" checklist. Validation is present, so the destructive/batch cap does not apply. | 5 / 5 |
Progressive Disclosure | The body keeps a 22-row overview table inline and defers the full 42-script catalog to references/catalogo-scripts.md (verified to exist), which is clearly signaled ("Catálogo completo dos 42 scripts ... em references/catalogo-scripts.md") and one level deep — the reference points back to the SKILL.md attribution section rather than nesting further. Sections are well-organized with a clear load condition for the reference ("Carregar quando a tabela de 22 linhas do arquivo principal não cobrir a operação pedida"). | 5 / 5 |
Total | 19 / 20 Passed |