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.
An exceptionally dense, expert-level skill: every section encodes non-obvious operational rules, concrete commands, and explicit validation/feedback loops rather than generalities. The only notable gap is that the cross-platform Azure validation workflow, while fully parameterized, defers its queue command to the azure-pipelines skill.
Suggestions
Inline the canonical Azure pipeline-111 queue command (or a minimal working invocation with the listed VSCODE_BUILD_TYPE=CI and platform flags) in the 'Cross-platform Azure validation' section so that workflow is executable without loading the azure-pipelines skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence throughout — no basic-concept explanations, only non-obvious operational knowledge like 'Fixtures are generated, never hand-edited', 'Separate storage semantics from device latency', and 'Keep temporary workspaces outside instruction-bearing ancestors'. Every token carries repo-specific guidance a general model could not reconstruct. | 5 / 5 |
Actionability | Mostly executable: copy-paste commands for recording and replay ('AGENT_HOST_REPLAY_RECORD=1 ./scripts/test-integration.sh --run src/...'), a concrete gating pattern ('(RECORD ? test : test.skip)'), named files and functions ('capiReplayProxy.ts', 'hostOnlyTest(...)'), and pipeline definition '111'. The Azure queue workflow is parameterized but its actual command is deferred to 'The azure-pipelines skill contains the canonical command' — a minor executable gap that keeps it below fully copy-paste-ready. | 4 / 5 |
Workflow Clarity | Each workflow (write-and-evaluate, record, gate, Azure validation) is a numbered sequence with explicit validation checkpoints and error-recovery loops: 'Run plain replay (no env var) to confirm green, then commit', 'If something leaked, the fix is to extend normalization/redaction... and re-record — not to edit the fixture', and rerun rules after a platform-specific failure. Verification steps are never implicit. | 5 / 5 |
Progressive Disclosure | No bundle files exist; the skill appropriately delegates architecture and troubleshooting to a single, prominently signaled one-level-deep README ('Before doing anything, read the architecture + troubleshooting reference... This skill is only the workflows; the README is the source of truth for how it works'), and delegates CI-artifact and Azure-pipeline mechanics to sibling skills instead of duplicating them. Sections are cleanly divided per workflow. | 5 / 5 |
Total | 19 / 20 Passed |