Back

Edit Article

Writing & docs191.8K installs

What it does

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

Install

npx skills add https://github.com/mattpocock/skills --skill edit-article

Website

www.skills.sh/mattpocock/skills/edit-article

Details

From the skill’s SKILL.md or README, by its authors. View the original

  • 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.

  • For each section:

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

More Writing & docs skills

See all

  • Writing & docs

    Grill With Docs

    A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

    npx skills add https://github.com/mattpocock/skills --skill grill-with-docs
    1.3M installs

  • Writing & docs

    Triage

    Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

    npx skills add https://github.com/mattpocock/skills --skill triage
    1.1M installs

  • Writing & docs

    Domain Modeling

    Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.

    npx skills add https://github.com/mattpocock/skills --skill domain-modeling
    952.2K installs

  • Writing & docs

    Writing Beats

    Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.

    npx skills add https://github.com/mattpocock/skills --skill writing-beats
    528.6K installs

Skills are shared by members and not reviewed by us. Read a skill’s code before you install it.