AI Content Writer — Skill Instructions

Overview

AI Content Writer is an end-to-end blog autopilot powered by Citedy. It covers the entire content production pipeline in a single conversation:

Research — source URLs or topic input, optional web intelligence search
Write — SEO & GEO-optimized articles in 55 languages, 4 size presets
Enhance — AI illustrations, voice-over audio, internal link optimization, humanization
Distribute — social media adaptations for 9 platforms (X, LinkedIn, Facebook, Reddit, Threads, Instagram, Instagram Reels, YouTube Shorts)
Automate — cron-based autopilot sessions, scheduling, webhook notifications

No competitor offers the full pipeline in one agent skill.

When to Use

Use this skill when the user wants to:

Write a blog article from a topic or URL
Create social media posts from an existing article
Set up automated daily/weekly content publishing
Manage a product knowledge base for AI-grounded articles
Schedule and fill content calendar gaps
Generate micro-posts across multiple platforms at once
Select a writing persona (25 available)

Setup

1. Get an API Key

Direct the user to: https://www.citedy.com/dashboard/settings → Team & API section.

API keys are prefixed citedy_agent_.

2. Register the Agent

POST https://www.citedy.com/api/agent/register
Content-Type: application/json

{
  "name": "My Content Agent",
  "description": "Automated blog content writer"
}

Headers: Authorization: Bearer <CITEDY_API_KEY>

Response:

{
  "agent_id": "ag_xxxx",
  "status": "active",
  "blog_handle": "my-blog"
}

Store agent_id — it is required for session and webhook operations.

3. Verify Connection

GET https://www.citedy.com/api/agent/me
Authorization: Bearer <CITEDY_API_KEY>

Core Workflows

Workflow 1: URL to Article

Convert any web page, blog post, or competitor article into an original SEO-optimized article.

POST https://www.citedy.com/api/agent/autopilot
Authorization: Bearer <CITEDY_API_KEY>
Content-Type: application/json

{
  "source_urls": ["https://example.com/some-article"],
  "language": "en",
  "size": "standard",
  "illustrations": true,
  "audio": false
}

After generation, adapt for social:

POST https://www.citedy.com/api/agent/adapt
Authorization: Bearer <CITEDY_API_KEY>
Content-Type: application/json

{
  "article_id": "<returned_article_id>",
  "platforms": ["linkedin", "x_article"],
  "include_ref_link": true
}

Workflow 2: Topic to Article

Write an article from a plain-text topic or title.

POST https://www.citedy.com/api/agent/autopilot
Authorization: Bearer <CITEDY_API_KEY>
Content-Type: application/json

{
  "topic": "How to reduce churn in B2B SaaS",
  "language": "en",
  "size": "full",
  "persona": "saas-founder",
  "enable_search": true
}

Workflow 3: Turbo Mode (Fast & Cheap)

For quick content at low cost. Two sub-modes:

| Mode | Credits | Description | | -------- | --------- | ---------------------------------- | | turbo | 2 credits | Fast generation, no web search | | turbo+ | 4 credits | Fast generation + web intelligence |

POST https://www.citedy.com/api/agent/autopilot
Authorization: Bearer <CITEDY_API_KEY>
Content-Type: application/json

{
  "topic": "5 productivity hacks for remote teams",
  "mode": "turbo",
  "language": "en"
}

For turbo+, add "enable_search": true.

Workflow 4: Social Adaptations

Adapt an existing article to up to 3 platforms per request.

POST https://www.citedy.com/api/agent/adapt
Authorization: Bearer <CITEDY_API_KEY>
Content-Type: application/json

{
  "article_id": "art_xxxx",
  "platforms": ["x_thread", "linkedin", "reddit"],
  "include_ref_link": true
}

Available platforms: x_article, x_thread, linkedin, facebook, reddit, threads, instagram, instagram_reels, youtube_shorts

Workflow 5: Autopilot Session (Automated Publishing)

Set up recurring content generation on a cron schedule.

POST https://www.citedy.com/api/agent/session
Authorization: Bearer <CITEDY_API_KEY>
Content-Type: application/json

{
  "categories": ["SaaS", "productivity", "remote work"],
  "problems": ["user churn", "onboarding friction", "team alignment"],
  "languages": ["en"],
  "interval_minutes": 720,
  "article_size": "standard",
  "disable_competition": false
}

