design-content-research
Produces WordPress draft posts from research findings — converts Paper Store research records or raw research data into publishable blog posts, buying guides, brand spotlights, and how-to articles. Us
SKILL.md.agents/skills/design-content-research/SKILL.md
GitHubContent Research → Post Pipeline
Use this skill when research findings need to become WordPress content — blog posts, buying guides, brand profiles, or landing pages.
Available Tool
| Tool | Purpose |
|---|---|
create_post_from_research |
Convert a Paper Store research record or raw JSON data into a WordPress draft post |
create_post |
Direct WordPress post creation with images, charts, categories, tags, and meta |
save_post |
Create or update a post by ID |
For simple post creation (non-research content), use create_post directly:
create_post {
title: "Post Title"
content: "HTML content here"
post_type: "post"
status: "draft"
categories: ["category-slug"]
tags: ["tag1", "tag2"]
content_images: [{ source: 123, position: "start" }]
}
Use save_post to update an existing post by passing post_id.
WP-CLI Commands
Key mcp-ai WP-CLI commands for research-to-post workflows. Run via terminal:
| Command | Use for |
|---|---|
wp mcp-ai content |
Search existing posts to avoid duplicate topics |
wp mcp-ai paper-store list |
List available research records in Paper Store collections |
wp mcp-ai paper-store read |
Read a specific Paper Store research record before conversion |
wp mcp-ai bulk |
Batch-create multiple posts from research records |
When to use this skill
Trigger when ANY of the following is true:
- Research is complete and needs to become a WordPress post or page.
- The task asks to "turn this research into a post" or "create a blog post from findings".
- Converting a Paper Store research record into published content.
- Building a buying guide, brand spotlight, or educational article from research data.
- The task mentions "post from research", "research to content", or "publish the findings".
create_post_from_research — Research → WordPress Post
Takes structured research and creates a WordPress draft. Can pull from Paper Store records or accept raw JSON data directly.
Parameters
paper_store_record_id — Paper Store record ID to convert (required if no `data`)
paper_store_collection — Collection containing the record (required with record_id)
data — Raw research data object (alternative to Paper Store)
Must include "title". Can include "report" (content),
"description" (excerpt), and "sources".
post_type — WordPress post type (default: "post")
post_status — "draft" or "pending" (default: "draft")
category_id — Category term ID to assign
tags — Array of tag strings
author_id — User ID for post author (default: current user)
update_paper_status — Auto-update Paper Store record to "published" after creation
Workflow A: From Paper Store
1. Research is stored in Paper Store (e.g., from deep_research or research_product)
2. create_post_from_research {
paper_store_record_id: "conatural-brand-profile"
paper_store_collection: "research-reports"
post_type: "post"
post_status: "draft"
category_id: 2046 // CoNatural category
tags: ["conatural", "skincare", "brand-spotlight", "sri-lanka"]
update_paper_status: true
}
3. Review the draft in WordPress admin
4. Edit, add images, optimize SEO
5. Publish when ready
Workflow B: From Raw Data
1. Research is complete but not in Paper Store
2. create_post_from_research {
data: {
title: "The Ultimate Guide to Layering Fragrances for Sri Lanka's Climate"
report: "In Sri Lanka's tropical humidity, fragrance layering is both
an art and a science. Here's how to make your scent last..."
description: "Master fragrance layering for long-lasting scent in
tropical weather. Expert tips for Sri Lankan perfume lovers."
sources: ["https://source1.com", "https://source2.com"]
}
post_type: "post"
post_status: "draft"
category_id: 123 // Blog category
tags: ["fragrance-tips", "layering", "tropical-climate", "sri-lanka"]
}
3. Review and publish
Post Types
| Post Type | Use For |
|---|---|
post (default) |
Blog articles, buying guides, brand spotlights |
page |
Landing pages, evergreen guides, about pages |
product |
WooCommerce product pages (if WooCommerce is active) |
Status Selection
| Status | When |
|---|---|
draft |
Standard — review and edit before publishing |
pending |
Editorial workflow — needs editor approval |
Content Types This Pipeline Supports
1. Brand Spotlights
Research → Post about a brand The Parfumerie carries
Example: "Inside Conatural: The Women-Led Skincare Brand Taking
Sri Lanka by Storm"
2. Buying Guides
Research → Educational guide helping customers choose
Example: "EDP vs EDT vs Parfum: Which Fragrance Concentration
Is Right for You?"
3. Trend Reports
Research → Article about industry trends
Example: "5 Fragrance Trends Dominating Sri Lanka in 2026"
4. How-To Guides
Research → Instructional content
Example: "How to Make Your Perfume Last All Day in Sri Lanka's Humidity"
5. Gift Guides
Research → Curated product recommendations
Example: "The Parfumerie's Ultimate Gift Guide: Fragrance, Jewelry & Skincare"
Post Creation Checklist
Before creating the post, verify:
□ Research is complete and accurate
□ Title is SEO-optimized (brand + topic + key differentiator)
□ Content has a clear structure (H2/H3 headings, short paragraphs)
□ Sources are cited where relevant
□ Category and tags are assigned
□ Post status is appropriate (draft for review, pending for editorial)
□ update_paper_status is set if the research record should be marked as published
After creation:
□ Review the draft in WordPress admin
□ Add featured image (use generate_gemini_image_validated if needed)
□ Optimize meta description (see design-seo-content)
□ Add internal links to products and related posts
□ Preview before publishing
Paper Store Integration (on request)
The pipeline naturally integrates with Paper Store:
Store → Research → Create Post → Mark Complete
↑ ↓
└────────── Future reference ────────┘
1. paper_store_write: Save research
2. create_post_from_research: Convert to WordPress draft
3. update_paper_status: true — mark the research as "published"
4. paper_store_read: Retrieve later for updates or repurposing
When explicitly asked, use connection_id to target the correct site:
paper_store_write {
connection_id: "conn_8srcad8zylhe"
collection: "research-reports"
...
}
Critical Rules
- Research before posting — never create a post from incomplete or unverified research.
- Draft first, publish later — always create as
draftorpending. Review before publishing. - One post per research record — don't try to cram multiple topics into one post.
- Assign categories and tags — posts without taxonomy are hard to find and organize.
- Update Paper Store status — if the research is done, mark it as published.
- SEO follows creation — after the draft exists, run through
design-seo-contentfor optimization.
Common Mistakes
WRONG:
● Publishing directly (skip review) — always draft first
● No category or tags assigned — post becomes orphaned
● Creating a post from thin research — verify findings first
● Forgetting to set update_paper_status — Paper Store record stays "draft" forever
● Cramming 5 research topics into one post — one topic, one post
RIGHT:
✅ Draft → review → optimize → publish workflow
✅ Category + 3–5 relevant tags per post
✅ Research verified and cited before posting
✅ update_paper_status: true when research is complete
✅ One clear topic per post
What This Skill Does NOT Cover
- Conducting the actual research (web search, deep research) — use
design-deep-researchordesign-web-research. - SEO optimization of the resulting post — use
design-seo-contentafter draft creation. - Publishing or scheduling the post — use
save_post(status: "publish") orschedule_social_post. - Creating featured images for the post — use
design-image-generation. - Managing Paper Store collections and records directly — use
paper_store_write/paper_store_read/paper_store_searchtools. - Product-specific research for WooCommerce — use
design-product-research. - Writing social media posts promoting the content — use
design-social-content.
Cross-references
- Run
design-deep-researchfor the research that feeds this pipeline — usedeep_research. - Run
design-web-researchfor quick fact checks and source URLs — useweb_searchandrun_crawl4ai_job. - Run
design-product-researchfor product-specific research — useresearch_product. - Run
design-seo-contentto optimize the draft post for search engines. - Run
design-image-generationto create a featured image — usegenerate_gemini_image_validated. - Run
design-campaign-orchestrationto integrate the post into a monthly content calendar. - Use
paper_store_*withconnection_idto persist research before converting to posts.