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 tight, highly actionable single-file skill: concrete commands and exact JSON shapes for every step, an audit-first and verify-last workflow with skip conditions, and zero padding. The only improvement is minor tightening of Step 2's slightly duplicated JSON examples.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — no tutorials on CSP, JSON, or grep — with every step carrying domain-specific value. It is not 5 because Step 2 contains a mildly redundant pair of JSON examples (the 'After (correct)' deployments snippet followed immediately by another full app.json snippet showing the infra placement) that could be merged and trimmed. | 4 / 5 |
Actionability | Fully executable throughout: copy-paste-ready grep commands ('grep -rn "fetch\|axios\|new XMLHttpRequest" src/ --include="*.ts" --include="*.tsx"'), exact JSON shapes for app.json and manifest.json, exact deploy script lines ('npx @cognite/cli@latest apps deploy --interactive'), and explicit delegation to setup-flows-auth. Covers the common cases including the empty-network edge case ('If no external calls exist, leave "network": []'). | 5 / 5 |
Workflow Clarity | Six clearly sequenced steps with an audit-before-change checkpoint (Step 1 report template), skip-if-already-done conditions ('If `infra` is already "appsApi", skip this step'), a verification pass (Step 6 grep for leftover Dune references), a completion checklist, and user-facing next steps. This matches the 5 anchor: explicit validation, feedback, and checklists are all present. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), and none are needed — the entire skill fits appropriately inline as a single well-organized SKILL.md with clear section headers. The one cross-file dependency (the setup-flows-auth skill) is clearly signaled in its own step. Per the simple-skill guidance, well-organized sections with no need for external references score 5. | 5 / 5 |
Total | 19 / 20 Passed |