Wp Readme Optimizer

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).

Infer by asking: "If a WordPress site owner needed this plugin, what would they type into the search bar?" Look at the plugin name, tags, and the first paragraph. If confidence is low, add <!-- Couldn't confidently infer primary keyword --> and proceed with your best guess.

All scoring in Phase 1 is evaluated against this inferred keyword.

---

Phase 1: Audit

Scoring

Score each of the 8 sections below out of 10 (total /80). Show a summary table at the top of the audit. Score ranges: 65-80 strong (polish only), 45-64 solid with gaps, 25-44 significant problems, 0-24 bare minimum.

For each section, write 2-5 specific findings. A finding should name the problem, explain why it matters, and suggest a fix. Never be generic -- always refer to the actual content.

What to evaluate per section

Plugin Name & Tags

• Is the name descriptive of what the plugin does, not just a brand name?
• Does it include the primary keyword users would search for?
• Are up to 5 tags used? Are they the right ones -- high-volume, specific to the plugin's function?
• Would a stranger immediately understand what the plugin does from the name alone?

Short Description (<=150 chars)

• Does it lead with the user's problem or benefit, not the plugin's name?
• Is it under 150 characters (hard limit -- truncation kills CTR)?
• Does it contain the primary keyword naturally?
• Is it specific (avoid vague claims like "powerful", "easy", "best")?
• Does it end before 150 chars -- not mid-sentence?

Long Description

• Does the first paragraph act as a strong hook -- benefit-led, not feature-led?
• Is the primary keyword used in the first 150 words?
• Are there H2/H3 headings to break up the text (using == Heading == syntax)?
• Are features presented as user benefits, not just a bullet dump?
• Is there social proof -- active installs, ratings, notable users?
• Is there a clear call to action (e.g. link to Pro, docs, or demo)?
• Does it include FAQ-style content or video embeds for richness?
• Are secondary/long-tail keywords naturally woven in?

Installation

• Are the steps numbered and complete?
• Does it cover both manual (FTP) and automatic (dashboard) methods?
• Are there any post-activation steps mentioned?

FAQ

• Are the questions things real users actually ask (check support forum topics if possible)?
• Do the answers contain keywords naturally?
• Is there at least one question that surfaces a common objection or concern?
• Are questions phrased the way a user would type them, not how a developer would write them?