aios-blog-post

Generates QA-gated informational blog posts with entity coverage, answer blocks, and JSON-LD via the AIOS content pipeline.

1|Updated Jul 8, 2026
One-click install
npx skills add https://github.com/codesofadan/danyals-aios --skill aios-blog-post-codesofadan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aios-blog-post
Source: https://github.com/codesofadan/danyals-aios/tree/main/.claude/skills/aios-blog-post
Command: npx skills add https://github.com/codesofadan/danyals-aios --skill aios-blog-post-codesofadan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing ranking-grade blog content for agency clients requires grounding in fresh client context, entity coverage matching top-10 SERP results, extractable answer blocks, and structured QA — a process that is slow and inconsistent when done manually. ## Core Features & Use Cases - End-to-end content job orchestration: Resolves the client, creates a blog content job via the AIOS API, waits for the pipeline to draft and self-QA, then fetches the draft, keywords, and Article JSON-LD schema. - 14-dimension QA gate: Evaluates entity coverage, snippet extractability, fact grounding, intent match, and information gain against an 85-point threshold with per-dimension minimums before any human approval. - Degradation and gap handling: Detects [NEEDS:] fact markers, stale context lag, and degraded mode when SERPER/ANTHROPIC keys are missing, routing everything to a human review gate instead of auto-publishing. - Use Case: An operator says "write a blog post for Acme Plumbing on how tankless water heaters save money" and receives the draft, QA scorecard, and JSON-LD for lead approval. ## Quick Start Ask the assistant to write a blog post for a specific client on a specific topic, for example: write a blog post for Acme Plumbing on how tankless water heaters save money.

Frequently Asked Questions about aios-blog-post

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an SEO blog post for a client with this skill?▼

Provide the client name and topic, and the skill resolves the client, creates a blog content job via POST /content/jobs, waits for the pipeline to reach needs_review, then returns the draft, QA scorecard, and JSON-LD for human approval.

What QA checks does the blog content pipeline run?▼

The pipeline scores drafts across 14 dimensions including entity coverage, snippet extractability, fact grounding, intent match, and information gain. Passing requires a weighted total of at least 85 with every dimension above 70.

Can the skill approve and publish a blog post automatically?▼

No. The skill always stops at the needs_review gate and never approves. Only a LEAD role (owner, admin, or manager) can approve via the review action, and the database re-checks the QA gate on approval.

What happens when SERPER or ANTHROPIC API keys are missing?▼

The pipeline falls back to a deterministic fake with heuristic-only QA, and the output is labeled degraded. The skill reports this state and blocks publishing rather than presenting fake research as live output.

Why does a blog draft contain [NEEDS:] markers?▼

A [NEEDS:] marker means a required fact is missing from the client's context and the fact_grounding dimension hard-blocks the draft. A human must supply the fact and route the job to edit; the skill never invents missing facts.