Unfuck Claude — Development skill for Claude Code
Comments are bad for agents.
How to install Unfuck Claude
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open dogekiller21/unfuck-claude and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Unfuck Claude does
Comments are bad for agents. Let them read code, not your docstrings
Alternatives in Development
- Let Fate Decide — Trail of Bits security skill for let fate decide 3.7k ★
- Remove Comments — Remove Obvious Comments 2.8k ★
- 3D Portfolio — Let's build a cool 3D website together 1.3k ★
README
unfucked
Code describes itself. A comment is a defect budget, not documentation.
One marketplace, two plugins:
| plugin | what it adds | install when |
|---|---|---|
unfucked |
/unfucked:unfucked loads the comment rules into the session; /unfucked:unfuck-comments fixes an existing codebase |
you want the rules on demand and a fixer |
unfucked-extended |
a hook injects the rules into every session and subagent; another hook checks every Edit / Write and hands violations back to the agent as an error |
you want the agent unable to forget |
They are independent. `unfucked-extended` carries its own copy of the rules, so it works without the base plugin; install both to also have the fixer.
Install
claude plugin marketplace add dogekiller21/unfuck-claude
claude plugin install unfucked@unfucked
claude plugin install unfucked-extended@unfucked
Or from inside a session: `/plugin marketplace add dogekiller21/unfuck-claude`, then `/plugin install unfucked@unfucked` and `/plugin install unfucked-extended@unfucked`. Restart the session; hooks load on start.
The marketplace is named `unfucked` in its manifest, hence `@unfucked` even though the repo is `unfuck-claude`.
Off: `claude plugin disable unfucked-extended`.
Commands
`/unfucked:unfucked` — prints the rules into context. With `unfucked-extended` installed this happens automatically; run it by hand only to re-assert the rules late in a long session.
`/unfucked:unfuck-comments [paths] [instructions]` — the fixer. No arguments: uncommitted work, or the whole repo if there is none. Paths, globs, or a git range: exactly those. Free text is an instruction for that run ("keep the TODOs"). Reports one line per file.
What the hook checks
Mechanical rules only. Semantic ones (a comment that restates the name, a docstring that repeats the signature) stay with the agent, which has the rules in context.
| check | example that fails |
|---|---|
| history | `# now we don't close the con |
Related Skills
Revise From Comments
Prototype - Read the open comments on a published page, revise the source HTML, report per comment
CheckFile
Check that docstrings match implementation in a given file
Add Docstrings
Add or improve docstrings for the public API of a file or symbol.
Bad Daves Robot Army
Display the comprehensive guide to Bad Dave's Robot Army capabilities
Negative Keyword Sweep
Find wasted spend in Google Ads search terms and add negatives at the right scope (account list, campaign, or
Downvote
Reduce confidence or archive an instinct that gave bad advice
Related Agents
Filter Tuner
Looks at what the deterministic filter and the AI scoring kept or rejected, finds the rules that let bad offer
Comment Analyzer
Use this agent when you need to analyze code comments for accuracy, completeness, and long-term maintainabilit
Code Cleaner
Python code cleaning specialist. Removes excessive comments, applies DRY principles, adds professional docstri