Comment by Swizec
25 days ago
> And to me, AI should best be used to add rocket fuel to existing practices
The more your codebase follows best practices and consistent patterns, the better AI will do and the faster you can move.
Same as humans really, just even faster. I'm also excited that people are finally writing docs and without even any flogging! They're calling the docs "skills" but hey whatever works
My main grief with AI-generated docs is that they (unless the instructions were very clear on this) by default describe the path to the current code and how it is an improvement over what was before, instead of just explaining its purpose. I see this all the time when reviewing other people's code... Fortunately it is easy to add a generic instruction to project-wide CLAUDE.md to avoid this problem, but it would be nice if this skill came out of the box.
Just put in your config prompt that you want comments explaining why something was done and how it works
Of course - but I would like others to do it too. :-)
I have recently needed to read a skill document because it was more understandable and more through than the official document.