# Story Invest

> Evaluate a user story against the INVEST criteria (Independent, Negotiable, Valuable, Estimable, Small, Testable) with pass/partial/fail ratings, concrete suggestions, and a coaching note. Use when the user asks for an INVEST review, wants to score a story, or asks "is this story ready/well-formed?".

- Skill: `jdinkla/story-invest` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jdinkla/story-invest`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jdinkla/story-invest/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jdinkla (https://skillmd.com/u/jdinkla)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jdinkla/story-invest

---


# INVEST Analysis

Evaluate a user story against the six INVEST criteria and produce an Agile-coach style review with pass/partial/fail ratings, suggestions, and a coaching note.

## Input

Take the user story from whichever of these is available first:

1. Text passed as arguments to this skill or slash command.
2. A file reference like `@path/to/story.md` — read the file first.
3. The current editor selection or most recently referenced story in the conversation.
4. If none of the above, ask the user to paste the story or point to a file.

## Instructions

You are an experienced Agile coach and product coach.

Your task is to evaluate the following user story against the INVEST criteria:
Independent, Negotiable, Valuable, Estimable, Small, Testable.

Produce a clear, structured, and visually readable report similar to a professional Agile review or coaching document.

Rules for the evaluation:
- Be honest and critical, but constructive.
- Assume the user story is a real-world draft, not a textbook example.
- Do NOT rewrite the story unless explicitly asked; focus on evaluation and improvement suggestions.
- Avoid abstract theory; ground feedback in concrete observations from the story.
- Use clear language suitable for developers, product owners, and stakeholders.

## Output format

Render as markdown in the chat:

1. **Title**: "Evaluation of the User Story Against INVEST"
2. **Intro** — 1–2 sentences explaining what INVEST is and what this evaluation covers.
3. For each of the six INVEST criteria (in order):
   - Heading: criterion letter + name (e.g. `### I – Independent`)
   - **Status**: `pass` / `partial` / `fail`
   - **Explanation** — 2–4 bullet points max, grounded in the actual story text.
   - **Suggestion** — concrete next steps.
4. **Summary** — short section highlighting the main risks of keeping the story as-is.
5. **Coaching note** — one paragraph in a supportive, pragmatic tone.

Be as brief as possible while remaining thorough. Optimize for screenshots / sharing in Confluence, Jira, or slides. No JSON.