diataxis-documentation-guidance
Diataxis Documentation Guidance
Use this skill to help documentation contributors and maintainers produce mode-correct, actionable docs as defined by https://diataxis.fr/.
Routing
Pick the entry point by user intent:
- Classification or mode selection requests: read
references/decision-flow.md - Drafting or rewriting requests: read
references/drafting-guide.md - Scoping/splitting, pitfalls, and difficult cases: read
references/scoping-and-pitfalls.md - Concrete examples for each mode: read
references/examples.md
If the request combines classification and drafting, classify first with references/decision-flow.md, then draft with references/drafting-guide.md.
Output Contract
For classification-only responses, return exactly four labeled parts:
More from robdefeo/agent-skills
amazon-working-backwards
Guide the Amazon Working Backwards process from the 5 Questions through to a full PR-FAQ document. Use when the user wants to (1) draft answers to the Amazon 5 Questions for a proposal or idea, (2) refine or critique existing 5Q answers, (3) verify and challenge 5Q answers with probing questions, (4) generate a PR-FAQ document from 5Q answers, (5) review or critique an existing PR-FAQ against Amazon standards, or (6) clarify any element of the 5Q or PR-FAQ process. Triggers include mentions of "5 questions," "PR-FAQ," "PRFAQ," "working backwards," "press release FAQ," Amazon-style proposals, or requests to write/review product proposals in Amazon format.
476para-second-brain
Use this skill when the user wants to organize, classify, or maintain a PARA-method second brain. Triggers include asking where to file something, distinguishing projects from areas, processing an inbox, setting up a new project, completing or archiving a project, running a monthly review, validating system structure, or finding stale/orphaned content.
322pr-create
Use this skill whenever the user wants to create, open, or raise a new GitHub pull request from the current branch — including phrasings like \"open a PR\", \"raise a PR\", \"make a PR\", \"ship this\". Drafts a Conventional Commits title and a Summary body that explains *why* and *what*, respects `.github/pull_request_template.md` when present, auto-links referenced issues, waits for approval, then pushes and opens the PR. Assumes commits already exist. Requires `gh` CLI.
5pr-address-feedback
Use this skill whenever the user wants to address, respond to, work through, or handle GitHub PR review comments — including code review feedback, reviewer suggestions, bot comments, or requested changes — even if they don't say \"address\". Handles the full end-to-end workflow: fetch threads, plan fixes, commit, push, and reply. Requires `gh` CLI.
4