interval_minutes: 720 = every 12 hours. Sessions run automatically and publish articles to the connected blog.

Workflow 6: Micro-Post

Publish short-form content across platforms without writing a full article first.

POST https://www.citedy.com/api/agent/post
Authorization: Bearer <CITEDY_API_KEY>
Content-Type: application/json

{
  "topic": "Why async communication beats meetings",
  "platforms": ["x_thread", "linkedin"],
  "tone": "professional",
  "contentType": "tip",
  "scheduledAt": "2026-03-02T09:00:00Z"
}

Workflow 7: Knowledge Base (Products)

Ground articles with real product data. The AI references this during generation.

Add a product:

POST https://www.citedy.com/api/agent/products
Authorization: Bearer <CITEDY_API_KEY>
Content-Type: application/json

{
  "name": "Citedy Pro",
  "description": "AI-powered blog automation platform",
  "url": "https://www.citedy.com/pricing",
  "features": ["autopilot", "SEO optimization", "55 languages"]
}

List products:

GET https://www.citedy.com/api/agent/products
Authorization: Bearer <CITEDY_API_KEY>

Search products:

POST https://www.citedy.com/api/agent/products/search
Authorization: Bearer <CITEDY_API_KEY>
Content-Type: application/json

{
  "query": "pricing plans"
}

Delete a product:

DELETE https://www.citedy.com/api/agent/products/<product_id>
Authorization: Bearer <CITEDY_API_KEY>

Workflow 8: Schedule Management

Check what content is planned and find gaps.

GET https://www.citedy.com/api/agent/schedule
GET https://www.citedy.com/api/agent/schedule/gaps
GET https://www.citedy.com/api/agent/schedule/suggest

Note: schedule/suggest is a REST-only endpoint — not available as an MCP tool.

All require Authorization: Bearer <CITEDY_API_KEY>.

Workflow 9: Publish

Publish or schedule a social adaptation.

POST https://www.citedy.com/api/agent/publish
Authorization: Bearer <CITEDY_API_KEY>
Content-Type: application/json

{
  "adaptationId": "adp_xxxx",
  "action": "schedule",
  "platform": "linkedin",
  "accountId": "acc_xxxx",
  "scheduledAt": "2026-03-02T10:00:00Z"
}

action values: now, schedule, cancel

Examples

Example 1: Write Article from URL

User: "Write an article based on this post: https://competitor.com/best-crm-tools"

Agent flow:

Call POST /api/agent/autopilot with source_urls: ["https://competitor.com/best-crm-tools"], size: "standard", language: "en" — typically returns the full article inline (terminal status: "generated" | "publishing" | "published"); if the response is queued (status: "processing"), poll GET /api/agent/articles/{id} or wait for one of the article.generated / article.published / article.failed webhooks. On article.failed (or terminal status: "failed"), surface the error and skip the social-adaptations step
Return article title, URL, and word count to user
Ask: "Want social media adaptations? Which platforms?"

Example 2: Daily Autopilot

User: "Set up daily articles about fintech in English and Spanish"

Agent flow:

Call POST /api/agent/session with categories: ["fintech", "payments", "banking"], languages: ["en", "es"], interval_minutes: 720, article_size: "standard"
Confirm session ID and next scheduled run
Optionally register webhook to notify user on each article completion

Example 3: Turbo Mode

User: "Quickly write 5 short articles about remote work tips"

Agent flow:

For each topic, call POST /api/agent/autopilot with mode: "turbo", size: "mini"
Run calls sequentially or note rate limits
Return list of generated article titles and links

Example 4: Social Adaptations

User: "Take my latest article and make posts for LinkedIn, Reddit, and X"

Agent flow:

Call GET /api/agent/articles to find the latest article ID
Call POST /api/agent/adapt with platforms: ["linkedin", "reddit", "x_thread"], include_ref_link: true
Return each adaptation with preview text
Ask: "Want to publish now or schedule?"

API Reference

POST /api/agent/autopilot

Generate a full blog article.

