CtrlK
BlogDocsLog inGet started
Tessl Logo

po-feature-spec

Skill do Product Owner para especificação de features. Use quando precisar definir requisitos de negócio, escrever user stories, critérios de aceitação, priorização de backlog, ou qualquer documento de especificação de produto. Trigger em: "nova feature", "especificação", "user story", "requisito", "backlog", "PO", "definir escopo", "critério de aceitação", "MVP", "roadmap".

83

Quality

78%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/01-po-feature-spec/SKILL.md
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 defines its scope around Product Owner feature specification work. It excels in all dimensions by listing concrete actions, providing explicit 'Use when' guidance, and enumerating a comprehensive set of natural trigger terms. The description is concise, uses third person voice appropriately, and would be easily distinguishable from other skills in a large skill library.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: defining business requirements, writing user stories, acceptance criteria, backlog prioritization, and product specification documents.

3 / 3

Completeness

Clearly answers both 'what' (Product Owner specification of features, defining business requirements, writing user stories, acceptance criteria, backlog prioritization) and 'when' (explicit 'Use quando' clause with specific trigger scenarios, plus an explicit 'Trigger em' list).

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'nova feature', 'especificação', 'user story', 'requisito', 'backlog', 'PO', 'definir escopo', 'critério de aceitação', 'MVP', 'roadmap'. These are terms users would naturally use when needing this skill.

3 / 3

Distinctiveness Conflict Risk

Clearly carved out niche around Product Owner / product specification work with distinct triggers like 'PO', 'user story', 'backlog', 'MVP' that are unlikely to conflict with other skills such as general coding or documentation skills.

3 / 3

Total

12

/

12

Passed

Implementation

57%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a moderately well-structured PO specification skill with strong progressive disclosure and useful concrete frameworks (ambiguity scoring, prioritization matrix, acceptance criteria examples). Its main weaknesses are the lack of a concrete, filled-out feature spec example and the absence of an explicit end-to-end workflow sequence. Some sections (Código Limpo, basic PO responsibilities) add tokens without adding value for Claude.

Suggestions

Add a concrete, filled-out feature spec example showing the 'Estrutura Mínima' applied to a real scenario, so Claude has a copy-paste-ready template to follow.

Create an explicit numbered end-to-end workflow at the top: 1. Calculate ambiguity score → 2. Choose path → 3. Write spec → 4. Validate completeness (checklist) → 5. Handoff to UI/UX.

Remove the 'Código Limpo' section (irrelevant to PO spec work) and trim 'Responsabilidades' to reduce token waste.

Add a validation checkpoint before handoff—e.g., a checklist confirming all required spec sections are present and acceptance criteria are testable.

DimensionReasoningScore

Conciseness

The skill includes some unnecessary sections like 'Código Limpo' (clean code advice irrelevant to a PO spec skill) and 'Responsabilidades' which restates obvious PO duties. The 'Quando Usar/Não Usar' sections are helpful but could be tighter. The prioritization matrix and ambiguity scoring are valuable additions that earn their tokens, but overall there's moderate bloat.

2 / 3

Actionability

The skill provides concrete frameworks (ambiguity scoring formula, prioritization matrix, DADO/QUANDO/ENTÃO example) which are actionable. However, the core deliverable—the feature spec itself—lacks a concrete template or example output. The 'Estrutura Mínima' section lists what to cover but doesn't show a filled-out example. The Deep Interview protocol references a template file rather than providing inline guidance.

2 / 3

Workflow Clarity

There's an implicit workflow: calculate ambiguity → decide path (direct/enrich/interview) → write spec → handoff to UI/UX. However, this end-to-end sequence is never explicitly laid out as a numbered workflow. The ambiguity scoring thresholds provide clear decision points, but there's no validation step to verify the spec is complete before handoff, and the overall process must be pieced together from scattered sections.

2 / 3

Progressive Disclosure

The skill effectively uses one-level-deep references to external files: `docs/skill-guides/po-feature-spec.md` for extended examples, `templates/deep-interview.md` for interview protocol, `docs/skill-guides/ideation-frameworks.md` for ideation. References are clearly signaled with context about when to consult them. The main file stays at overview level while pointing to detailed resources.

3 / 3

Total

9

/

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
felvieira/claude-skills-fv
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.