Content
78%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 content is a tight, actionable reference for a simple read-only lookup skill, with real CLI commands and sensible error-recovery guidance. The main improvement opportunity is de-duplicating the repeated 'do not infer/guess' warnings.
Suggestions
Consolidate the three repeated anti-drift warnings (lines on memory/old chat/task files, teamName source, and 'do not guess') into a single concise 'Do not infer state from memory, old chat, or task files; if metadata is missing or queries are denied, ask your coordinator' statement.
Add a brief example of expected `agt get workers` JSON output so the jq extraction target (`.team`) is verifiable without a live run.
Optionally label the command block's three-step intent (1. fetch your worker, 2. extract Team CR, 3. list team workers) so the workflow sequence is explicit rather than implied by the shell snippet.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence, but the anti-drift warnings ('Do not infer from memory/old chat/task files', 'Do not use teamName from prompts/task files/old chat', 'Do not guess') repeat the same caution three times and could be consolidated. | 4 / 5 |
Actionability | Provides a concrete, copy-paste-ready bash block using the real `agt` CLI with env-var fallback and jq extraction; minor gap is the absence of example output or a second common-case example. | 4 / 5 |
Workflow Clarity | The read-only lookup sequence (get worker -> derive TEAM_CR -> get all workers) is clear and includes error-recovery fallbacks ('If team-scoped queries are denied, ask your coordinator'; 'If required identity... is missing, ask your coordinator'), though validation is fallback-based rather than output-checking. | 4 / 5 |
Progressive Disclosure | Under 50 lines with no need for external references, organized into well-labeled sections ('Source Of Truth', 'What To Use It For'); per the simple-skill exception this earns full marks. | 5 / 5 |
Total | 17 / 20 Passed |