# ✍️ Content Writer

> Creates, edits, and publishes posts and pages. Drafts from a description, rewrites for clarity, and optimises titles, excerpts, and structure.

| Field | Value |
|-------|-------|
| Slug | `content-writer` |
| Version | 2.0.0 |
| Category | Content |
| Author | Agentic Community |
| Required Capabilities | `edit_posts` |

## What It Does

Content Writer is a full-featured writing agent that creates, edits, analyses, and publishes WordPress posts and pages. Give it a topic or outline and it will draft a complete post with proper heading structure, then save it as a draft for your review. It can also rewrite existing content for clarity and readability.

Beyond writing, Content Writer analyses posts for readability (Flesch-Kincaid scoring), word count, sentence length, heading structure, and keyword density. It manages categories and tags, assigns authors, sets featured images from the media library, and tracks post performance metrics.

The agent supports full CRUD operations on posts and pages. Write actions (creating, updating, and publishing) require confirmation in supervised mode. Read and analysis tools run without interruption.

## Tools

| Tool | Risk | Description |
|------|------|-------------|
| `list_posts` | None | List posts or pages, filtered by status, type, or search term. |
| `get_post_content` | None | Retrieve the full content, metadata, categories, and tags of a single post or page by ID. |
| `get_site_context` | None | Get site name, description, active categories, common tags, and post/page totals. |
| `get_author_list` | Low | Get the list of WordPress users who can author posts (editors, authors, administrators). |
| `analyze_post` | None | Analyse a post for readability (Flesch-Kincaid score), word count, sentence length, heading structure, image presence, internal/external links, and SEO keyword density. |
| `create_post_content` | Medium | Create a new WordPress post or page. Saves as draft by default. Supports scheduling with `status: "future"` and a `publish_date`. |
| `update_post_content` | Medium | Update an existing post or page. Only the fields you supply are changed; omitted fields are left as-is. |
| `manage_categories` | Medium | List existing categories, create a new category, or get posts in a specific category. |
| `manage_tags` | Medium | List the most-used tags, create a new tag, or get all tags on a specific post. |
| `search_media_library` | None | Search the WordPress media library for images and files by keyword, MIME type, or date range. |
| `set_featured_image` | Medium | Set a media library image as the featured image (post thumbnail) for a post or page. |
| `get_post_performance` | None | Get performance metrics for a post: word count, comment count, category/tag counts, age, and analytics data from Site Kit or Jetpack if available. |
| `rewrite_for_readability` | None | Analyse a post's readability structure and return a detailed report with actionable suggestions. Does NOT modify the post. |

## Example Prompts

- "Write a blog post about sustainable gardening tips"
- "Schedule a post about summer sales for April 1st at 9am"
- "Analyse the readability of post #42"
- "List my recent drafts"
- "Rewrite the intro of post #15 to be more engaging"
- "Set a featured image on my latest post"
- "Create a new category called 'Case Studies' and tag post #20 with 'featured'"
- "How is my latest blog post performing — views, comments, word count?"

---

_Generated by Agent Builder for WordPress_
