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.
A comprehensive, highly actionable skill body with clear workflows, validation feedback loops, and well-structured progressive disclosure to verified reference files. Its only weakness is mild verbosity from duplicated facturation reference tables and example diagnostic blocks.
Suggestions
Consolidate the duplicated facturation reference tables (the 'Références' table and 'Router la demande facturation' table list largely the same references) into one to trim tokens.
Tighten or relocate the example échéance/diagnostic console blocks (e.g. the 'PROCHAINES ÉCHÉANCES' and 'CONFORMITÉ FACTURATION' mock outputs) into a reference file, keeping only the format spec inline.
Move the long invoicing field checklist (the 'Vérification des champs facturation' code block) into references/facturation/setup-facturation.md, which already covers it, to reduce SKILL.md length.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense and well-organized with almost no concept-padding, but the facturation reference tables appear twice (general 'Références' table and the 'Router la demande facturation' table) and the example diagnostic/échéance blocks add length that could be tightened. It is efficient but not perfectly lean, so it sits below the top anchor. | 4 / 5 |
Actionability | Provides fully executable guidance: exact CLI invocations with flags (e.g. 'scripts/generate-facturx.js --invoice <f.json> --xml-only', '--strict', '--json'), npm equivalents, and precise data-lookup procedures ('lire data/pcg_YYYY.json → chercher dans le tableau flat par number'). Copy-paste ready and covers common cases. | 5 / 5 |
Workflow Clarity | Sequenced workflow (0. vérifier échéances → 1. comprendre → 2. analyser), a 12-step clôture checklist with checkboxes, compliance diagnostics with color-coded status, and explicit validation feedback loops ('validate-facture.js --validate', '--strict'). Batch/destructive validation is present, satisfying the destructive-operations cap. | 5 / 5 |
Progressive Disclosure | Clear overview in SKILL.md with well-signaled one-level-deep references to verified bundle files (references/*.md, references/facturation/*.md), a dedicated facturation routing table, and guidance to use data/pcg_YYYY.json instead of inlining the 800+ PCG accounts. Navigation is easy and content is appropriately split. | 5 / 5 |
Total | 19 / 20 Passed |