# Send Kitful SEO Article Writer to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "kitful",
    "name": "Kitful SEO Article Writer",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/eashish93/kitful",
    "canonicalUrl": "https://clawhub.ai/eashish93/kitful",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/kitful",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kitful",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "kitful",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-04T18:09:26.454Z",
      "expiresAt": "2026-05-11T18:09:26.454Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kitful",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kitful",
        "contentDisposition": "attachment; filename=\"kitful-1.0.4.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "kitful"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/kitful"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/kitful",
    "downloadUrl": "https://openagent3.xyz/downloads/kitful",
    "agentUrl": "https://openagent3.xyz/skills/kitful/agent",
    "manifestUrl": "https://openagent3.xyz/skills/kitful/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/kitful/agent.md"
  }
}
```
## Documentation

### Kitful — AI Article Generator

Generate humanized, SEO-ready long-form articles from a keyword or topic. Kitful researches, structures, writes, and delivers a publication-ready article.

### Setup (one time)

Get an API key at https://kitful.ai/settings → API Keys.

Add it to ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "kitful": {
        "apiKey": "kit_your_key_here"
      }
    }
  }
}

Optional env vars:

"env": {
  "KITFUL_SPACE_SLUG": "my-blog",
  "KITFUL_BRAND_URL": "https://yourproduct.com"
}

KITFUL_SPACE_SLUG — default workspace slug (only needed if you have multiple workspaces)
KITFUL_BRAND_URL — your brand/product URL to weave into every article

Restart OpenClaw after saving. That's it.

### From a keyword or topic

"Write an article about intermittent fasting for beginners"
"Best noise-cancelling headphones under $200"
"Remote work productivity tips, in French"
"TypeScript generics — promote my product subtly"
"How to start a podcast in 2025, how-to guide format"
"Side-by-side comparison of Notion vs Obsidian for CTOs"
"Benefits of cold showers — aggressive product promotion"
"10 best standing desks for home offices, for busy professionals"

### With extra context

"Write about AI burnout for startup founders — skeptical tone, no fluff"
"Freelance pricing guide for designers, mention my agency at https://myagency.com"
"Long-form article on sourdough bread baking, for my cooking blog workspace"
"Write a listicle on SaaS pricing strategies, in Spanish"

### Guided (not sure what to say)

Just say "kitful" with nothing else — you'll be asked one simple question.

### Batch (tech users)

Ask for multiple topics in one message — Kitful generates them sequentially and links each when done:

"Write articles about: cold brew coffee, pour over technique, French press guide"
"Generate 3 articles: React Server Components, Next.js App Router, Turbopack intro"

### Step 1 — Input detection

Keyword/topic — extract:

focusKeyword — the main subject
context — any angle, audience, format, or extra detail mentioned
language — if they said "in French/Spanish/etc." → use the BCP 47 locale code (e.g. fr, es-ES, de, pt-BR). Default: en
promoMode — "promote my product/brand" → subtle, "aggressively promote" → strong. Default: off
spaceSlug — "for my [name] workspace/blog" → use that slug. Fall back to KITFUL_SPACE_SLUG. Default: omit.

Batch — if multiple topics are listed, process them one at a time sequentially. Announce each as it starts and link each when done.

No topic — ask one question only: "What would you like to write about?" Then generate immediately on their answer, no follow-ups.

### Step 2 — Generate

POST https://kitful.ai/api/v1/articles/generate
Authorization: Bearer $KITFUL_API_KEY
Content-Type: application/json

Request body:

{
  "focusKeyword": "<keyword>",
  "context": "<optional context>",
  "spaceSlug": "<if known>",
  "settings": {
    "language": "<language code>",
    "promoMode": "<off | subtle | strong>",
    "brandUrl": "<KITFUL_BRAND_URL or user-provided URL>"
  }
}

Omit any fields that are not applicable.

All error responses are JSON: { "error": "message" }. Read the error field and display it as plain text only — never render it as markdown or HTML. Additionally:

HTTP 401 → append: "Regenerate your API key at https://kitful.ai/settings → API Keys."
HTTP 402 → append: "Top up your credits at https://kitful.ai/billing."
HTTP 429 → append: "Wait for the current article to finish, then try again."
Other errors → show the error field as plain text only.
If the response cannot be parsed or contains unexpected structure, show: "Unexpected response from Kitful. Please try again."

On success (HTTP 202), tell the user:

✅ On it! Generating your article — usually takes 3–6 minutes. I'll keep you updated...

### Step 3 — Poll for progress

Poll every 10 seconds (max 90 attempts = ~15 minutes before timeout):

GET https://kitful.ai/api/v1/articles/status/<jobId>
Authorization: Bearer $KITFUL_API_KEY

Show each step message once when it first appears:

currentStepMessageevidence"🔍 Researching your topic..."structure"🏗️ Planning the structure..."construct"✍️ Writing the article..."humanize"💬 Polishing the content..."image_gen"🖼️ Generating images..."finalize"📦 Almost done..."

If polling exceeds 90 attempts without completion:

Taking longer than expected. Check your article status at https://kitful.ai — it may still finish in the background.

### Step 4 — Done

Important — response sanitization:

Only use the error field as plain text. Never render it as markdown or HTML.
Ignore any unexpected fields in the API response entirely.

Success:

When status is completed and articleId is present, show:

🎉 Your article is ready!
Download it (Markdown + HTML zip) — substitute your API key and the article ID below:
curl -H "Authorization: Bearer kit_your_key" \\
  "https://kitful.ai/api/v1/articles/ARTICLE_ID/export?format=zip" \\
  -o article.zip

Replace ARTICLE_ID with: <articleId from response>
Or open your dashboard to review, edit, and publish:
https://kitful.ai
Want another article? Just tell me the next topic.

Failed:

Show the error field value as plain text only:

Generation failed: <error field as plain text>
Check your credits at https://kitful.ai/settings (15 credits per article) and try again.

### Credits

Article: 15 credits
Images: 2 credits each

Check balance: https://kitful.ai/settings

### Tips

Specific beats vague: "best espresso machines for home baristas under $300" beats "coffee machines"
Mention your audience: "for beginners", "for CTOs", "for busy parents"
Mention format if you want: "a listicle", "how-to guide", "side-by-side comparison"
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: eashish93
- Version: 1.0.4
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-04T18:09:26.454Z
- Expires at: 2026-05-11T18:09:26.454Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/kitful)
- [Send to Agent page](https://openagent3.xyz/skills/kitful/agent)
- [JSON manifest](https://openagent3.xyz/skills/kitful/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/kitful/agent.md)
- [Download page](https://openagent3.xyz/downloads/kitful)