Verified
Notion API: page/database CRUD, block hierarchies, rich text, schema sync.
NotionAPICMS
Comms & Docs × Codex
Top Communication & Docs Skills for Codex
For documentation work in Codex CLI, the useful set is documentation and architecture-adr for writing that lives beside the code, system-architecture-diagrams for generating the picture from that writing, and humanizer for anything a customer will read. Notion's skill covers the case where the docs live outside the repo.
6 of 23 verified on Codex · updated June 29, 2026
Top 5 on Codex
Notion API: page/database CRUD, block hierarchies, rich text, schema sync.
ADR authoring + design review. Trade-offs, consequences, alternatives.
Technical writing that engineers will actually read and update.
Incident triage + comms + blameless postmortem in one harness.
- 5.humanizer—Strip the AI tells. Multi-pass editing for content that reads opinionated, not generated.
Strip the AI tells. Multi-pass editing for content that reads opinionated, not generated.
Verified
Comms & Docs skills that work on Codex
Ranked by composite score. Every entry was tested on Codex — not inferred from the SKILL.md format.
Official
ADR authoring + design review. Trade-offs, consequences, alternatives.
ADRArchitectureDesign
Official
Technical writing that engineers will actually read and update.
DocumentationWritingREADME
Official
Incident triage + comms + blameless postmortem in one harness.
IncidentPostmortemOn-call
Community
Strip the AI tells. Multi-pass editing for content that reads opinionated, not generated.
EditingVoiceAEO
Community
C4, deployment, sequence-of-events architecture diagrams generated from natural-language descriptions.
C4ArchitectureADR
Install
Commands for Codex
Copy-paste installs for the top picks. Full per-agent commands are on each skill page.
notion-api-skill
codex skills add makenotion/skills/skills/notion-api-skillarchitecture
Copy the architecture folder into ~/.codex/skills/
documentation
Copy the documentation folder into ~/.codex/skills/
incident-response
Copy the incident-response folder into ~/.codex/skills/
humanizer
codex skills add blader/humanizer/skills/humanizersystem-architecture-diagrams
codex skills add cheriftj/c4-model-skill/skills/system-architecture-diagramsNot verified here
17 comms & docs skills we have not confirmed on Codex
Listed rather than hidden. Absence here usually means untested, not broken — check each skill page for the agents it is verified on.
- knock-notification-best-practices
- consolidate-memory
- ux-copy
- pptx
- slack-gif-creator
- internal-comms
- doc-coauthoring
- init
- mermaid-diagrams
- linkedin-content-skill
- research-synthesis
- user-research
- brand-review
- memory-management
- task-management
- excalidraw-generator
- frontend-slides
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
Can Codex keep a docs site in sync with code changes using these?
Partly — the skills supply the conventions and structure, so the agent knows what a good ADR or reference page looks like. Keeping them in sync is a workflow problem, not a skill problem: trigger the docs skill as part of the same task that changes the code, or the docs drift exactly as they always have.
How many comms & docs skills work with Codex?
6 of the 23 skills catalogued in Communication & Docs are verified working on Codex. The remaining 17 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 Codex?
Each skill page carries the exact Codex command. Codex reads SKILL.md natively, so a skill folder works unchanged.
Related
Other cuts of this data
- All Communication & Docs skills →
Every entry in the category, across all agents, ranked by composite score.
- All skills for Codex →
Every skill verified on Codex CLI, across all categories.
- Top Code Quality & Review Skills for Codex →
The 10 code review agent Skills with verified Codex compatibility, ranked by composite score, with the install command for Codex and what is not verified there yet.
- Top Frontend & UI Design Skills for Codex →
The 9 frontend & ui agent Skills with verified Codex compatibility, ranked by composite score, with the install command for Codex and what is not verified there yet.