The vast majority of the documents people use to do business are really quite poor. Presentations that make your eyes glaze over, memos that are inscrutable or unclear, and all kinds of artifacts that say more about how they were created than whatever message they were ostensibly trying to communicate. It's been one of my great frustrations for years, and a big part of why I wrote Make Better Documents a while ago. That post captured a list of the suggestions I've been giving people for years on how to make better, more effective documents that can actually do work for you, instead of fighting at cross purposes to your larger goals.

To my great surprise, that list of suggestions on how to make better documents got a pretty huge response, and a lot of people told me they found it really helpful. So now, I've created a Better Documents skills.md file for people who use LLM tools like Claude to help assist them in creating business documents, to prompt their AI tools to make better documents by default.

If you're not familiar, agent skills are simple text files that describe new capabilities or processes that LLMs can take advantage of when carrying out tasks. (They're Markdown files — more proof of how Markdown is taking over the world!) The way this skill works is that it's distilled the broad principles I outlined in that post into a series of 5 tests, covering areas like whether you've properly considered your target audience, whether the overall structure is correct, if you've overdone things with your formatting, and if things are named clearly, and then either generates a new file that follows those rules, or reviews an existing document to make sure it is obeying best practices.

It's nothing too fancy, but I've been using it for a while, and shared it with a few friends, and people have told me they found it handy and it's improved some of their routine documents. I'm especially glad that people have found it useful even if they're the kind of folks who would never let an LLM generate a document on their behalf, but do think software tools are useful for things like spell check or grammar check. I see this as being a tool in that kind of category.

If you're familiar with skills, the install process is really simple and works just like any other skill. This skill is totally free and open source (if you have improvements, send along a pull request on GitHub, or if you're not a coder type, just email me or hit me up on social media and let me know what fixes/suggestions you've got), so there are no encumbrances or restrictions on its use. I am curious if it's useful to people, especially if you find it handy to use more broadly at a company, so don't be shy to get in touch if you find it valuable.

Here's to us all enduring fewer terrible presentations!