Read and update the team's shared PRD in the team-prd AFS workspace. Trigger when the user asks about current/inflight/done work, wants to start a new work item, mark something complete, or add an open question to the team's spec. Enforces per-dev subdir isolation to avoid write conflicts between multiple developers' agents.
95
92%
Does it follow best practices?
Impact
99%
1.02xAverage score across 3 eval scenarios
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that clearly articulates what the skill does (manages a shared PRD in an AFS workspace), when to use it (with explicit trigger scenarios), and includes a distinctive architectural detail about per-dev subdir isolation. The description uses proper third-person voice and provides natural trigger terms that users would actually say.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple concrete actions: read and update PRD, start a new work item, mark something complete, add an open question. Also mentions per-dev subdir isolation for conflict avoidance—very specific. | 3 / 3 |
Completeness | Clearly answers both 'what' (read and update the team's shared PRD, enforce per-dev subdir isolation) and 'when' (explicit trigger clause covering multiple scenarios like asking about work status, starting items, marking complete, adding questions). | 3 / 3 |
Trigger Term Quality | Includes natural trigger terms users would say: 'current/inflight/done work', 'start a new work item', 'mark something complete', 'add an open question', 'team's spec', 'PRD'. Good coverage of how users would phrase these requests. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive: targets a specific artifact (team PRD in AFS workspace), specific operations (work item management, open questions), and a specific architectural constraint (per-dev subdir isolation). Unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured skill that clearly communicates a non-trivial concurrent workspace protocol. Its strengths are the clear layout convention, explicit conflict-avoidance rules, and well-sequenced workflows. The main weakness is that it describes actions at a conceptual level rather than providing exact MCP tool invocations, which would make it more immediately actionable for Claude.
Suggestions
Add concrete MCP tool call examples (e.g., show an actual `read_file` call to check `/prd.md` and a `write_file` call to create an inflight item) to make workflows copy-paste executable.
Include a brief example of a complete `file_replace` invocation for the shared-file revision case, since that's the most conflict-prone operation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. Every section serves a purpose—layout convention, conflict rules, identity establishment, and workflows are all necessary and non-obvious domain knowledge. No unnecessary explanations of basic concepts. | 3 / 3 |
Actionability | The guidance is concrete with specific file paths, naming conventions, and markdown templates, but lacks executable MCP tool invocations (e.g., actual read_file/write_file/file_replace commands). The steps describe what to do but don't show exact tool calls Claude would use. | 2 / 3 |
Workflow Clarity | Multi-step processes (starting work items, marking done, adding questions) are clearly sequenced with explicit steps. The 'read before write' reflex serves as a validation checkpoint, and the append-only/single-writer rules provide clear guardrails against destructive operations. | 3 / 3 |
Progressive Disclosure | For a skill with no bundle files, the content is well-organized into clearly labeled sections with a logical progression from layout → rules → identity → workflows. The CONVENTIONS.md reference and directory structure serve as natural navigation aids. No monolithic walls of text or deeply nested references. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
ef5c9a4
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.