work-story SKILL.md skillA

work-story from theam/claude-dev-kit is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add theam/claude-dev-kit/work-story@git:20260923.902ff0d

Pins git:20260923.902ff0d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
theam/claude-dev-kit
Path
plugins/fullstack-dev-kit/skills/work-story/SKILL.md
Versions recorded
4
Latest version
git:20260923.902ff0d, committed Sep 23, 2026
First version recorded
Aug 10, 2026
Size
6,103 bytes
Repository stars
17
License
Apache-2.0

Work a user story end to end — fetch the ticket, plan (with approval), implement, verify the applicable gates, self-review, open the PR, and update the tracker. Use when given an issue key like PROJ-1234, ENG-42, or #123. This is the orchestration playbook for hosts without a dedicated orchestrator subagent (Codex, and other Agent-Plugins clients); on Claude Code the `/work-story` command + `coding-agent` subagent do this instead.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Work Story (orchestration)

You are the story orchestrator. Input: an issue key from the team's tracker. Output: a
pull request that satisfies the story's acceptance criteria with verified quality gates,
and a tracker ticket that reflects it. **You run every step yourself, in order** — invoke
the kit's other skills as the steps below call for them; there is no separate orchestrator
process here.

If no issue reference is given, ask for one — don't guess. Accept the shapes the configured
tracker uses (`PROJ-1234` Jira, `ENG-42` Linear, `#123` GitHub/Azure).

**Stack-agnostic.** Carry no assumptions about language, framework, or test runner. Read the
repo's `AGENTS.md` / `CLAUDE.md` and `.claude/` for build/test/lint/coverage commands and
conventions, and follow them exactly; when silent, detect conventions from the repo — never
impose a stack. The always-on rules in `instructions/secure-coding.md` and
`instructions/testing-standards.md` bind every step.

## 1. Context
- If `.claude/dev-kit.json` is missing, run **`dev-kit-setup`** first (one-time bootstrap:
  tracker, project/team, field IDs).
- Run **`issue-fetch`** for the ticket and show the summary.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add theam/claude-dev-kit/work-story@sha256:6ff4d86844f49790

The line at the top of this page pins the label git:20260923.902ff0d, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_d6hosz5aeqo7bpiw.svg)](https://markdownregistry.com/a/art_d6hosz5aeqo7bpiw)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Aug 10, 2026 and Sep 23, 2026, about one every 15 days.

versioncommittedcommitsizeaudit
git:20260923.902ff0d latest2026-09-23 902ff0d 6,103 BA view · diff
git:20260922.80db7cb2026-09-22 80db7cb 5,851 BA view · diff
git:20260902.b8d21a52026-09-02 b8d21a5 4,809 BA view · diff
git:20260810.7c9ab342026-08-10 7c9ab34 4,385 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6103 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

theam/claude-dev-kit · 17 stars · license Apache-2.0 · pushed 2026-09-28 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_d6hosz5aeqo7bpiw
GET https://markdownregistry.com/api/v1/resolve?ref=theam/claude-dev-kit/work-story
GET https://markdownregistry.com/api/v1/blob/6ff4d86844f49790d0fe886921d425f1dbd441e5851d26e1c9bbf9f398832d75

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from theam/claude-dev-kit

CLAUDE.md CLAUDE.md file
theam/claude-dev-kit · CLAUDE.md
git:20260923.e0a3b91 · audit A · 17 stars
work-story SKILL.md skill
theam/claude-dev-kit · codex/skills/work-story/SKILL.md · Work a user story end to end — fetch the ticket, plan (with approval), implement, verify the applicable gates…
git:20260923.902ff0d · audit A · 17 stars
AGENTS.md@plugins/fullstack-dev-kit AGENTS.md file
theam/claude-dev-kit · plugins/fullstack-dev-kit/AGENTS.md
git:20260810.7c9ab34 · audit A · 17 stars
coverage-check SKILL.md skill
theam/claude-dev-kit · plugins/fullstack-dev-kit/skills/coverage-check/SKILL.md · Run the repo's unit tests with coverage and verify that every file touched in the current change keeps line, branch…
git:20260805.baaab43 · audit A · 17 stars
create-pr SKILL.md skill
theam/claude-dev-kit · plugins/fullstack-dev-kit/skills/create-pr/SKILL.md · Create a branch, commit the work, and open a pull request for a completed user story, after all quality gates pass. Use…
git:20260923.902ff0d · audit A · 17 stars
delegate-backlog SKILL.md skill
theam/claude-dev-kit · plugins/fullstack-dev-kit/skills/delegate-backlog/SKILL.md · Delegate an approved backlog to a real async coding agent (GitHub Copilot coding agent) so several stories are worked…
git:20260928.bca2bd5 · audit A · 17 stars
dev-kit-setup SKILL.md skill
theam/claude-dev-kit · plugins/fullstack-dev-kit/skills/dev-kit-setup/SKILL.md · First-use bootstrap for the dev kit. Detects the team's issue tracker, discovers what it can via MCP/CLI, asks only…
git:20260923.0c1a186 · audit A · 17 stars
e2e-generate SKILL.md skill
theam/claude-dev-kit · plugins/fullstack-dev-kit/skills/e2e-generate/SKILL.md · Create or update end-to-end tests for a user-facing flow that changed, using whatever e2e framework the repo already…
git:20260805.baaab43 · audit A · 17 stars
figma-fetch SKILL.md skill
theam/claude-dev-kit · plugins/fullstack-dev-kit/skills/figma-fetch/SKILL.md · Extract frame/component structure and all visible text from a Figma design URL. Use whenever a prompt or a fetched…
git:20260805.baaab43 · audit A · 17 stars
fix-pr SKILL.md skill
theam/claude-dev-kit · plugins/fullstack-dev-kit/skills/fix-pr/SKILL.md · Resolve the findings on an existing pull request - review comments, CI failures, and self-review findings - driving…
git:20260923.902ff0d · audit A · 17 stars
follow-ups SKILL.md skill
theam/claude-dev-kit · plugins/fullstack-dev-kit/skills/follow-ups/SKILL.md · Turn the loose ends a finished story leaves — out-of-scope notes, deferred review findings, deliberate TODOs — into…
git:20260902.b8d21a5 · audit A · 17 stars
issue-fetch SKILL.md skill
theam/claude-dev-kit · plugins/fullstack-dev-kit/skills/issue-fetch/SKILL.md · Fetch a work item (summary, status, description, acceptance criteria, comments) from the team's issue tracker and…
git:20260923.0c1a186 · audit A · 17 stars

Every file in theam/claude-dev-kit

Other files named work-story

work-story SKILL.md skill
theam/claude-dev-kit · codex/skills/work-story/SKILL.md · Work a user story end to end — fetch the ticket, plan (with approval), implement, verify the applicable gates…
git:20260923.902ff0d · audit A · 17 stars

Browse by kind, by grade A, or by owner.