writing-refine

Analyzes documents for AI writing artifacts across seven categories and rewrites them preserving intent.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/francojc/dotfiles --skill writing-refine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-refine
Source: https://github.com/francojc/dotfiles/tree/main/.pi/agent/skills/writing-refine
Command: npx skills add https://github.com/francojc/dotfiles --skill writing-refine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify AI writing artifacts in documents and rewrite them to improve authenticity and readability without changing the author’s intended meaning.

Core Features & Use Cases

  • Seven-category analysis detects vocabulary artifacts, hedging, structural monotony, voice and tone inconsistencies, formatting problems, technical artifacts, and unsupported generalizations.
  • Rewrites maintain meaning and author intent while removing detectable AI patterns.
  • Useful for drafts, reports, and academic papers that require a natural, human-authored voice and polished presentation.

Quick Start

Use the writing-refine skill to scan a draft, flag AI-writing patterns across seven categories, and produce a corrected, human-authored version.

Frequently Asked Questions about writing-refine

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

FAQPage Schema
How do I remove AI writing artifacts from a document draft?

To remove AI writing artifacts from a document draft, use a seven-category analysis pass to detect vocabulary, hedging, voice, and structural monotony, then rewrite the text while preserving your original intent.

What are common AI writing artifacts to look for in long-form content?

Common AI writing artifacts in long-form content include vocabulary artifacts, structural monotony, voice inconsistencies, formatting problems, technical artifacts, hedging, and unsupported generalizations requiring document cleanup.

How do I make AI generated text sound more authentic?

To make AI generated text sound more authentic, analyze the document to detect AI patterns across seven categories and rewrite the flagged passages to enforce a natural, human-authored voice without altering the intended meaning.

Can I clean up AI drafts without changing the original meaning?

Yes, you can clean up AI drafts without changing the original meaning by applying style-improvement techniques that preserve author intent while rewriting detected artifacts and marking uncertain passages for human review.

Does this writing analysis work for academic papers and reports?

Yes, this writing analysis works for academic papers and reports by scanning drafts to flag AI-writing patterns and producing a corrected version suitable for contexts requiring a polished, human-authored presentation.

What happens to uncertain passages during AI document cleanup?

During AI document cleanup, the analysis marks uncertain passages for human review rather than automatically rewriting them, ensuring you maintain control over the final voice, tone, and meaning of the corrected document.