story-clarifier

story-clarifier is a skill for Claude Code, Codex from n-n-code/n-n-code-skills. It costs 87 tokens per session (2,755 once invoked), scanned A, original, MIT.

A writing and review step that turns rough software requests into clear, testable story cards.

In plain words
What is it for?
Use it to draft, combine, rewrite, tighten, split, or audit tickets, conversations, user stories, feature definitions, and acceptance criteria.
Why use it?
It makes behavior, acceptance criteria, scope, and boundaries explicit enough for repository research and implementation planning.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

Good fit Use it to draft, combine, rewrite, tighten, split, or audit tickets, conversations, user stories, feature definitions, and acceptance criteria.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/n-n-code/n-n-code-skills/story-clarifier
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add n-n-code/n-n-code-skills --skill story-clarifier
Clone the repo
git clone --depth 1 https://github.com/n-n-code/n-n-code-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for story-clarifier

README.md
[![agentmods](https://agentmods.dev/badge/skills/n-n-code/n-n-code-skills/story-clarifier.svg)](https://agentmods.dev/skills/n-n-code/n-n-code-skills/story-clarifier)
Your own site
<a href="https://agentmods.dev/skills/n-n-code/n-n-code-skills/story-clarifier"><img src="https://agentmods.dev/badge/skills/n-n-code/n-n-code-skills/story-clarifier.svg" alt="Measured on agentmods" height="20"></a>
Per session 87 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,755 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00087 $0.02755
Opus 5 $0.00044 $0.01378
Sonnet 5 $0.00017 $0.00551
Haiku 4.5 $0.00009 $0.00276

Measured 3d ago against content hash 282d68893e10, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

story-clarifier scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/story-clarifier/SKILL.md · 287 lines

How it starts

The opening of the file, as written. The whole thing — 287 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Story Clarifier

Turn rough product intent into a compact story artifact whose behavior and boundaries are explicit enough for repository scouting and implementation planning.

Modes

  • Draft: create an artifact from rough intent; infer only low-risk details and label them as assumptions.
  • Synthesize: consolidate supplied conversation, artifacts, and material comments without interviewing. Return a non-ready artifact when the sources are insufficient or materially conflict; do not invent a resolution.
  • Rewrite: replace the source while preserving its scope, meaning, and supplied constraints; call out intentional semantic changes.
  • Tighten: remove repetition and sharpen oracles without adding behavior.
  • Audit: report findings against source sections or criterion IDs; do not rewrite unless asked.
  • Split: create ordered, independently useful vertical slices; materialize each near-term slice with the complete Story Card contract.

Workflow

  1. Select the mode. Read the full authorized referenced source and the material comments, replies, and revisions needed to interpret it before asking the user to repeat information. Preserve supplied paths, issue URLs, external identifiers, and version or revision labels exactly.
  2. Map the story breadth-first before drilling into one branch: extract the actor, beneficiary, or operating situation; trigger or need; outcome and value; behavior and visible state; permissions; success, failure, and edge branches; constraints; dependencies; assumptions; non-goals; and unknowns.
  3. Preserve supplied technical, policy, compliance, and interface constraints. Separate them from inferred implementation suggestions and never silently weaken or replace them. Never turn a material unverified claim into an assumption.
  4. Resolve contradictions and replace vague language with observable behavior. Label only safe, reversible inferences as assumptions. Classify every material unknown using the format below.
  5. In Audit, report questions as findings rather than starting an interview unless the user requested one. For other modes except Synthesize, build the question frontier from sharp decisions whose prerequisites are settled. Ask at most three independent frontier questions per batch, do not ask a downstream question alongside its unresolved prerequisite, and recompute the frontier after each answer. In Synthesize, do not interview; if a frontier remains, preserve it and return the truthful non-ready status.
  6. Choose the artifact shape, apply its contract, and run the ready check. Keep unresolved material visible.

Read the full file on GitHub · 287 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago Changed · +2 lines 282d68893e10
  2. 8d ago First seen · 285 lines · 87 tokens per session scan A 94872bc04e86

Subscribe to this mod's changes

story-clarifier is a skill published in the GitHub repository n-n-code/n-n-code-skills (4 stars, last pushed 2d ago), licensed MIT. It adds 87 tokens to every session and 2,755 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

audit-pr

Audit a whole PR against the delivery contract and return MERGE-READY or evidenced blockers with the full URL. Consumes the current review-change REVIEW-PASS receipt instead of re-running review axes; posts a SHA-bound ready comment; never edits or merges. Triggers: "audit-pr", "is this PR ready", "merge gate".

gtrabanco/agentic-workflow · 71 tokens

design-feature

Turn a raw idea or existing feature into a designed product SPEC by completing entity, integration, role, and expectation closure. Upserts never destroy recorded decisions. Triggers: "design-feature", "design this feature", "define product scope".

gtrabanco/agentic-workflow · 51 tokens

plan-feature

Route designed features or issues into engineering planning and roadmap registration; undesigned work stops at design-feature. Supports --next, --from-issue, and --scaffold. Triggers: "plan-feature", "plan a feature", "plan the next roadmap feature", "create SPEC and TASKS".

gtrabanco/agentic-workflow · 66 tokens

product-audit

Audit the whole product across code, quality, process, docs, roadmap, and tooling. Persist one severity-ranked, F-numbered report with proposals; never fix or file work. Triggers: "product-audit", "audit the product", "full health check", "are we product-ready", "CTO review".

gtrabanco/agentic-workflow · 69 tokens

audit-docs

Audit cross-document coherence: docs ↔ roadmap ↔ code ↔ fix index ↔ issues. Finds drift — features in docs/ not in the roadmap (or vice versa), fix-index entries already merged/closed, broken documentation-map links, dependency cycles, artifacts in the wrong language, naming-convention violations — and reports them…

gtrabanco/agentic-workflow · 188 tokens

init-workspace

Adapt the workflow scaffold to a new repository or add only missing substrate blocks to an existing install. Every install, hook, and overwrite needs explicit consent. Triggers: "init-workspace", "set up agentic workflow", "upgrade workflow scaffold".

gtrabanco/agentic-workflow · 54 tokens