skills/communication-playbook/SKILL.md
World-Class Communication Playbook for HeySalad. Use this skill whenever any communication task is involved — internal team messages, external emails to investors/regulators/partners/customers, presentation structuring, written docs, cross-functional project coordination, meeting facilitation, transparency decisions, or active listening coaching. Trigger for ANY of the following: drafting or reviewing emails, Slack messages, investor updates, regulatory correspondence, pitch decks, slide structure, meeting agendas or notes, RACI matrices, project kickoff docs, 1-on-1 frameworks, feedback conversations, conflict resolution, documentation standards, or communication culture advice. Also trigger when the user asks about tone, channel selection, async comms, BLUF, Pyramid Principle, meeting cadence, psychological safety, or transparency norms. If it involves how HeySalad communicates — internally or externally — use this skill. When in doubt, use it.
npx skillsauth add leoyeai/openclaw-master-skills communication-playbookInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
A distillation of world-class communication standards across eight domains. Apply these principles whenever generating, reviewing, or coaching any form of communication at HeySalad.
Before producing any communication output, identify the domain:
| Domain | When to apply | |--------|--------------| | Internal | Slack, team emails, async updates, documentation | | External | Investor updates, regulatory comms, customer/partner emails | | Presentations | Pitch decks, demos, all-hands, stakeholder reviews | | Written | Docs, wikis, changelogs, proposals, reports | | Cross-functional | Multi-team projects, RACI, kickoffs, SSOT | | Meetings | Agendas, facilitation, notes, decisions | | Transparency | What to share, how, and with whom | | Active Listening | 1-on-1 coaching, conflict, negotiation, feedback |
Multiple domains often apply simultaneously — use all relevant sections.
Every internal message leads with the conclusion. State what you need, then provide supporting context. Never bury the request.
Bad: "Hey, I was looking at the MTN Mobile Money integration and noticed some latency issues. The logs showed errors around 14:00 UTC yesterday. This might be affecting settlement. Can you check?"
Good: "ACTION NEEDED: MTN Mobile Money settlements may be failing. Logs show errors at 14:00 UTC — please investigate and report back by EOD. Details below."
| Channel | Use for | Avoid when | |---------|---------|-----------| | Slack/IM | Quick questions, real-time coord | Sensitive topics, complex decisions | | Email | Formal updates, paper trail needed | Urgent issues, back-and-forth | | Video Call | Nuanced topics, relationship building | Simple status updates | | Loom/Async Video | Demos, walkthroughs, one-to-many | Two-way dialogue | | Written Doc | Decisions, processes, lasting reference | Time-sensitive comms | | In-Person | Strategy, brainstorming, conflict resolution | Distributed teams |
Before sending any async message confirm:
Structure every investor update as:
Investors who receive consistent, honest updates — including bad news — are far more likely to support you in a crisis than those who only hear from you when things are good.
┌─────────────────────┐
│ GOVERNING THOUGHT │ ← State this within 60 seconds
└──────────┬──────────┘
┌─────────┼─────────┐
Key Arg 1 Key Arg 2 Key Arg 3
└─────────┼─────────┘
Supporting Data / Evidence / Examples
Lead with the answer. Audience should never wonder what you are trying to say.
| Rule | Principle | |------|-----------| | One idea per slide | If you say "and also..." you need a new slide | | Six-by-Six | Max 6 bullets, max 6 words each. Prefer visuals | | Headline as insight | "Revenue grew 40% MoM" not "Revenue" | | Consistent visual language | One font, one palette, one icon set | | The Blank Test | Key message understood in under 5 seconds? | | Signal not noise | Remove anything decorative that adds no meaning |
Write the subject line last, after you know exactly what the message is about.
| Audience | Tone & Style | Avoid | |----------|-------------|-------| | Investors | Direct, data-driven, confident. Lead with outcomes | Overselling, vague milestones, buried bad news | | Regulators | Formal, precise, deferential. Use their terminology | Speculation, informal language | | Customers | Warm, human, empathetic. Solve in fewest words | Jargon, delay, passing the buck | | Team | Clear, direct, motivating. Give context and be honest | Corporate speak, vagueness | | Press/Media | Controlled, strategic, quotable | Off-the-record assumptions |
| Role | Definition | Rule | |------|-----------|------| | Responsible | Does the work | Can be multiple people | | Accountable | Answerable for the outcome | Only ONE person ever | | Consulted | Input sought before decisions | Two-way communication | | Informed | Notified of outcomes | One-way, broadcast only |
Warning: Multiple people marked as Accountable = no one accountable. This is the most common RACI failure.
Every cross-functional project must have one designated SSOT — a document, board, or tool where all decisions, status updates, and changes are recorded. If it is not in the SSOT, it did not happen.
| Type | Purpose | Duration | Frequency | |------|---------|----------|-----------| | Daily Standup | Done / Next / Blocked | 15 min | Daily | | Weekly Team Sync | Progress, priorities, blockers | 30-60 min | Weekly | | 1-on-1 | Relationship, coaching, feedback | 30-45 min | Weekly/biweekly | | Decision Meeting | Deliberation on a specific decision | Time-boxed | As needed | | Retrospective | Team process reflection | 60 min | Monthly/per sprint | | All-Hands | Company update, culture, Q&A | 30-60 min | Monthly |
Meeting notes must include:
Notes shared with all attendees AND all Informed stakeholders. Actions tracked in a shared system, not just email. Next meeting begins with review of previous actions.
| Level | What It Means | Use For | |-------|--------------|---------| | Default Open | All information available without asking | Docs, wikis, roadmaps | | Share on Request | Available to anyone who asks | Sensitive but non-confidential data | | Need to Know | Restricted to those directly involved | Personnel matters, legal strategy | | Confidential | Formal agreement required | Board matters, regulatory submissions |
Psychological safety is destroyed in seconds and rebuilt over months. One disproportionate response to bad news can silence an entire team.
| Level | Description | Goal | |-------|-------------|------| | Level 1 — Internal | Thinking about your own response while the speaker talks | Avoid this | | Level 2 — Focused | Fully attentive: words, body language, emotional content | Professional baseline | | Level 3 — Global | Aware of everything including silence and what is not said | High-stakes conversations |
| Failure | What It Looks Like | |---------|--------------------| | Preparing your response | Eyes glaze over mid-sentence | | Filtering | Only hearing what confirms existing beliefs | | Interrupting | Jumping in before the speaker finishes | | Advice-giving too soon | Offering solutions before understanding the problem | | Distraction | Phone visible, notifications on, environment not set up |
When producing any communication output, apply these non-negotiables:
→ Use Section 2 investor update formula (5-part structure) → Apply Section 4 written communication principles → Tone: direct, data-driven, honest including on challenges
→ Use Section 2 regulatory correspondence rules → Formal, precise, deferential, reference numbers included → Flag for second-person review before sending
→ Apply Pyramid Principle from Section 3 → Governing thought within 60 seconds → One idea per slide, headline as insight
→ Section 6: check meeting type, apply before/during/after checklists → Output: agenda template or meeting notes template
→ Section 5: identify R, A, C, I for each workstream → Confirm only ONE Accountable owner → Output as table with names assigned
→ Apply Section 4 written principles → Check: BLUF, active voice, specificity, audience calibration, length → Return revised version with brief rationale for key changes
→ Sections 7 (transparency) and 8 (active listening) → Apply acknowledgement without agreement technique → Coach on listening levels and clarifying questions
→ Section 1 internal communication norms → Lead with the 'why', include context, specify next steps → Tone: motivating, honest, clear
HeySalad Communication Playbook — v1.0 — 2025 Founder & CTO: Peter Machona
testing
AI-powered diary generation for agents - creates rich, reflective journal entries (400-600 words) with Quote Hall of Fame, Curiosity Backlog, Decision Archaeology, Relationship Evolution, mood analytics, weekly digests, "On This Day" resurfacing, and cron auto-generation. Works best with Claude models (Haiku, Sonnet, Opus).
development
Multi-agent UX for OpenClaw Control UI — agent selector, per-agent sessions, session history viewer with search, agent-filtered Sessions tab with friendly names, Create Agent wizard, emoji picker, and backend agent CRUD.
tools
Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.
tools
Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.