| Parameter | Type | Required | Description | | --------------------- | -------- | ------------------------ | ------------------------------------------------------------------------------------- | | topic | string | one of topic/source_urls | Article topic or title | | source_urls | string[] | one of topic/source_urls | URLs to base the article on | | language | string | no | Language code, default en. 55 languages supported | | size | string | no | mini, standard, full, pillar. Default standard | | mode | string | no | standard, turbo. Default standard | | enable_search | boolean | no | Enable web intelligence. Default false | | persona | string | no | Writing persona slug (call GET /api/agent/personas, e.g. "musk", "hemingway", "jobs") | | auto_publish | boolean | no | Publish immediately after generation. Default uses tenant setting (if unset, true) | | illustrations | boolean | no | Generate AI illustrations. Default false | | audio | boolean | no | Generate voice-over audio. Default false | | disable_competition | boolean | no | Skip competitor analysis. Default false |

Response:

{
  "article_id": "art_xxxx",
  "status": "processing",
  "estimated_seconds": 45,
  "credits_reserved": 20
}

GET /api/agent/articles

List generated articles.

| Parameter | Type | Description | | --------- | ------- | ------------------------------------------------------ | | status | string | Filter: generated (draft), published, processing | | limit | integer | Max results, default 20 | | offset | integer | Pagination offset |

POST /api/agent/articles/{id}/publish

Publish a draft article (status: "generated" → "published").

0 credits.
Returns { article_id, status: "publishing", message }.
Only works on articles with status: "generated". Other statuses return 409 Conflict.
Fires article.published webhook event.

PATCH /api/agent/articles/{id}

Unpublish a published article (status: "published" → "generated").

{ "action": "unpublish" }

0 credits.
Returns { article_id, status: "generated", message }.
Only works on articles with status: "published". Other statuses return 409 Conflict.
Fires article.unpublished webhook event.

DELETE /api/agent/articles/{id}

Permanently delete an article and its associated storage files (images, audio).

0 credits. Irreversible. Credits are NOT refunded.
Returns { article_id, message: "Article deleted" }.
Fires article.deleted webhook event.

POST /api/agent/adapt

Create social media adaptations from an article.

| Parameter | Type | Required | Description | | ------------------ | -------- | -------- | --------------------------------------- | | article_id | string | yes | Source article ID | | platforms | string[] | yes | 1–3 platforms per request | | include_ref_link | boolean | no | Append article backlink. Default true |

Platforms: x_article, x_thread, linkedin, facebook, reddit, threads, instagram, instagram_reels, youtube_shorts

POST /api/agent/publish

Publish or schedule an adaptation.

| Parameter | Type | Required | Description | | -------------- | ------ | -------- | -------------------------------------- | | adaptationId | string | yes | Adaptation ID from /adapt | | action | string | yes | now, schedule, cancel | | platform | string | yes | Target platform | | accountId | string | yes | Connected social account ID | | scheduledAt | string | no | ISO 8601 datetime for scheduled action |

POST /api/agent/session

Create an automated content session.

| Parameter | Type | Required | Description | | --------------------- | -------- | -------- | -------------------------------------------------- | | categories | string[] | yes | Topic categories for generation | | problems | string[] | no | Specific problems or pain points to cover | | languages | string[] | no | Language codes. Default ["en"] | | interval_minutes | integer | no | Generation interval, 60-10080. Default 720 (12h) | | article_size | string | no | mini, standard, full, pillar | | disable_competition | boolean | no | Skip competitor analysis. Default false |

POST /api/agent/post

Create and publish a micro-post.

| Parameter | Type | Required | Description | | ------------- | -------- | -------- | ----------------------------------------------------- | | topic | string | yes | Post topic | | platforms | string[] | yes | Target platforms | | tone | string | no | professional, casual, humorous, authoritative | | contentType | string | no | tip, insight, question, announcement, story | | scheduledAt | string | no | ISO 8601 datetime. Omit for immediate |

GET /api/agent/personas

List all available writing personas.

No parameters required.

Response: Array of persona objects with slug, name, description, style.

GET /api/agent/settings

Get current agent/blog settings.

PUT /api/agent/settings

Update agent/blog settings.

| Parameter | Type | Description | | ------------------ | ------- | ------------------------------- | | default_language | string | Default article language | | default_size | string | Default article size | | auto_publish | boolean | Auto-publish generated articles | | default_persona | string | Default persona slug |

POST /api/agent/products

Add a product to knowledge base.

| Parameter | Type | Required | Description | | ------------- | -------- | -------- | -------------------- | | name | string | yes | Product name | | description | string | yes | Product description | | url | string | no | Product landing page | | features | string[] | no | Key features list |

