editorial-draft-review

Enqueue a blog draft into an editorial-review pipeline as an open DraftWorkflowItem.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/oletizi/audiocontrol.org --skill editorial-draft-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: editorial-draft-review
Source: https://github.com/oletizi/audiocontrol.org/tree/main/.claude/skills/editorial-draft-review
Command: npx skills add https://github.com/oletizi/audiocontrol.org --skill editorial-draft-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enqueues an existing blog draft into the editorial-review workflow for annotation and iteration, turning scattered drafts into tracked review items.

Core Features & Use Cases

  • Enqueues a DraftWorkflowItem in state open (idempotent per site, slug, contentKind) for editorial review.
  • Exposes the dev review URL and prints a clear status summary to guide operators.
  • Validates site and slug, reads Markdown draft, and handles placeholder bodies with actionable guidance.

Quick Start

Invoke /editorial-draft-review <slug> to enqueue a draft for review.

Frequently Asked Questions about editorial-draft-review

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

FAQPage Schema
How do I enqueue a markdown blog draft into an editorial review workflow?

To enqueue a markdown blog draft for editorial review, invoke the review command with your draft's slug. The system validates the site and slug, reads the markdown file, and creates an open DraftWorkflowItem to track the review iteration.

What happens if I submit the same blog draft for editorial review twice?

Submitting the same blog draft for editorial review twice is safe because the workflow creation is idempotent per site, slug, and content kind. It checks for disk-versus-version divergence and updates the existing open workflow item rather than creating duplicates.

Do I need a dev server running to review an enqueued blog draft?

A dev server is required to review an enqueued blog draft. After creating the DraftWorkflowItem, the skill exposes a dev review URL and provides clear guidance on server startup requirements so you can access the draft for annotation.

Can I enqueue a placeholder markdown draft into the editorial review pipeline?

You can enqueue a placeholder markdown draft into the editorial review pipeline. The skill reads the draft markdown and handles placeholder bodies by providing actionable guidance within the status summary to help you complete the content.

What is the best way to track scattered blog drafts for annotation and iteration?

The best way to track scattered blog drafts for annotation is to enqueue them into an editorial-review pipeline. This validates site slugs, reads markdown content, and creates tracked open workflow items, turning unmanaged drafts into structured review tasks.

Why does my editorial draft review workflow show disk-versus-version divergence?

Your editorial draft review workflow shows disk-versus-version divergence when the markdown file on disk has been modified differently from the tracked version. The skill detects this mismatch during idempotent workflow creation and alerts you to resolve the content discrepancy.