# Optimize

> Use when the user wants a final SEO optimization pass on an article in this repository. This skill runs the Codex analysis pipeline, reviews the reports, and then applies fixes directly in the article.

- Skill: `pa4uslf/optimize` (Agent Skill)
- Install (CLI): `npx skillmds@latest add pa4uslf/optimize`
- Raw SKILL.md: https://api.skillmd.com/api/skills/pa4uslf/optimize/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: pa4uslf (https://skillmd.com/u/pa4uslf)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/pa4uslf/optimize

---


# Optimize

Run a final audit for a draft or rewrite and then apply the highest-leverage fixes.

## Inputs

- A local article file, usually from `drafts/` or `rewrites/`
- Optional `site_url` or SERP data path if available

## Required Actions

1. Run:

```bash
.venv/bin/python scripts/run_optimize_pipeline.py <article-file>
```

2. Read the generated report:

- `drafts/optimization-report-<article>.md` or the same directory equivalent

3. Apply the important fixes directly to the article
4. Re-run the optimize pipeline if the changes are substantial

## Optimization Priorities

- Missing or weak keyword placement
- Meta title / description quality
- Readability problems
- Thin sections
- Missing links
- Structure issues
- Low composite quality score

## Codex-Specific Notes

- Do not depend on implicit agent execution from the Claude version.
- The script provides deterministic analysis; Codex should provide the judgment and rewriting.