writing-discipline

Rewrites working context into reader-oriented documentation, ADRs, issues, and commit messages.

1|Updated Sep 11, 2026
One-click install
npx skills add https://github.com/rebuildup/my-web-2026 --skill writing-discipline-rebuildup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-discipline
Source: https://github.com/rebuildup/my-web-2026/tree/main/skills/writing-discipline
Command: npx skills add https://github.com/rebuildup/my-web-2026 --skill writing-discipline-rebuildup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI agents hold large amounts of conversation, investigation, and execution context, and dumping that raw context into persistent text produces documents full of scaffolding, chronology, and references only the author understands. This Skill enforces a disciplined writing pipeline so documentation, ADRs, Issues, PRs, commit messages, and comments stand alone as reader-oriented artifacts. ## Core Features & Use Cases - Three-phase writing pipeline: Select communicative content for the audience, Compose standalone prose, then Reread the draft as a reader without the original context. - Artifact-specific guidance: Tailored rules for documentation, ADRs, GitHub Issues, Pull Requests, commit messages, code comments, and review comments. - Temporal information policy: Clear criteria for when version, migration, or history details belong in an artifact versus when they are context leakage. - Use Case: After finishing a debugging session, use this Skill to write the Pull Request description so reviewers see the intent, design decisions, and validation rather than a transcript of trial-and-error. ## Quick Start Use the writing-discipline skill to draft the commit message and PR description for the changes I just made.

Frequently Asked Questions about writing-discipline

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

FAQPage Schema
How do I write better pull request descriptions with an AI agent?

Apply a select-compose-reread pipeline: choose only what reviewers need to evaluate intent, surface, design decisions, and validation, then compose standalone prose and reread it without the task context. Avoid summarizing commit history or trial-and-error.

How to write commit messages that avoid context dumping?

Describe what the commit changes in repository state, not what the author tried during the work. Omit temporary failures and tool invocations, and add brief rationale in the body only when it matters for future maintainers.

What should an ADR contain instead of a meeting transcript?

An ADR should contain the problem structure, constraints, the decision itself, and its consequences so readers can re-evaluate it later. Keep chronology only when it is necessary to understand the decision, not as an investigation log.

When is it acceptable to include dates or history in documentation?

Temporal information is acceptable when it explains version compatibility, migrations, deprecations, incidents, audits, or reproducibility. Current-state details should not be promoted into persistent prose merely because they existed during the work.

Why do AI-generated docs feel unnatural even when correct?

Correctness alone does not produce natural prose; drafts need reader-oriented editing such as removing redundant sentences, fixing transitions, reordering information for comprehension, and merging fragmented bullets. Rereading as a context-free reader exposes these issues.