story-cycle

story-cycle is a skill for Claude Code from joris887/exosuit. It costs 19 tokens per session (14,581 once invoked), scanned A, original, MIT.

A guided workflow for delivering one user story, meaning a small, clearly described piece of product work. It takes the work from breaking down the request through implementation and verification.

In plain words
What is it for?
Use it when implementing a single story or backlog item and you want structured phases for planning, coding, checking the result, and completing the work.
Why use it?
It gives a backlog item a defined path so important planning, readiness checks, testing, and quality steps are less likely to be skipped.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: reads .claude/ paths; mentions CLAUDE.md; mentions subagents.

Part of the exosuit plugin — 44 skills, 1 command, 9 agents, 10 hooks shipped together

Good fit Use it when implementing a single story or backlog item and you want structured phases for planning, coding, checking the result, and completing the work.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/joris887/exosuit/story-cycle
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 joris887/exosuit --skill story-cycle
Clone the repo
git clone --depth 1 https://github.com/joris887/exosuit

Made for: Claude Code.

Or install exosuit, the plugin that ships this one along with the rest of its 44 skills, 1 command, 9 agents, 10 hooks.

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-cycle

README.md
[![agentmods](https://agentmods.dev/badge/skills/joris887/exosuit/story-cycle/github.svg)](https://agentmods.dev/skills/joris887/exosuit/story-cycle)
Your own site
<a href="https://agentmods.dev/skills/joris887/exosuit/story-cycle"><img src="https://agentmods.dev/badge/skills/joris887/exosuit/story-cycle/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for story-cycle

Your own site · 80×15
<a href="https://agentmods.dev/skills/joris887/exosuit/story-cycle"><img src="https://agentmods.dev/badge/skills/joris887/exosuit/story-cycle.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 19 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 14,581 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.00019 $0.14581
Opus 5 $0.00010 $0.07290
Sonnet 5 $0.00004 $0.02916
Haiku 4.5 $0.00002 $0.01458

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

Security

Grade A, and why

story-cycle 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 9d 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.

.claude/skills/story-cycle/SKILL.md · 937 lines

How it starts

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


story-cycle

Delivering story: $ARGUMENTS

Skill metrics: Emit a start event to the activity log:

echo "{\"type\":\"skill\",\"event\":\"start\",\"skill\":\"story-cycle\",\"story\":\"$ARGUMENTS\",\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"}" >> docs/sessions/.activity-log.jsonl

Progress tracking: At the start, create a task list for phase tracking:

  1. "Phase 0+1: Decompose intent, research, plan" — activeForm: "Planning..."
  2. "Phase 2: Context transition + readiness gate" — activeForm: "Preparing..." — blockedBy: [1]
  3. "Phase 3: Implement by story type" — activeForm: "Implementing..." — blockedBy: [2]
  4. "Phase 4: Verify, quality gates, commit" — activeForm: "Verifying..." — blockedBy: [3]

At each phase boundary, mark the current task completed and the next task in_progress.

Process Flow (authoritative — prose below is supporting detail)

START → Phase 0: Intent Decomposition (identify ALL deliverables, mark uncertainties)
  → Size Classification:
    → [TRIVIAL: single-file, <10 lines, no behavioral change]
      → Phase 3-lite: Make change → Run tests → Abbreviated self-review → Commit → DONE
    → [SMALL: single-file, <50 lines, clear AC]
      → Lightweight Phase 1 (skip 1f-1g) → Phase 2 → Phase 3 → Phase 4 → DONE
    → [STANDARD: everything else]
      → Phase 1: Plan Mode (research, identify type, write plan with WHAT/HOW separation)
        → Phase 1c.5: Online Verification → `*** HARD GATE: must print Research Decision block ***`
          → 1c.5+: Dependency Freshness Check (always, if story touches external deps)
        → Phase 1d.7: Story Refinement & Forward Context (gap analysis, cross-story notes)
        → Phase 1f: Clarification Check (ambiguity_scan across 7 categories)
        → Phase 1g: Plan Completeness (verify spec/implementation sections)
        → [User approved?] → NO: Revise → YES: Continue
      → Phase 2: Context Transition + Confidence Gate
        → (prune context, score 5 dimensions, ≥85 proceed, 70-84 clarify, <70 return to Phase 1)
      → Phase 3: Execute by Story Type
        → `*** HARD GATE: TDD ordering — tests BEFORE implementation (Feature/Bug Fix/Refactoring) ***`
        → Web-Assisted Error Recovery (on build/test failure involving external libraries)
        → Bug Fix Web Research (always for bug fix stories — search error patterns first)
      → Phase 4: Verify + Wrap Up
        → Self-review + disaster prevention + ground rules re-check
        → Quality agents dispatched per risk level
        → Security web verification (security-scoped stories — CWE + CVE check)
        → Quality gates `*** HARD GATE: all configured gates must pass ***`
        → UAT generation + sense check (optional — Feature/Bug Fix only)
        → Completion verification (evidence for every AC)
        → Docs + commit
        → [All criteria met?] → NO: Fix + re-verify (max 2 passes) → YES: Report → DONE

Read the full file on GitHub · 937 lines

Files

What ships with it

8 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 9d ago First seen · 937 lines · 19 tokens per session scan A d8f23d02b25b

Subscribe to this mod's changes

story-cycle is a skill published in the GitHub repository joris887/exosuit (4 stars, last pushed 20d ago), licensed MIT. It adds 19 tokens to every session and 14,581 once invoked, about $0.0001 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

build-teaql-app

Build or change a TeaQL application in Java, Rust, Go, Swift, Python, C#/.NET, or TypeScript, including Kotlin/JVM applications that consume Java-generated libraries. Mandatory order: first draft and save a complete KSML model, then verify the client and evaluate that saved model, repair it through repeated evaluation…

teaql/teaql-agent-kit · 112 tokens

linkedin-post

You take a YouTube video transcript and produce a single LinkedIn post draft.

owainlewis/youtube-tutorials · 0 tokens

orchestrator-lanes

A file-based project-management playbook for a specific Claude Code development orchestrator. It organizes work into lanes, plans, dependency steps, validation phases, and shipping stages.

VKirill/claude-lane-stack · 0 tokens

eval-agents

Audit Claude Code agents defined in .claude/agents/ for description specificity, model tier appropriateness, tools scoping, and system prompt quality. Detects dispatch ambiguity between agents, flags over-permissive tool grants, and checks for human-in-the-loop patterns that break programmatic orchestration. Use when…

FlorianBruniaux/claude-code-ultimate-guide · 93 tokens

land-and-deploy

Merge PR, wait for CI, verify deploy, run canary. The complete landing pipeline.

FlorianBruniaux/claude-code-ultimate-guide · 24 tokens

git-ai-archaeology

Analyze AI config evolution in a git repo. Use when mapping AI adoption history, finding when configs were first introduced, charting commit velocity by month, or identifying maturity phases in a project's AI tooling.

FlorianBruniaux/claude-code-ultimate-guide · 47 tokens