how-to-technical-writing: simple words rule and shared writing checklist - #60
Merged
Merged
Conversation
Rewrite the style guide in its own plain style, rename the connectives rule to "simple words; preserve technical words", and move the writing checklist (guidelines 1-5, 7) from review-paper into how-to-technical-writing/checklist.md so the writing guide has one home. review-paper/checklist.md keeps only the review-process items (gate, verification, journal fit, delivery), rewritten in short sentences. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018cc6n2NyTUNUDQ7LhzZDur
Member
Author
Self-review
|
…t skills Delete test, trust the structure, define at the point of need, pointer not restatement, pay every promise, no drifting duplicates, and set up before calculating. Each has a hunt row and a checklist item. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018cc6n2NyTUNUDQ7LhzZDur
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018cc6n2NyTUNUDQ7LhzZDur
This reverts commit 0ca9c10.
GiggleLiu
commented
Sep 12, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Observation
The style guide told authors to use plain connectives, but the intended rule was broader: explain ideas with simple words rather than fancy ones. The review-paper checklist also broke the guide's own sentence rules, and the writing rubric lived in
review-paperwhile the writing rules lived inhow-to-technical-writing.Issue
Two homes for the writing guide drift apart, and a checklist that ignores its own rules is a poor model for the prose it reviews.
Fix
how-to-technical-writing/SKILL.mdin its own plain style.skills/how-to-technical-writing/checklist.md, the single source of truth for the writing guide.skills/review-paper/checklist.mdkeeps only the review-process items (gate, verification, journal fit, delivery), rewritten as short sentences.review-paper/SKILL.md,write-paper/SKILL.md, and CLAUDE.md. Ignore.lavish/.Verification
python3 scripts/validate_skills.pypasses;pytest -qreports 247 passed.🤖 Generated with Claude Code
https://claude.ai/code/session_018cc6n2NyTUNUDQ7LhzZDur