Comms & Docs × Cursor

Top Communication & Docs Skills for Cursor

For writing and diagramming inside Cursor, the useful set is documentation and architecture-adr for the prose that lives next to code, mermaid-diagrams and system-architecture-diagrams for pictures generated from that prose, and humanizer to strip the AI cadence out of anything customer-facing. All are read-only: they change what gets written, not what gets shipped.

11 of 23 verified on Cursor · updated July 15, 2026

Top 5 on Cursor

  1. 1.notion-api-skill

    Notion API: page/database CRUD, block hierarchies, rich text, schema sync.

  2. 2.architecture

    ADR authoring + design review. Trade-offs, consequences, alternatives.

  3. 3.documentation

    Technical writing that engineers will actually read and update.

  4. 4.incident-response

    Incident triage + comms + blameless postmortem in one harness.

  5. 5.humanizer

    Strip the AI tells. Multi-pass editing for content that reads opinionated, not generated.

Verified

Comms & Docs skills that work on Cursor

Ranked by composite score. Every entry was tested on Cursor — not inferred from the SKILL.md format.

Notion API: page/database CRUD, block hierarchies, rich text, schema sync.

NotionAPICMS
All surfaces
Medium3 min
Official

ADR authoring + design review. Trade-offs, consequences, alternatives.

ADRArchitectureDesign
All surfaces
Low1 min
Official

Technical writing that engineers will actually read and update.

DocumentationWritingREADME
All surfaces
Low1 min

Incident triage + comms + blameless postmortem in one harness.

IncidentPostmortemOn-call
All surfaces
Low1 min
Community

Strip the AI tells. Multi-pass editing for content that reads opinionated, not generated.

EditingVoiceAEO
Code
Low2 min
Official

Microcopy that respects the user. Errors, empty states, CTAs, onboarding.

UX CopyMicrocopyWriting
All surfaces
Low1 min

Mermaid diagrams from prose with self-validating syntax. Sequence, flowchart, ER, state.

MermaidDiagramsMarkdown
All surfaces
Low1 min

LinkedIn posts that read human. Hook patterns, voice modeling, carousel scripts.

LinkedInSocialContent
All surfaces
Low2 min

Excalidraw JSON diagrams from prose, with rendering self-checks.

ExcalidrawDiagrams
Code
Low2 min
Community

HTML slide decks from prose. Easy to embed, version, and edit later.

SlidesHTMLPresentations
Code
Low2 min

C4, deployment, sequence-of-events architecture diagrams generated from natural-language descriptions.

C4ArchitectureADR
Code
Low3 min

Install

Commands for Cursor

Copy-paste installs for the top picks. Full per-agent commands are on each skill page.

notion-api-skill
npx skills add makenotion/skills --skill notion-api-skill --target cursor
architecture

Copy the architecture folder from the engineering plugin into .cursor/skills/

documentation

Copy the documentation folder from the engineering plugin into .cursor/skills/

incident-response

Copy the incident-response folder from the engineering plugin into .cursor/skills/

humanizer
npx skills add blader/humanizer --skill humanizer --target cursor
ux-copy

Copy the ux-copy folder from the design plugin into .cursor/skills/

mermaid-diagrams
npx skills add Agents365-ai/mermaid-skill --skill mermaid-diagrams --target cursor
linkedin-content-skill
npx skills add sergebulaev/linkedin-skills --skill linkedin-content-skill --target cursor

Not verified here

12 comms & docs skills we have not confirmed on Cursor

Listed rather than hidden. Absence here usually means untested, not broken — check each skill page for the agents it is verified on.

A combination only gets a page here when at least 6 skills are verified on the agent — otherwise the page would be a stub pretending to be a ranking.

FAQ

Common questions

Should docs skills live in the repo or in my global Cursor config?

Repo-local, if the conventions are repo-specific — an ADR template or docs structure belongs with the code it documents, so every contributor and every agent session inherits the same one. Keep only the generic writing skills (humanizer) global.

How many comms & docs skills work with Cursor?

11 of the 23 skills catalogued in Communication & Docs are verified working on Cursor. The remaining 12 are either untested on this agent or depend on capabilities it does not provide — they are listed below rather than hidden.

How do I install a comms & docs skill on Cursor?

Each skill page carries the exact Cursor command. Cursor reads SKILL.md through a compatibility layer, which is why compatibility here is tested per skill rather than assumed.

Related

Other cuts of this data