Every premium and members-only resource for $9.99/month, as a no-commitment subscription. See the plans

PalateKit

Sign in
Menu

Request a resource

Describe the resource you are missing in one sentence. We will email you when it is published.

0 / 280

A page, a video or an image online.

Unlock PalateKit

Unlock everything

Plan

Paying means accepting our terms of sale.

Secure payment by Stripe. Receipts and invoices sent by email.

Welcome back

Sign in to install, download or save this resource. A free account is enough for free resources.

Analysing and improving a Markdown document v1.0.0

Use this resource to analyse an existing Markdown document and improve it section by section

New

  • 373 downloads
  • 173 likes
  • 158 saves

Free

Install with the CLI

In a terminal, from the folder you want:

npx --yes palatekit@latest install markdown-doc-improvement

With no option, the skill goes to ~/.agents/skills/; add --agent claude-code (or codex, cursor…) to target an agent.

First time: connect the CLI with

npx --yes palatekit@latest login

The agent parses the document, classifies each section by Diataxis type and identifies issues. It then presents the analysis and refines the sections interactively. You get a clearer document with the issues fixed.

Mostly picked by

Updated November 2, 2026

Card for the “Analysing and improving a Markdown document” skill

Details

Works in
Install guides
Generates with
Your agent's model
Licence
Apache-2.0

Similar resources

View all

What you get

  • SKILL.md: section classification and issue identification
  • SKILL.md: interactive refinement, section by section

Good fit for

  • A Markdown document is unclear or mixes tutorial and reference content
  • You want to improve an existing page without rewriting it entirely

Not for

    Tags

    • markdown
    • diataxis
    • documentation
    • improvement

    About

    You say

    “Improve docs/guides/getting-started.md: it mixes installation and concepts.”

    Card for the “Analysing and improving a Markdown document” skill

    Skill published by existential-birds under the Apache-2.0 license, delivered in its original version.

    Show more

    How to use it

    1. Install the skill in your agent's skills folder
    2. Ask your agent to analyse an existing Markdown document and improve it section by section
    3. Review and adjust the result

    Content preview

    Files

    • LICENSE10.7 KB
    • NOTICE-PALATEKIT.md0.5 KB
    • SKILL.md12.1 KB

    Origin and licence

    Listed unmodified

    Author
    existential-birds
    Source
    github.com/existential-birds/beagle/tree/d1a74899fbfec74974d1818e4cac7c3d54d44b65/plugins/beagle-docs/skills/improve-doc
    Licence
    Apache-2.0

    Notice

    « improve-doc » (existential-birds, Apache-2.0) livré dans sa version d'origine : fiche en français et en anglais par PalateKit.

    User reviews

    –

    No ratings yet

    Loading reviews…

    Delete your review?

    Your rating and comment will be removed from the page.