Content
76%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.
The body is highly actionable and well-structured with executable commands throughout, but its workflow clarity is capped by the absence of validation/verification for destructive and batch operations, and a minor dangling 'Step 2' reference. Progressive disclosure is good for a self-contained file though slightly long.
Suggestions
Add a validation/verification checkpoint before and after destructive actions (e.g. confirm the target ID, run a get-* afterward to verify deletion, and warn the user before delete-* runs).
Fix the dangling navigation: label 'Step 2' explicitly or replace 'skip to Step 2' with a concrete section link so the connection-to-actions handoff is unambiguous.
Consider moving the 20-row Popular actions table into a references/ file and keeping a concise 'most-used' subset inline to tighten the SKILL.md overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly commands, tables, and terse operational prose with only minor over-explanation (e.g. the one-line LifterLMS intro and the Membrane-auth framing), fitting 'Efficient; minor instances of over-explanation that could be trimmed'. | 4 / 5 |
Actionability | It provides copy-paste-ready commands for every stage (login, connection ensure, polling, action list/run, request proxy) plus a flag table and a populated actions table, matching 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | The connect → poll → search → run sequence is present with a state feedback loop, but destructive actions (delete-course, delete-student, etc.) lack any validation/verification or confirm-before-delete checkpoint, which caps workflow clarity at 3 per the destructive-operations rule; a dangling 'skip to Step 2' with no labeled Step 2 adds a gap. | 3 / 5 |
Progressive Disclosure | No bundle files exist; the skill is a single self-contained file with clear section headers (Overview, Working with LifterLMS, Popular actions, Best practices), giving good structure, though the ~160-line length and the large inline actions table keep it just short of the ideal split of a 5. | 4 / 5 |
Total | 16 / 20 Passed |