Content
67%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.
A well-organized, token-efficient skill body with a genuinely useful preset catalog, concrete script invocations, and an explicit preview-then-build workflow with validation gates. Its main gaps are the missing engine/viewport-base.css file that the non-negotiable core rule depends on, no executable example of the stage mechanism, and several referenced governance files (GLOBAL.md, policies/*) that are not present in the bundle.
Suggestions
Ship engine/viewport-base.css in the bundle (or inline its ~essential content in the body) so the instruction "copiado por inteiro, nunca editado" is actually executable — right now the skill's single non-negotiable rule points to a file Claude cannot find.
Add one minimal executable HTML snippet showing the .deck-stage structure, the .active/.visible slide toggling, and the transform: scale(...) fit logic, so the fixed-stage mechanism doesn't have to be reconstructed from prose.
Add a short error-recovery note for the export/deploy steps (e.g., what to check when the Playwright capture or Vercel deploy fails) to close the workflow's missing feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence — the "calc(-1 * clamp(...))" CSS gotcha and the fixed-stage letterbox rule are non-obvious, skill-specific knowledge with no padding about basics. Minor trimmable sections (design rationale in "Movimento", the provenance paragraph with a time-sensitive date "2026-06-23" outside a deprecated section) keep it below a 5. | 4 / 5 |
Actionability | Reference scripts are concretely invoked with arguments ("references/extract-pptx.py <input.pptx> <output_dir>", "references/export-pdf.sh <caminho.html> [saida.pdf]" with "--compact"), but the rule designated "não-negociável" — "engine/viewport-base.css (copiado por inteiro, nunca editado)" — points to a file absent from the bundle, and no executable stage HTML/CSS/JS example is given, leaving key details missing for the core mechanism. | 3 / 5 |
Workflow Clarity | The sequence is clear: 3 single-slide previews with an explicit A/B/C slot table, a user-selection checkpoint before the full deck, an anti-AI-slop gate ("antes de entregar, confirmar..."), and a completion checklist in "Evidencia de Conclusao". It lacks an explicit error-recovery loop (e.g., what to do when Playwright export or Vercel deploy fails), so it does not reach 5. | 4 / 5 |
Progressive Disclosure | Good structure with well-signaled, one-level-deep references that all exist in the bundle (style-presets.md at 346 lines correctly split out of the body, plus export-pdf.sh, deploy.sh, extract-pptx.py). However, engine/viewport-base.css, GLOBAL.md, and policies/*.md are referenced in the body but not shipped, leaving broken navigation paths. | 4 / 5 |
Total | 15 / 20 Passed |