comms-md
by stedmanhalliday
PDF & DocumentsBrief
Create a COMMS.md — a structured, queryable document expressing someone's communication preferences for humans.
Description
What This Skill Does
Guides a structured interview to produce a COMMS.md — a personal document capturing communication style, channel preferences, availability rhythms, and async writing habits. The output is designed to be read by both humans and AI agents before initiating contact.
A structured, version-controlled file that agents can parse directly is more reliable than verbal preferences that get forgotten or inconsistently applied.
When to Use It
- Documenting preferred response times per channel for coworkers
- Giving other people's agents context before they draft outreach on your behalf
- Capturing async voice so AI tools can write in your register
- Setting explicit boundaries around communication methods and timing
- Creating a team-facing reference for how you prefer to collaborate
Example Workflow
User asks: I want to create a COMMS.md for myself
- 1
Explains what a COMMS.md is and how humans and agents use it
- 2
Conducts a conversational interview across style, collaboration model, weekly rhythm, sync philosophy, channel preferences, async voice, and boundaries
- 3
Drafts the COMMS.md using the template structure, using the user's own phrasing where possible
- 4
Presents the draft and iterates based on feedback about tone, missing channels, or anti-patterns
- 5
Asks where the user wants the document saved
A completed COMMS.md capturing the user's communication preferences, versioned at 0.1 and ready to publish or share
Installation
clawhub install stedmanhalliday/comms-mdRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.