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 well-crafted skill description that excels across all dimensions. It clearly defines the scope (Product Owner feature specification), lists concrete actions, provides an explicit 'Use when' clause, and includes a comprehensive list of natural trigger terms. The description is concise yet thorough, making it easy for Claude to select this skill appropriately from a large pool.

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 skill for feature specification, 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', 'critério de aceitação' 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 reasonably well-structured PO skill that provides concrete tools (ambiguity scoring formula, prioritization matrix, acceptance criteria format) but falls short on providing a complete executable example of the primary output (a feature spec). The progressive disclosure is well done with clear references to external files, but the workflow could be more explicitly sequenced with validation checkpoints, and some sections (Código Limpo, Responsabilidades) add little value for a PO-focused skill.

Suggestions

Add a complete, concrete example of a finished feature spec (even a minimal one) showing all required sections filled in, so Claude knows exactly what the output should look like.

Consolidate the workflow into a single explicitly numbered sequence: 1. Receive input → 2. Calculate ambiguity score → 3. Enrich/Interview if needed → 4. Write spec → 5. Validate completeness against checklist → 6. Handoff to UI/UX.

Remove the 'Código Limpo' section which is irrelevant to a Product Owner specification skill, and merge 'Responsabilidades' into the intro or remove it to reduce token waste.

Add an explicit validation step before handoff (e.g., 'Before handing off, verify all items in Evidência de Conclusão are met') to create a proper feedback loop.

DimensionReasoningScore

Conciseness

The skill includes some unnecessary sections like 'Código Limpo' (clean code advice irrelevant to a PO spec skill) and 'Responsabilidades' which largely restates what's already implied. The 'Quando Usar/Não Usar' sections are reasonable but could be tighter. The ambiguity scoring and deep interview sections add real value but are somewhat verbose in explanation.

2 / 3

Actionability

The skill provides concrete examples for acceptance criteria (DADO/QUANDO/ENTÃO format) and a specific prioritization formula with scoring thresholds, which is good. However, the 'Estrutura Mínima da Feature Spec' only lists bullet points without a concrete template or example output. The ambiguity score formulas are concrete but reference an MCP tool and templates without showing what the actual spec output should look like. No complete example of a finished feature spec is provided.

2 / 3

Workflow Clarity

There's an implicit workflow: calculate ambiguity score → decide path (proceed/enrich/interview) → write spec → handoff to UI/UX. However, the overall end-to-end sequence is not explicitly numbered or clearly laid out as a single workflow. The ambiguity scoring section has clear thresholds and decision points, but there's no validation checkpoint to verify the spec is complete before handoff. The handoff section is a checklist but lacks a 'validate before proceeding' step.

2 / 3

Progressive Disclosure

The skill appropriately keeps the overview concise and references external files for extended content: `docs/skill-guides/po-feature-spec.md` for full examples, `templates/deep-interview.md` for interview protocol, and governance policies. References are one level deep and clearly signaled. The inline content covers enough to be useful without being a monolithic wall.

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.