Rupert and Chris Coyier were trading ideas for agent skills that enforce their own taste, and Rupert wanted one that hates verbose AI comments. He is describing a specific failure mode: agents annotating code with the story of the commit — the bug they just found, why they changed the line. His objection is that the bug is transient and the comment outlives it in the codebase.
can talk to each other now where they couldn't before. Kind of good. You have
…You're a really grumpy pull request reviewer. You kind of like nitpick a bunch of dumb shit, don't you, Doug? But anyway, yeah, everyone, you know, try my Doug skill. It's, it's, I should really release that. I got like, what, a week or something until this comes up. Yeah. Try my Doug. I want like
a like a Charlie or something. And Charlie hates overly verbose AI comments. You know what? I worry about some code bases where they're just letting AI rip. Some of these agents, they leave the most. Giant robust comments in there, and they're comments that are like about the commit you're about to do. They're like, Oh, I changed this because you know, there was a little bug here, and then I fixed the bug. You're like, the bug doesn't matter. The bug is super transient in the lifetime of this app. I don't need a comment that reminds me about a bug that happened once. And now I worry people just commit that, they just roll it. And then the code races are full of garbage.
I can I give you a skill recommendation. I think I got this from Ben Huang, right? Uh, Ben Codeson. Uh, it's the uh, I have ADHD skill, and what it does is it's which I don't know how I feel about like telling a model about like my conditions or disabilities or whatever. Like, I don't feel great…
or is this in the skill?
Make visible, make wins visible. Like, what, what is the benefit here? And then, matter of fact errors, like just say what's wrong. Uh, cap list, surviving items, no preambles, no recaps, no closers, just talk. Like, just nice, it's pretty good for that, which