GET /api/agent/products

List all products in knowledge base.

POST /api/agent/products/search

Semantic search over knowledge base.

| Parameter | Type | Required | Description | | --------- | ------ | -------- | ------------ | | query | string | yes | Search query |

DELETE /api/agent/products/:id

Remove a product from knowledge base.

GET /api/agent/schedule

Get current content schedule (upcoming articles, sessions).

GET /api/agent/schedule/gaps

Find gaps in the content calendar where no articles are scheduled.

GET /api/agent/schedule/suggest (REST only, not MCP tool)

Get AI-suggested topics to fill schedule gaps based on existing content and SEO opportunities.

POST /api/agent/webhooks

| Parameter | Type | Required | Description | | --------- | -------- | -------- | --------------------------- | | url | string | yes | HTTPS endpoint URL | | events | string[] | yes | Event types to subscribe to | | secret | string | no | HMAC signing secret |

GET /api/agent/webhooks

List registered webhooks.

DELETE /api/agent/webhooks/:id

Remove a webhook registration.

GET /api/agent/webhooks/deliveries

Get recent webhook delivery history with status codes and payloads.

GET /api/agent/health

Check API availability.

GET /api/agent/me

Get current agent profile, blog info, and credit balance.

GET /api/agent/health

Check API health and readiness.

Response:

{
  "status": "ok",
  "version": "3.0.0"
}

Pricing

All costs in credits. 1 credit = $0.01 USD.

Article Generation

| Size | Standard Mode | Description | | ---------- | ------------- | ---------------------------- | | mini | 15 credits | ~500 words, quick post | | standard | 20 credits | ~1,000 words, full article | | full | 33 credits | ~2,000 words, in-depth piece | | pillar | 48 credits | ~4,000 words, pillar content |

Turbo Mode

| Mode | Cost | Notes | | -------- | --------- | ----------------------- | | turbo | 2 credits | Fast, no web search | | turbo+ | 4 credits | Fast + web intelligence |

Extensions

| Extension | Cost | | ---------------------------- | --------------------------------------------- | | +Intelligence (web search) | +8 credits | | +Illustrations (per article) | +9–36 credits depending on count | | +Audio voice-over | +10–55 credits depending on length & language |

Micro-Post

| Endpoint | Cost | | ----------------- | --------- | | /api/agent/post | 2 credits |

Social Adaptations

~5 credits per platform per article.

Knowledge Base

Products storage is free. Semantic search costs minimal credits per query.

Persona List

25 writing personas available. Pass the slug to /api/agent/autopilot. Call GET /api/agent/personas for the full dynamic list.

Example slugs: "musk", "hemingway", "jobs", "saas-founder", "investigative-reporter", "science-communicator", "business-journalist", "cto-engineer", "data-scientist", "marketing-strategist", "comedian-writer", "lifestyle-blogger", "newsletter-writer", "academic-researcher", "creative-storyteller"

Webhook Event Types

Subscribe to these events when registering a webhook:

| Event | Triggered When | | ----------------------------- | ------------------------------------ | | article.generated | Article generation completed | | article.published | Article published (auto or manual) | | article.unpublished | Article unpublished (→ draft) | | article.deleted | Article permanently deleted | | article.failed | Article generation failed | | social_adaptation.generated | Social post adaptation created | | session.articles_generated | Recurring session published articles | | billing.credits_low | Balance below threshold | | billing.credits_empty | Balance at 0 |

Rate Limits

| Endpoint | Limit | | ---------------------- | ------------------- | | /api/agent/autopilot | 10 requests/minute | | /api/agent/adapt | 20 requests/minute | | /api/agent/post | 30 requests/minute | | /api/agent/products | 60 requests/minute | | All other endpoints | 120 requests/minute |

Rate limit headers are included in all responses: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Limitations

Social adaptation: maximum 3 platforms per /api/agent/adapt call
Autopilot: source_urls maximum 5 URLs per request
Knowledge base: maximum 500 products per account
Webhooks: maximum 10 registered endpoints per account
Article sizes above standard may take 60–180 seconds to generate
turbo and turbo+ modes do not support illustrations or audio
Language support varies by persona — not all personas support all 55 languages

Error Handling

All errors follow a consistent structure:

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Not enough credits to complete this operation",
    "required": 20,
    "available": 5
  }
}

Common Error Codes

