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.
An exemplary tool-skill body: concrete, verified, copy-paste-ready commands organized by real debugging questions with a lean quick-reference and per-command docs. The only material issue is in the bundle rather than the prose — every script imports a missing ../lib/auth.js, so the documented commands would fail at runtime until that shared library is added.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes competence — no explanation of what Sentry is or how APIs work — and relies on a Quick Reference table and compact option lists, but there is minor duplication: search-events flags appear in the Quick Reference, the workflow examples, and the reference section, and "Tips for Debugging" partially restates workflow content. Fits 'Efficient; minor instances that could be trimmed' rather than the every-token-earns-its-place anchor. | 4 / 5 |
Actionability | Every example is copy-paste ready (e.g. "./scripts/search-events.js --org myorg --start 2025-12-23T15:00:00 --end 2025-12-23T17:00:00", "./scripts/fetch-issue.js https://sentry.io/organizations/myorg/issues/123/ --latest", "--query \"times_seen:>50\"") and the documented flags match the scripts' actual help output, covering the common cases across all five scripts — a full match for the fully-executable anchor. | 5 / 5 |
Workflow Clarity | "Common Debugging Workflows" sequences investigation by question (time-window search → level/transaction filter → drill into event), and the tips supply a strategy ("Start broad, then narrow down", "Check related events... same transaction name or trace ID") that acts as a drill-down feedback loop. Being read-only investigation, the destructive/batch validation cap does not apply, but there are no explicit verification checkpoints, so it fits 'clear sequence with most checkpoints present; minor validation gaps' rather than the validate-and-recover anchor. | 4 / 5 |
Progressive Disclosure | All five script paths referenced in the body exist in the bundle, and the structure (Quick Reference → workflows → per-command reference → tips) is well-signaled with appropriate density for a single-file tool skill. Verified against the actual bundle: one defect — every script imports "../lib/auth.js", which is absent, so the referenced scripts cannot run as bundled; this is a script-internal dependency break rather than a body-reference defect, keeping it at the 'good structure; minor organization gaps' anchor rather than dropping to anchor 3's 'could be better organized'. | 4 / 5 |
Total | 17 / 20 Passed |