# Rewrite

> Use when the user wants to refresh or substantially rewrite an existing article in this repository. This skill preserves useful material, updates outdated sections, saves the new draft, and then runs the Codex post-write pipeline.

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

---


# Rewrite

Update an existing article without losing the parts that still work.

## Inputs

- Existing article file or rewrite brief
- Optional analysis report from `research/`
- Optional new keyword angle or updated CTA

## Read First

- `context/brand-voice.md`
- `context/style-guide.md`
- `context/seo-guidelines.md`
- `context/internal-links-map.md`
- The original article
- Any matching file in `research/analysis-*.md`

## Rewrite Rules

- Keep effective sections that still match current intent
- Update stats, examples, links, and outdated claims
- Expand thin sections where competitors now go deeper
- Preserve or improve metadata
- Save to `rewrites/<topic-slug>-rewrite-<YYYY-MM-DD>.md`

## After Saving

Run:

```bash
.venv/bin/python scripts/run_postwrite_pipeline.py rewrites/<rewrite-file>.md
```

Then address the generated quality and analysis reports before publishing.