Skip to main content
NEW · APP STORE Now on iOS · macOS · iPad Android & Windows soon GET IT
Prompts Article Draft Section Editor

agent writing skill risk: low

Article Draft Section Editor

Divides an article into sections based on headings while respecting information dependencies modeled as a directed acyclic graph, confirms the sections with the user, and rewrites…

SKILL 1 file

SKILL.md
---
name: edit-article
description: "Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft."
---
1. First, divide the article into sections based on its headings. Think about the main points you want to make during those sections.

Consider that information is a directed acyclic graph, and that pieces of information can depend on other pieces of information. Make sure that the order of the sections and their contents respects these dependencies.

Confirm the sections with the user.

2. For each section:

2a. Rewrite the section to improve clarity, coherence, and flow. Use maximum 240 characters per paragraph.

REQUIRED CONTEXT

  • article draft

ROLES & RULES

  1. Divide the article into sections based on its headings
  2. Make sure that the order of the sections and their contents respects these dependencies
  3. Confirm the sections with the user
  4. Rewrite the section to improve clarity, coherence, and flow
  5. Use maximum 240 characters per paragraph

EXPECTED OUTPUT

Format
plain_text
Constraints
  • maximum 240 characters per paragraph
  • confirm sections with user before rewriting

SUCCESS CRITERIA

  • Improve clarity, coherence, and flow
  • Respect information dependencies

CAVEATS

Missing context
  • The article text to edit
  • What to do after rewriting all sections (e.g., global review, title, conclusion)
  • Output format or presentation style for rewritten sections
Ambiguities
  • 'Think about the main points you want to make during those sections' does not specify whose points or perspective.
  • DAG dependency instruction is abstract and its application to headings/sections is not operationalized.

QUALITY

OVERALL
0.60
CLARITY
0.70
SPECIFICITY
0.55
REUSABILITY
0.75
COMPLETENESS
0.40

IMPROVEMENT SUGGESTIONS

  • Add a step 3 that performs a final pass for overall consistency, tone, and length after all sections are rewritten.
  • Specify how rewritten sections should be returned to the user (e.g., markdown with change notes).

USAGE

Copy the prompt above and paste it into your AI of choice — Claude, ChatGPT, Gemini, or anywhere else you're working. Replace any placeholder sections with your own context, then ask for the output.

MORE FOR AGENT