story-evaluation

Evaluate user stories against the FINVEST rubric and generate scores, observations, and decisions.

1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/dariopalminio/agile-sddf --skill story-evaluation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-evaluation
Source: https://github.com/dariopalminio/agile-sddf/tree/main/.claude/skills/story-evaluation
Command: npx skills add https://github.com/dariopalminio/agile-sddf --skill story-evaluation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill provides a consistent, rigorous method to evaluate the quality of a user story using the FINVEST rubric, enabling teams to prioritize and improve backlog items.

Core Features & Use Cases

  • Outputs a FINVEST score across F (Format) and INVEST (I, N, V, E, S, T) dimensions.
  • Generates per-dimension observations, a final decision (APROBADA / REFINAR / RECHAZAR), and concrete recommendations.
  • Helps with backlog grooming and sprint planning by clarifying gaps in format, granularity, and testability.

Quick Start

Submit a user story using the FINVEST evaluation template to receive a FINVEST report.

Frequently Asked Questions about story-evaluation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I evaluate a user story against the INVEST criteria for backlog grooming?

Evaluating a user story against INVEST involves scoring dimensions like Independent, Negotiable, Valuable, Estimable, Small, and Testable to identify granularity and testability gaps. The FINVEST rubric extends this by adding a Format phase gateway, generating per-dimension observations and a final decision to approve, refine, or reject the story.

What is the FINVEST rubric and how does it score user stories?

The FINVEST rubric is a scoring method that evaluates user stories across Format and INVEST dimensions. It generates a detailed score, per-dimension observations, and a final decision of APROBADA, REFINAR, or RECHAZAR, while explicitly marking critical conditions like S (Small) or I/N/E (1).

How do I write better acceptance criteria and Gherkin scenarios for my backlog items?

Refining acceptance criteria and Gherkin scenarios requires evaluating the testability and format of the user story. Applying the FINVEST rubric highlights specific gaps in these areas, providing actionable recommendations to clarify conditions and improve backlog item quality for sprint planning.

Can I use a FINVEST score to decide which user stories to approve or reject for sprint planning?

Yes, you can use a FINVEST score to decide which user stories to approve or reject during sprint planning. The evaluation outputs a final decision of APROBADA, REFINAR, or RECHAZAR, along with concrete recommendations to clarify backlog gaps in format, granularity, and testability.

What makes a user story fail the format gateway in story evaluation?

A user story fails the format gateway when it lacks the structural elements required by the FINVEST rubric. The F-phase scoring identifies these formatting issues upfront, generating observations that result in a REFINAR or RECHAZAR decision before the INVEST dimensions are fully assessed.