durable-writing

Write issue bodies and persistent documents that avoid stale claims and duplicated work.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/pdw96/ai-production-risk-early-warning --skill durable-writing-pdw96
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: durable-writing
Source: https://github.com/pdw96/ai-production-risk-early-warning/tree/main/.claude/skills/durable-writing
Command: npx skills add https://github.com/pdw96/ai-production-risk-early-warning --skill durable-writing-pdw96

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Hand-maintained status text in issues, docs, and artifacts silently goes stale: completion declarations, counts, and copied summaries become false as soon as the underlying facts change, and duplicate issues get opened because stale local state was trusted. ## Core Features & Use Cases - Three-layer placement rules: Separates rules (CLAUDE.md, checks), state (issues, milestones, labels, PRs), and durable records (artifacts, docs/) so each fact lives where it stays true. - Stale-content prohibitions: Bans completion declarations, censuses, enumerations, checkboxes, and copied issue summaries from persistent documents; distinguishes event dates from expiring 'current state' claims. - Four-line issue body format: Structures every issue as why / closing condition / expectations or order (when present) / where to look. - Pre-issue duplicate check: Requires comparing open issues, PR merged fields, merge commit titles, and origin/main code after running git fetch before creating an issue. - Use Case: Before opening a GitHub issue or writing a status update into a design doc, apply these rules so the text remains true next month and no duplicate issue number is burned. ## Quick Start Review my draft issue body and this documentation paragraph, and rewrite them so nothing in them will silently go stale.

Frequently Asked Questions about durable-writing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write GitHub issue bodies that stay useful over time?

Use a four-line structure: why the work matters, the closing condition, expectations or ordering when relevant, and where to look. Keep status and progress out of the body since those belong in labels, milestones, and PR state that update as a byproduct of work.

What should I avoid putting in long-lived documentation?

Avoid completion declarations, counts, enumerations of items, checkboxes, and copied summaries of other issues. Dates describing past events are fine, but statements about the current state become false once time passes.

How do I avoid creating duplicate GitHub issues?

Run git fetch origin main first, then check the open issue list, PR merged fields, merge commit titles, and the actual code on origin/main. Stale local state causes you to miss already-merged work and burn an irreversible issue number.

Where should project status live instead of documents?

Status belongs in issues, milestones, labels, and pull requests, where updates happen as a byproduct of doing the work. Documents and artifacts should hold only records and rationale that remain true over time.

When should I update other documents after fixing a fact?

Whenever you change a fact, update every place that summarizes or quotes it, because prose has no machine checking those pairs. A single merged change can silently stale multiple documents if the paired references are not updated together.