Content
100%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 exemplary integration skill body: lean, current-aware (explicit deprecation callouts and a versioned baseline), fully executable guidance with strong safety gates around destructive and billable operations, and a clean one-level-deep reference structure that routes each task to the right file. No material weaknesses found.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious platform facts Claude cannot know (deprecated `systemRequirements` placement, exact-match default of `find_data_objects`, `get_output_ref()` must not be wrapped in `dxlink()`, 50 MB Upload Agent threshold, `DXExecDependencyError`/`AppInsufficientResourceError` policy requirements) and contains no basic-concept padding. Not 4: volatile facts are grouped under 'Current Platform Guidance' with explicit deprecation callouts, and version pins serve reproducible installs, so nothing reads as trimmable over-explanation. | 5 / 5 |
Actionability | Every workflow ships copy-paste-ready commands: `dx upload --path --property`, a complete `dxpy.find_data_objects()` call with all kwargs, `dx run --input-json-file --destination --cost-limit`, `dx find executions --created-after=-2h`, and a full DXApplet chaining example. Not 4: code and commands cover the common cases with real flags and resolved placeholders; no pseudocode anywhere. | 5 / 5 |
Workflow Clarity | Clear sequence (Install → Safe Preflight checklist → routing table → core workflows) with explicit validation checkpoints for destructive/batch operations: resolve names to immutable IDs and check duplicates before mutation, `validate_dxapp.py --strict` before `dx build`, `dx run -h` before launch, confirmation gates before billable/destructive actions, and re-describing remote state before classifying failure. Not 4: validation and error-recovery checkpoints are explicit, so the destructive/batch cap at 3 does not apply and no minor validation gap remains. | 5 / 5 |
Progressive Disclosure | A 'Choose the Right Path' routing table maps each goal to a reference file and preferred interface, an annotated Reference Index lists all nine one-level-deep reference files, and both bundled scripts are invoked with correct relative paths (all verified to exist). Not 4: content is appropriately split between a lean overview and references, with no nested or buried references. | 5 / 5 |
Total | 20 / 20 Passed |