Claude skill and Obsidian plugin to proofread your English writing

Share on Hacker News

I created a proofreading skill for Claude Code to help me with English writing as a non-native speaker. This was initially a CC-only skill, but quickly enough, editing turned out tedious.

Claude Code output
How did the skill output look in the Claude Code

I iterated on it and made a complementary Obsidian plugin that renders skill findings in the Obsidian UI.

The skill classifies findings into four categories:

  1. Mechanical: grammar, typos, wrong articles, prepositions, commas, verb forms, double negatives, and more (sourced from D. Hacker’s “A Writer’s Reference” and J. Williams’s “Style: Lessons in Clarity and Grace”)
  2. Vocabulary: words you are talking around (sourced from D. Hacker’s “A Writer’s Reference”)
  3. Clutter: words to remove or replace (sourced from W. Zinsser’s “On Writing Well”)
  4. Clarity: weak endings, long openers, delayed subjects, missing words, misplaced modifiers, and more (sourced from D. Hacker and J. Williams)

How Does It Work? Copy link to this section

The Claude Code skill puts findings into the .proofread directory in the root of your Obsidian vault, as a JSON file. The plugin uses this file to highlight what you need to either fix or dismiss directly in the Obsidian UI.

Obsidian plugin finding
How a finding looks

You can click on the finding to fix it in the modal window, or dismiss it if you believe it was marked as a false positive. Dismissed findings won’t reappear.

Who Is It For? Copy link to this section

For those who don’t delegate writing to AI and want to deliberately practice it instead. AI guides you, never writes a piece for you.

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
  2. Open your vault in Obsidian
  3. Enable the Proofread plugin
  4. Open your vault in Claude
  5. Open a file you want to proofread in Obsidian
  6. Tell Claude to use the proofread skill on the file
  7. Wait for Claude to finish its analysis
  8. Fix/dismiss findings in Obsidian
  9. Repeat steps 6 - 8 until you are satisfied with the results

← Posts