josh-writing-voice

Rewrites prose in Josh's personal writing voice with plain language, active voice, and British spelling.

Updated May 18, 2024
One-click install
npx skills add https://github.com/joshhornby/dotfiles --skill josh-writing-voice-joshhornby
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: josh-writing-voice
Source: https://github.com/joshhornby/dotfiles/tree/main/.claude/skills/josh-writing-voice
Command: npx skills add https://github.com/joshhornby/dotfiles --skill josh-writing-voice-joshhornby

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Drafting or editing blog posts, docs, and talks in a consistent personal voice is hard, and AI-generated text often drifts into lists, jargon, and recognisable AI patterns. This Skill applies a defined voice profile to prose and then runs a cleanup pass for AI tells. ## Core Features & Use Cases - Voice Rewriting: Applies eight concrete rules — simple words, prose over lists, varied sentence rhythm, active voice, British spelling, concrete examples over adjectives, natural links, and no AI tells. - Humanizer Orchestration: Delegates AI-pattern detection to the separate humanizer skill rather than duplicating its checks, invoking it via the Skill tool after the voice pass. - Batch Sweeps: Processes directories of posts in a read → voice pass → humanizer loop, summarising files touched and flagging passages it was unsure about. - Use Case: Ask it to review all Jekyll blog posts for voice consistency; it rewrites each file surgically, bumps the lastmod front matter field on changed files, and reports what changed and why. ## Quick Start Ask the assistant to rewrite a draft blog post in Josh's writing voice and run the humanizer pass on the result.

Frequently Asked Questions about josh-writing-voice

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make AI-written text sound like a specific person's voice?

Define explicit voice rules — word choice, sentence rhythm, list usage, spelling conventions — and apply them as surgical edits rather than full rewrites. This skill encodes eight such rules and keeps existing phrasing where it already works.

How to remove AI writing patterns from a blog post?

Run a dedicated AI-pattern detection pass after the voice edit. This skill delegates that step to the separate humanizer skill via the Skill tool instead of duplicating its checks, catching phrases like "delve" or "it's worth noting".

Can this skill edit multiple blog posts at once?

Yes, it supports sweep-style requests across a directory of posts. It processes each file in a read, voice pass, humanizer loop, then summarises files touched and common issues, flagging passages it could not confidently rewrite.

Does it update Jekyll front matter when editing posts?

Yes, for blog and Jekyll files it bumps the lastmod field in the front matter on anything it changed. Other front matter fields are left untouched.

When should I not use a personal voice profile for editing?

Avoid it for text not published under Josh's name, such as team documentation with its own style guide or quoted third-party material. The rules are specific to one person's voice and would distort other authors' writing.