Claude skill and Obsidian plugin to proofread your English writing

I created a proofreading skill for Claude Code to address skill issues I have in English writing as a non-native speaker. I could point it at any file I worked on.

The skill listed:

• Mechanical errors: typos or wrong articles
• Words I was talking around
• Clutter (based on the rules from the “On Writing Well”)

I designed it up front to only list findings. It wasn’t allowed to rewrite. So my workflow was:

• write a piece in Obsidian
• point Claude Code with that skill at the file
• fix findings in Obsidian based on output from the CC TUI

This turned out tedious. I had feedback in a different window from the content. Claude listed line numbers I couldn’t easily correlate with the exact spot to fix without CTRL+F-ing it.

When I was writing the about page I realized that skill findings could be extended beyond the Claude TUI into Obsidian through a custom plugin to support in-place highlighting. I created obsidian-proofread plugin.

Obsidian Plugin and Claude Skill #

Copy link to this section

The plugin looks for a .proofread directory in the root of your Obsidian vault. The CC skill puts its findings there, as the JSON files. It takes that as input and highlights what you need to either fix or dismiss directly in the Obsidian UI.

There are three types of errors: mechanical, vocabulary and clutter. You can hover over findings to see type of error. You can click on the finding to fix it in the modal window, or dismiss it if you believe it was marked as false-positive. Dismissed findings won’t re-appear.

Installation

Copy link to this section

Claude skill:

/plugin marketplace add codomaniac/skills
/plugin install proofread@codomaniac

Obsidian plugin: https://community.obsidian.md/plugins/proofread

How to work with it

Copy link to this section

1. Install both the plugin and the skill (see above)
2. Open your vault in Obsidian
3. Enable the Proofread plugin
4. Open your vault in Claude
5. Tell Claude to use the proofread skill on files you wish to check
6. Open the file you asked Claude to proofread in Obsidian
7. Fix/dismiss highlights
8. Repeat 5 - 7 until you are satisfied with the results