skills/communication-optimizer/SKILL.md
Transform verbose, lengthy documents into clear, concise, actionable communications using proven frameworks (BLUF, Minto Pyramid, SCR). Use when stakeholders aren't reading lengthy docs or when critical messages get lost in detail.
npx skillsauth add szoloth/skills communication-optimizerInstall 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.
Transform verbose documents into crisp communications that stakeholders actually read and act upon. Apply proven frameworks to create information hierarchy that prioritizes key messages and makes documents skimmable.
Symptoms:
Root cause: Information architecture optimized for comprehensive coverage, not reader comprehension.
Lead with the conclusion or recommendation. Bury nothing important.
Structure:
Example transformation:
Before (buried lead):
Over the past 6 weeks we conducted interviews with 12 story artists across 3 productions. We asked about their workflow challenges, particularly around reference collections. Several themes emerged including search difficulty, version control confusion, and collaboration friction. Based on this research, we recommend prioritizing collections management.
After (BLUF):
Recommendation: Prioritize collections management feature
Why:
- Story artists lose 30-40% of time searching for assets (12 of 12 interviews)
- Current folder structure fails at scale (500TB across productions)
- High confidence: pain validated across all productions and seniority levels
[Full research synthesis: story-research.md]
Structure arguments from conclusion → key arguments → supporting evidence.
Rules:
Application:
Reference references/minto-pyramid-detailed.md for complex restructuring.
Narrative framework for proposals or recommendations.
Structure:
When to use: Proposing change, making recommendations, requesting decisions.
Example:
Situation: Story department manages 500TB of reference imagery using shared network folders.
Complication: Artists lose 30-40% of work time searching for assets. Current folder structure doesn't scale to production size. Teams duplicate work because they can't find existing references.
Resolution: Implement semantic search + collections management to reduce search time by 50% and enable cross-team asset discovery.
What is the single most important thing the reader must know? If they read nothing else, what should they walk away with?
What 3-5 points support the core message? Rank by importance.
Target 50% reduction from original. Cut:
Use BLUF + SCR:
Use Pyramid:
Use BLUF + clear asks:
minto-pyramid-detailed.md - Complete guide to pyramid principle with examplesbluf-examples.md - Before/after transformations across document typesstakeholder-communication-patterns.md - Adapting style for different audiencesexecutive-summary-template.md - BLUF-structured summary templateone-pager-template.md - Single-page decision memo formatresearch-brief-template.md - SCR-structured research summaryBefore sending optimized doc:
content-media
Fetch transcripts from YouTube videos for summarization and analysis.
documentation
This skill should be used when reviewing or editing written drafts to ensure they match Sam's personal style guide. It prioritizes voice preservation and anti-beige detection while catching structural gaps. Triggers on requests to review, edit, or improve written content.
tools
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
development
Web search and content extraction using Brave Search. Use when researching topics, finding documentation, extracting article content, or gathering information from the web. No browser required - works headlessly.