# Intent

> Drafts and clarifies intent and scope of a change before implementation. Use when creating user stories, tasks, plans, or other artifacts to define what to build.

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

---


- Follow INVEST: stories must be independent, negotiable, valuable, estimable, small, testable
- Cap stories at 1 day of work — split larger scopes down to separable tasks
- Do NOT implement until the user is happy.
- Save plans in `docs/plans/<plan-title>.md`
- Update the plan as new insights, constraints, and decisions emerge

## User Story Format

```text
As a [role], I want [goal] so that [user goal]
```

## Story Template

```markdown
# User Story: [Title]

## Story
As a [role],
I want [goal/feature]
so that [benefit/value]

## Background
[Context]

## Acceptance Criteria
- [ ] Given [context], when [action], then [result]

## Technical Notes
- Dependencies:
- Architecture considerations:
- Security implications:
- Unknowns
```