Wp Readme Optimizer

Reviews and rewrites WordPress.org plugin readme.txt files for maximum quality. Use this skill whenever a user pastes, uploads, or references a WordPress plugin readme.txt, or asks to improve, audit, review, score, or optimize a plugin's WordPress.org listing page. Also trigger when the user says things like "make my plugin page better", "optimize my readme", "help me rank higher on WordPress.org", or "review my plugin listing". Always run the full audit + rewrite workflow unless the user explicitly asks for only one part.

110 stars 10 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add jdevalk/skills --skill wp-readme-optimizer
Manual install
git clone --depth 1 https://github.com/jdevalk/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/wp-readme-optimizer ~/.claude/skills/wp-readme-optimizer

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 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 `` and proceed with your best guess.
Read the full skill on GitHub

Details

Skill name
wp-readme-optimizer
Repository
jdevalk/skills
Path
wp-readme-optimizer/SKILL.md
License
MIT
Repo updated
5 July 2026

FAQ

What does the Wp Readme Optimizer skill do?

Reviews and rewrites WordPress.org plugin readme.txt files for maximum quality. Use this skill whenever a user pastes, uploads, or references a WordPress plugin readme.txt, or asks to improve, audit, review, score, or optimize a plugin's WordPress.org listing page. Also trigger when the user says things like "make my plugin page better", "optimize my readme", "help me rank higher on WordPress.org", or "review my plugin listing". Always run the full audit + rewrite workflow unless the user explicitly asks for only one part.

How do I install the Wp Readme Optimizer skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add jdevalk/skills --skill wp-readme-optimizer. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Wp Readme Optimizer popular?

It lives in jdevalk/skills, which has 110 GitHub stars and 10 forks.

Related skills

Emdash Github Actions

110

jdevalk/skills

Sets up GitHub Actions CI/CD workflows for EmDash plugins — TypeScript type-checking, ESLint linting, Vitest testing, npm publishing, and automated releases. ALWAYS use this skill when a user wants to create, add, set up, or configure GitHub Actions, CI/CD, automated checks, or deployment workflows for an EmDash plugin — even if they don't use the exact phrase "GitHub Actions". This includes any request to: add automated type-checking or linting to an EmDash plugin repo; set up testing in CI for a plugin; auto-publish a plugin to npm from GitHub; add security scanning or dependency auditing to

Git & Code Review10

Astro Github Actions

110

jdevalk/skills

Sets up GitHub Actions CI/CD workflows for Astro sites — `astro check` (TypeScript + content schema), ESLint, Prettier, build verification, Vitest testing, Lighthouse CI, link checking, npm audit, and automated deployment to GitHub Pages, Cloudflare Pages, Netlify, or Vercel. ALWAYS use this skill when a user wants to create, add, set up, or configure GitHub Actions, CI/CD, automated checks, or deployment workflows for an Astro site — even if they don't use the exact phrase "GitHub Actions". This includes any request to: add automated type-checking or linting to an Astro repo; set up `astro ch

Git & Code Review10

Astro SEO

110

jdevalk/skills

Audits and improves SEO for Astro sites. Use when the user asks to audit, set up, or improve SEO on an Astro site, or mentions head metadata, structured data, JSON-LD, sitemaps, IndexNow, Open Graph images, schema endpoints, NLWeb, hreflang, or search engine indexing in an Astro project. Produces drop-in code routed through `@jdevalk/astro-seo-graph` and chains into `metadata-check` for generated SEO strings.

Marketing, Sales & Business10

Call Cross Lingual Emotion Preservation

116

CALLE-AI/awesome-phone-call-agents

Offline experimental QA helper for CALL-E relay transcripts. Compares English urgency-marker levels in source and relay-agent text; both inputs must be English or operator-prepared English translations. Returns advisory lexical drift labels and suggested relay wording, without translating, measuring emotional state, certifying relay fidelity or placing calls.

Writing & Content512

Content Risk Detector

58

liuxingqitd/content-risk-detector

检测短视频逐字稿是否违反抖音、小红书、视频号的社区规范,识别违规风险点,提供分级风险报告和具体修改建议。触发词: "内容合规检测"、"逐字稿检测"、"风险检测"、"短视频合规"、"平台规范检测

Writing & Content10

Call Politeness Strategy Auditor

116

CALLE-AI/awesome-phone-call-agents

Offline experimental CALL-E helper that grades agent request phrasing against Stanford-politeness strategy markers, flagging bald imperatives ("Give me your date of birth.") and condescension markers, with a softened-request goal template; not a rudeness judgment, a content-scope check, or authorization to act.

Writing & Content512

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.