Content
82%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-structured, highly actionable single-file skill that earns its length with tool-specific tables and executable examples. The main improvement opportunities are trimming citation overhead and adding explicit guidance for handling eval failures.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with tables, code, and tool-specific facts Claude would not know, with no padding explaining basic concepts. Minor trimmable material remains, such as repeated 'per [pf-config]' citation phrases and the full GitHub Action input list, keeping it just short of fully lean. | 4 / 5 |
Actionability | Every step provides copy-paste-ready material: install commands ('npm install -g promptfoo'), init/eval/view commands, complete YAML config snippets, assertion examples with concrete thresholds, and a real GitHub Actions workflow block covering the common CI case. | 5 / 5 |
Workflow Clarity | Steps 1-8 form a clear, logical sequence from install through CI gating, with 'promptfoo view' as an inspection checkpoint and an anti-patterns table covering failure modes. It lacks an explicit fail-then-fix feedback loop for interpreting and recovering from eval failures, so it stops short of a 5. | 4 / 5 |
Progressive Disclosure | With no bundle files, all content lives in SKILL.md, but it is well-organized under clear section headers with a consolidated References list and easy navigation. The sizable inline assertion catalog is material that could arguably move to a references file, preventing a 5. | 4 / 5 |
Total | 17 / 20 Passed |