CtrlK
BlogDocsLog inGet started
Tessl Logo

team-prd

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

1.02x
Quality

92%

Does it follow best practices?

Impact

99%

1.02x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
redis/agent-filesystem
Reviewed

Table of Contents

Is this your skill?

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.