npx claudepluginhub robertphyatt/ironclaude --plugin ironclaudeThis skill uses the workspace's default tool permissions.
Apply Strunk & White's writing principles to ALL prose that humans will read: documentation, commit messages, error messages, code comments, API responses, log messages, and user-facing text.
Applies Strunk's Elements of Style rules for clear, concise prose in documentation, commit messages, error messages, UI text, reports, and explanations.
Applies Strunk's Elements of Style rules to edit documentation, commit messages, error messages, UI text, reports, and explanations for clarity and conciseness.
Generates or remediates Markdown documentation with style rules: grounded claims, active voice, imperative docstrings, no jargon or filler. For new docs, AI rewrites, style profiles.
Share bugs, ideas, or general feedback.
Apply Strunk & White's writing principles to ALL prose that humans will read: documentation, commit messages, error messages, code comments, API responses, log messages, and user-facing text.
Adapted from Strunk & White's "The Elements of Style" for technical writing.
Bad:
The reason why we need to do this is because the system requires...
Good:
We need this because the system requires...
Application to code:
Bad:
The file was deleted by the system.
An error was encountered during processing.
Good:
The system deleted the file.
Processing encountered an error.
Application to code:
Bad:
The function might take some time to complete.
There could be issues with the configuration.
Performance may be impacted.
Good:
The function takes 2-5 seconds to complete.
Invalid JSON in config.yml line 23.
Query time increased from 100ms to 2s.
Application to code:
Bad:
Do not forget to save your changes.
Authentication did not succeed.
Good:
Remember to save your changes.
Authentication failed.
Application to code:
Process:
Application to code:
This is a IronClaude addition to Strunk & White principles.
Never use speculative language without evidence:
Forbidden:
Required:
Evidence: [file.py:123] shows X
Conclusion: Therefore Y occurs
Application to code:
Bad:
// This is some real voodoo magic
// TODO: Here be dragons
function doTheThing() { ... }
Good:
// Normalize timestamps to UTC before comparison
function normalizeTimestamp(ts) { ... }
Application to code:
When reviewing any written content:
Step 1: Read it aloud
Step 2: Apply the 7 principles
Step 3: Verify clarity Ask: Can someone with zero context understand this?
Step 4: Present improvements
Original:
[original text]
Suggested revision:
[improved text]
Changes:
- Removed needless words (15 → 10 words)
- Changed passive to active voice
- Made language more specific
- Removed speculation
Bad:
Updated the authentication system to fix some issues that were found
Good:
Fix authentication timeout after 30 seconds
Root cause: Session token TTL exceeded connection pool timeout
Bad:
An error occurred while trying to process your request. This might be due to invalid input or a system issue.
Good:
Invalid JSON at line 23, column 5: Expected ',' but found '}'
Bad:
This function is used to validate user input and it checks various things to make sure the data is correct.
Good:
Validates user input against schema constraints:
- Email format (RFC 5322)
- Password strength (min 12 chars, mixed case, symbols)
- Username uniqueness (case-insensitive)
Bad:
// This is probably needed for backwards compatibility
// TODO: Figure out what this does
const MAGIC_NUMBER = 42;
Good:
// PostgreSQL connection pool size
// Tuned for 100 concurrent users with 30s query timeout
const POOL_SIZE = 42;