| Code | HTTP Status | Description | | ---------------------- | ----------- | -------------------------------- | | UNAUTHORIZED | 401 | Invalid or missing API key | | INSUFFICIENT_CREDITS | 402 | Not enough credits | | RATE_LIMITED | 429 | Too many requests | | ARTICLE_NOT_FOUND | 404 | Article ID does not exist | | INVALID_PLATFORM | 400 | Unknown platform slug | | SESSION_CONFLICT | 409 | Active session already exists | | GENERATION_FAILED | 500 | AI generation error — retry safe |

Agent Response Guidelines

When an error occurs:

INSUFFICIENT_CREDITS — Inform the user of current balance and required credits. Direct to: https://www.citedy.com/dashboard/billing
RATE_LIMITED — Wait for Retry-After header value before retrying. Do not spam requests.
GENERATION_FAILED — Retry once after 10 seconds. If it fails again, report the error and suggest trying a different topic or smaller size.
UNAUTHORIZED — Guide the user to check their API key at https://www.citedy.com/dashboard/settings.

Response Guidelines for the Agent

Always show the user the article title and URL after successful generation
Article generation usually returns the article inline. Check the /api/agent/autopilot response status:
- "generated", "publishing", or "published" (success-terminal) → the article payload is in the response; present title, URL, and word_count to the user.
- "failed" (failure-terminal) → there is no usable article. Surface the error (error.message or error.code) to the user and follow your retry/fallback path. Do not treat this as a success.
- "processing" or any other non-terminal value (e.g. when the transform pipeline returns 202 admission, or when async generation is requested) → use the response id/article_id and poll GET /api/agent/articles/{id} until status reaches a terminal value, or wait for the corresponding webhook (article.generated, article.published, article.failed).
Present credit costs before starting expensive operations (full/pillar articles, audio)
After generating an article, proactively offer social adaptations
After social adaptations, offer to publish or schedule
For autopilot sessions, confirm interval and categories with the user before creating

Want More?

This skill covers the full content writing pipeline. Citedy also offers:

Video Shorts — AI UGC viral video generation with voice and subtitles for TikTok, Reels, and YouTube Shorts
Trend Scouting — Daily trending topic discovery from Hacker News, Reddit, and social signals
Content Ingestion — Convert any YouTube video, podcast, or long-form document into a blog article
SEO Intelligence — Competitor gap analysis, keyword tracking, and SERP monitoring

Explore the full suite: https://www.citedy.com/tools

citedy-content-writer

AI Content Writer — Skill Instructions

Overview

When to Use

Setup

1. Get an API Key

2. Register the Agent

3. Verify Connection

Core Workflows

Workflow 1: URL to Article

Workflow 2: Topic to Article

Workflow 3: Turbo Mode (Fast & Cheap)

Workflow 4: Social Adaptations

Workflow 5: Autopilot Session (Automated Publishing)

Workflow 6: Micro-Post

Workflow 7: Knowledge Base (Products)

Workflow 8: Schedule Management

Workflow 9: Publish

Examples

Example 1: Write Article from URL

Example 2: Daily Autopilot

Example 3: Turbo Mode

Example 4: Social Adaptations

API Reference

POST /api/agent/autopilot

GET /api/agent/articles

POST /api/agent/articles/{id}/publish

PATCH /api/agent/articles/{id}

DELETE /api/agent/articles/{id}

POST /api/agent/adapt

POST /api/agent/publish

POST /api/agent/session

POST /api/agent/post

GET /api/agent/personas

GET /api/agent/settings

PUT /api/agent/settings

POST /api/agent/products

GET /api/agent/products

POST /api/agent/products/search

DELETE /api/agent/products/:id

GET /api/agent/schedule

GET /api/agent/schedule/gaps

GET /api/agent/schedule/suggest (REST only, not MCP tool)

POST /api/agent/webhooks

GET /api/agent/webhooks

DELETE /api/agent/webhooks/:id

GET /api/agent/webhooks/deliveries

GET /api/agent/health

GET /api/agent/me

GET /api/agent/health

Pricing

Article Generation

Turbo Mode

Extensions

Micro-Post

Social Adaptations

Knowledge Base

Persona List

Webhook Event Types

Rate Limits

Limitations

Error Handling

Common Error Codes

Agent Response Guidelines

Response Guidelines for the Agent

Want More?