comms-md

---
name: comms-md
description: "Create a COMMS.md — a structured, queryable document expressing someone's communication preferences for humans and agents. Use when: (1) someone wants to articulate how they communicate (style, channels, rhythms, tone), (2) someone wants a document other people's agents can read before reaching out, (3) someone says 'comms.md' or asks about communication preferences documents."
metadata:
  openclaw:
    version: "1.0.0"
    author: "stedman"
    related:
      - comms-md-reader
---

# COMMS.md Creator

Generate a structured communication preferences document through guided conversation.

## What COMMS.md Is

A queryable personal document that expresses how someone communicates: their natural style, channel preferences, availability rhythms, async voice, and interaction protocols. Designed to be read by both humans and agents before initiating contact.

## Workflow

### 1. Orient

Explain the concept briefly:

> "A COMMS.md is a structured doc that captures how you communicate — your style, when you're available, which channels you prefer, how you write in different contexts. Think of it as a user manual for reaching you. Other people (or their agents) can reference it before getting in touch."

### 2. Interview

Walk through these areas conversationally. Don't dump all questions at once — do 2-3 per turn, adapt based on answers, skip what's clearly not relevant.

**Style & strengths** (start here — it's introspective and sets the tone):
- What comes naturally when you communicate? (e.g. brevity, storytelling, humor, directness)
- What requires effort? (e.g. small talk, follow-through, emotional labor, context-switching)
- Where does communication break down for you?

**Collaboration model:**
- What kind of people do you work best with?
- How do you prefer to set up working relationships?

**Weekly rhythm:**
- Walk through their week: energy, availability windows, protected time
- Which days are meeting-heavy? Which are deep work?

**