WordPress Plugin readme.txt Optimizer

This skill reviews a WordPress.org plugin readme.txt file with a structured audit, scores each section, and then produces a fully rewritten version. The goal is higher visibility in the WordPress.org plugin directory, better conversion of visitors to installs, and a more trustworthy plugin page.

Rewrite recipes live in AGENTS.md — read it when producing the rewritten readme.

Workflow

1. Read the readme.txt — If a file is attached, read it. If the user pasted content, use that. If neither, ask the user to provide the readme.txt content.
2. Infer the target keyword — Before scoring, identify what keyword(s) this plugin should rank for. This anchors the entire audit.
3. Run the audit — Score each section and write specific, actionable findings.
4. Produce the rewrite — Deliver a drop-in replacement readme.txt, incorporating all audit findings. Follow the recipes in AGENTS.md.

Phase 0: Keyword Inference

Before scoring, output: Primary keyword (the 2-3 word phrase most likely to drive installs), Secondary keywords (3-4 supporting terms), Inferred from (plugin name / tags / description), Confidence (high / medium / low).