readme-expert

README Expert uses validation-first methodology to generate accurate, comprehensive README files by:

Anti-Hallucination Core: Research shows AI README hallucinations occur in 3-27% of outputs. This skill reduces that to near-zero through systematic verification.

| No README exists | CREATE NEW | 1 (Full Workflow) | | README exists but incomplete | CREATE NEW | 1 (Full Workflow) | | README exists, check accuracy | VALIDATE | 2 (Validation Only) | | Update sections of README | CREATE NEW | 1 (Partial execution) | | Verify scripts still work | VALIDATE | 2 (Focus Layer 3) |

Create comprehensive, accurate README.md files with anti-hallucination validation. USE WHEN: Creating new README, updating existing README, validating README accuracy, or ensuring documentation matches actual codebase. PRIMARY TRIGGERS: "create README" → Full creation workflow (scan → generate → validate → test) "update README" → Partial update with validation "validate README" → Validation-only workflow "check README accuracy" → Anti-hallucination audit KEY FEATURES: - Codebase scanning for accurate facts - 5-layer anti-hallucination validation - Script execution testing - Citation tracking for all claims - Template-based structure selection DIFFERENTIATOR: Every claim verified against actual codebase. No assumptions, no hallucinations. Script execution testing ensures examples work. Source: rfxlamia/claude-skillkit.