claudikins-grfp

Github Readme for Perfectionists

ESLint for prose. A Claude Code plugin that treats "delve" as a syntax error.

AI-generated documentation has a smell. You know it when you read it: "This tool delves into the landscape of seamless integration..." - zero information, pure filler. I bet reading that you thought, but this sounds like AI, you're right actually, written before using the plugin.

Before:

This library provides a seamless way to delve into documentation generation, unleashing the full potential of your README workflow.

After:

This plugin generates README files. It bans 15 filler words, enforces sentence patterns that require specifics, and includes humanisation patterns to make AI text sound human.

Quick Start

Install via Claude Code Plugin:

# Add the Claudikins marketplace
/marketplace add aMilkStack/claudikins-marketplace

# Install the plugin
/plugin install claudikins-grfp

Then ask Claude to write a README. The plugin triggers and runs you through 5 phases.

How It Works

flowchart LR
    A["/deep-dive"] --> B["/crystal-ball"]
    B --> C["/brain-jam"]
    C --> D["/think-tank"]
    D --> E["/pen-wielding"]

    A -.- A1["Facts: Stack, structure, friction"]
    B -.- B1["Future: Roadmap, tech debt"]
    C -.- C1["Voice: Angle, tone"]
    D -.- D1["Research: Patterns, badges"]
    E -.- E1["Output: The README"]

Each phase produces artifacts. /deep-dive extracts codebase facts. /crystal-ball identifies what's missing. /brain-jam runs a Claude + Gemini debate to find the voice. /think-tank researches exemplar READMEs. /pen-wielding writes the final output with Anti-Slop rules enforced.

What pen-wielding enforces

The final phase applies four governance files:

• style-guide.md - Banned words, sentence patterns, humanisation techniques, phrase templates
• structural-templates.md - Section ordering by project type, results tables, Do/Don't patterns
• visual-engineering.md - Mermaid diagrams, ASCII progress bars, visual density rules
• anti-patterns.md - Writing anti-patterns, research anti-patterns, quality checklist

Sentence Patterns

Three patterns you must vary between:

The Hook (Pain → Solution)

Use in: Description, Intro

Before	After
"This library helps with JSON parsing issues."	"JSON logs are unreadable. Kinesis parses them instantly."

The Hammer (Fact + Metric)

Use in: Features, Performance

Before	After
"The system is designed to be incredibly fast."	"Builds finish in under 200ms."

The Trust Builder (Constraint + Fallback)

Use in: Usage, Technical sections

Before	After
"Works perfectly on all platforms."	"Uses epoll on Linux; falls back to kqueue on macOS."

Humanisation Patterns

Write TO readers, not AT them.

Weak	Strong	Why
"Users can optionally configure..."	"Configure your preferences in..."	Direct address over passive
"The system enables..."	"This helps you..."	Human over system
"Consider implementing..."	"Implement..."	Commands over suggestions
"We achieved 2.4M reach"	"We reached 2.4M people, 20% above target"	Context makes numbers meaningful

ASCII Visualisations

For lightweight progress and status without images.

Status Indicators