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
- Divide the article into sections based on its headings
- Make sure that the order of the sections and their contents respects these dependencies
- Confirm the sections with the user
- Rewrite the section to improve clarity, coherence, and flow
- 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
- Technical Wiki Documentation Page Writeragentwriting
- Systems Paper Paragraph Blueprintagentwriting
- ML Paper Outline Generatoragentwriting
- Documentation Co-Authoring Workflow Guideagentwriting
- ML Paper Outline from Resultsagentwriting
- Academic Paper Outline from Reviewsagentwriting
- ML/AI Theory Rigorous Proof Writeragentwriting
- TDD Skill Authoring Methodologyagentwriting
- Conversational Markdown Article Shaperagentwriting
- Marketing Copy Seven-Sweeps Editoragentwriting
- Release Notes from Tickets and Changelogsagentwriting
- Technical Wiki Documentation Page Writeragentwriting
- LaTeX Paper PDF Compileragentwriting
- AI Writing Patterns Audit and Rewriteagentwriting
- Codebase Wiki Catalogue Architectagentwriting
- Technical Wiki Page Documentation Writeragentwriting
- AI Writing Patterns Auditor and Rewriteragentwriting
- Internal Communications Drafteragentwriting
- Codebase Wiki Catalogue and Onboarding Guide Generatoragentwriting
- AI Writing Patterns Audit and Rewriteagentwriting
- Overleaf Git Bridge Two-Way Syncagentwriting
- Overleaf Git Bridge Sync Workflowagentwriting
- Comprehensive Codebase Bug Analysis and Fixeragentanalysis
- Xcode MCP Usage Guidelines for Agentsagenttool_use
- Xcode MCP Usage Guidelinesagenttool_use