doccraft-story

doccraft-story is a skill for Claude Code from alexpialetski/doccraft. It costs 110 tokens per session (3,331 once invoked), scanned A, original, MIT.

A writing skill for creating and updating product stories: Markdown planning records such as backlog items, tickets, and specifications.

In plain words
What is it for?
Use it for stories in `docs/stories/`, including creating them, changing their status or priorities, and closing them with the related queue updates.
Why use it?
It keeps these records consistent by requiring structured YAML details, clear acceptance criteria, and links to related work.

Skill for Claude Code

Written for Claude Code: installed under .claude/.

Good fit Use it for stories in docs/stories/, including creating them, changing their status or priorities, and closing them with the related queue updates.

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

Made for: Claude Code.

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 doccraft-story

README.md
[![agentmods](https://agentmods.dev/badge/skills/alexpialetski/doccraft/doccraft-story/github.svg)](https://agentmods.dev/skills/alexpialetski/doccraft/doccraft-story)
Your own site
<a href="https://agentmods.dev/skills/alexpialetski/doccraft/doccraft-story"><img src="https://agentmods.dev/badge/skills/alexpialetski/doccraft/doccraft-story/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 doccraft-story

Your own site · 80×15
<a href="https://agentmods.dev/skills/alexpialetski/doccraft/doccraft-story"><img src="https://agentmods.dev/badge/skills/alexpialetski/doccraft/doccraft-story.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 110 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,331 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.00110 $0.03331
Opus 5 $0.00055 $0.01665
Sonnet 5 $0.00022 $0.00666
Haiku 4.5 $0.00011 $0.00333

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

Security

Grade A, and why

doccraft-story 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/doccraft-story/SKILL.md · 270 lines

How it starts

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

Managed by doccraftdoccraft update regenerates this file. Local edits will be overwritten. See doccraft.json to override project-specific vocabulary and paths without touching this file.

doccraft — planning stories

When to use

  • Creating a new story in docs/stories/.
  • Updating status, acceptance criteria, tags, or openspec on an existing story.
  • When closing a story: update docs/queue.md and the Status column in docs/backlog.md. See Workflow reminders for queue-audit invocation rules.

YAML frontmatter (required fields)

Use valid YAML between --- delimiters at the top of the file. Every field marked yes MUST be present — do not omit any. If the user has not provided enough information to fill a required field, ask — NEVER guess.

Field Required Values / notes
id yes Stable, unique id across all stories. P0.3 when aligned to docs/backlog.md, or a slug like story-2026-001. MUST be unique — verify before writing.
title yes Short human-readable title.
status yes One of the values in story.status config (default: todo | in_progress | done). Manual updates only.
impact yes One of the values in story.impact config (default: H | M | L). If the user does not specify, ask.
urgency yes One of the values in story.urgency config (default: now | soon | later). If the user does not specify, ask.
tags yes YAML list of prefixed strings (area:, slice:, theme:) from the tag vocabulary below. If nothing fits and the label will recur, extend the vocabulary in doccraft.yaml in the same change.
openspec yes MUST be set to one of: not-needed | recommended | required. See openspec guidance below.
updated yes ISO date YYYY-MM-DD. MUST be set on creation and updated on every meaningful edit.
roadmap_ref optional e.g. P1.7 — pointer to the backlog row when applicable.
depends_on optional YAML list of story id values that MUST be satisfied before this story is picked up (prerequisites). Omit or [] if none. Each entry MUST match another story's id or a backlog id you intentionally treat as external — prefer real story ids so the queue-audit graph stays honest.
adr_refs optional List of ADR filenames this story implements or contradicts (e.g. 001-foo.md).
openspec_change optional Path or name of the OpenSpec change folder when one exists.

Read the full file on GitHub · 270 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. 9d ago First seen · 270 lines · 110 tokens per session scan A e828b68ed937

Subscribe to this mod's changes

doccraft-story is a skill published in the GitHub repository alexpialetski/doccraft (4 stars, last pushed 3mo ago), licensed MIT. It adds 110 tokens to every session and 3,331 once invoked, about $0.0006 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

comprehensive-enrichment

Enrich any person or company from any identifier — email, name, LinkedIn URL, domain, company name, Twitter/X handle. Use when asked to enrich, look up, or research a lead, contact, person, or company.

gooseworks-ai/goose-skills · 53 tokens

create-workflow-diagram

Create FigJam/Miro-style workflow diagrams as high-quality PNG images from plain-text workflow descriptions. Renders beautiful HTML diagrams with connected nodes, arrows, and labels, then screenshots them for sharing.

gooseworks-ai/goose-skills · 45 tokens

data-charts-tako

Search and visualize the world's data - get charts, insights, and embeddable knowledge cards for finance, economics, demographics, sports, and more.

gooseworks-ai/goose-skills · 35 tokens

email-finder-hunter

Email finder and verifier - find emails, verify deliverability, discover companies.

gooseworks-ai/goose-skills · 20 tokens

lead-discovery

Orchestrator that runs first for lead generation requests. Gathers business context via website analysis or questions, identifies competitors, builds ICP, and routes to signal skills with pre-filled inputs.

gooseworks-ai/goose-skills · 41 tokens

meta-ad-scraper

Scrape competitor ads from Meta's Ad Library (Facebook, Instagram, Messenger, Threads, WhatsApp). Search by company name, Facebook Page URL, or keyword. Returns ad creatives, spend estimates, reach, impressions, and campaign details. Use for competitive ad research, messaging analysis, and creative inspiration.

gooseworks-ai/goose-skills · 67 tokens