reviewing-writing
Reviewing Writing (Nielsen's Principles)
Analyze writing against Michael Nielsen's 8 principles of craft. Accept input as a file path argument, or review text from the current conversation.
Input Handling
- If the user provides a file path as an argument, read that file
- If no argument, look for writing shared in the current conversation
- If neither, ask the user to provide text or a file path
Analysis Process
Read the full text first. Then evaluate against each principle using the rubric in ./nielsen-principles.md.
For each principle:
- Rate it: Strong / Needs Work / Weak
- Quote specific passages that succeed or violate the principle
- For violations, provide a concrete rewrite suggestion
More from tdhopper/dotfiles2.0
creating-pull-requests
Use this skill when creating or updating pull requests. Ensures proper PR formatting with active-voice titles and structured descriptions explaining why, how, and context links. Also use when the user says "update PR", "refresh PR description", "rewrite PR", or wants to sync a PR's title/description with the current branch state.
10stop-slop
Use this skill when writing or editing prose to eliminate predictable AI writing patterns. Helps make writing more direct, authentic, and human.
9commit
Use this skill when creating a git commit
8reviewing-code
Review pull requests, branch changes, or code diffs. Triggers on "review this PR", "review my changes", "code review", "review branch", or GitHub PR URLs. Focuses on bugs, tests, complexity, and performance - not linting.
8managing-dotfiles
Use this skill when working with personal dotfiles managed by yadm. This includes pulling remote changes, committing and pushing dotfile changes, modifying configuration files (shell, editor, terminal, git, etc.), viewing tracked files, resolving merge conflicts, and maintaining the dotfiles repository. For work dotfiles, use the managing-work-dotfiles skill instead.
8managing-work-dotfiles
Use this skill when working with work-specific dotfiles managed by yadm-work. This includes pulling remote changes, committing and pushing work dotfile changes, modifying work configuration files, viewing tracked work files, resolving merge conflicts, and maintaining the work dotfiles repository at Spotify GHE. Triggers on "work dotfiles", "yadm-work", "spotify dotfiles", or work-related config management.
4