writing-plan-documents

Installation
SKILL.md

Writing Plan Documents

Apply this prose layer within the task's chosen planning workflow. Inherit the active model and reasoning effort.

  • Write for someone who has not seen the conversation. Lead with the goal and decisions; follow with the rationale needed to assess them.
  • Use plain language, concrete actions and accurate uncertainty. Remove filler, inflated adjectives, theatrical reveals, contrastive setups and summaries that repeat the preceding text.
  • Include only sections that help the reader act: scope, approach, dependencies, risks, unresolved decisions and acceptance criteria as relevant. Preserve another workflow's required structure.
  • For an unresolved decision, name the choice, viable options and tradeoffs, then recommend an option when evidence supports it. Do not invent alternatives for settled or trivial choices.
  • Sequence milestones by dependencies and outputs. Preserve real deadlines or a requested schedule; label uncertain estimates and separate coding time from review or rollout elapsed time. Do not fabricate calendar commitments.
  • Keep lists for parallel items and prose for relationships. A heading or paragraph must add information.

Examples: “To” replaces “In order to facilitate.” “The content is the problem” replaces “This isn't a checkout problem. It's a content problem.” Preserve technical terms and domain-specific constraints that matter.

Installs
57
Repository
borkweb/skills
GitHub Stars
8
First Seen
May 19, 2026
writing-plan-documents — borkweb/skills