Skip to content
cccskills
FreePublished on GitHub

science-communication

Translating technical findings for non-technical audiences. Narrative frameworks (Pyramid Principle, SCQA), plain-language translation, executive summaries, policy briefs, causal language. Use when presenting to stakeholders or reviewing deliverables

The English summary is being prepared. Showing the original description.

DAAF-Contribution-Community/daaf238 stars(GitHub 238 + cccskills 0)

Run score Not tested

See how to install

Files included (7)

  • SKILL.md12.8 KB
  • references/accessibility-equity.md17.5 KB
  • references/audience-analysis.md16.0 KB
  • references/communication-review.md16.5 KB
  • references/deliverable-templates.md19.3 KB
  • references/narrative-frameworks.md18.5 KB
  • references/plain-language.md22.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Science Communication

Translating technical data science findings for non-technical audiences. Covers audience analysis, narrative frameworks (Pyramid Principle, SCQA, AIDA), plain-language translation, executive summaries, policy briefs, causal language guidance, hedging and uncertainty communication, and accessibility standards. Complements data-scientist visualization references — handles what story to tell and to whom, not how to build charts. Use when presenting findings to stakeholders, writing executive summaries or policy briefs, communicating statistical results to non-statisticians, or reviewing a draft deliverable for clarity and audience fit.

Guidance for translating rigorous data science work into clear, compelling communication for non-technical audiences. This skill is additive to data-scientist's visualization references — it covers what story the chart tells and to whom, not how to build the chart.

Boundary with data-scientist: The data-scientist skill handles chart construction, encoding, color palettes, and export standards. This skill handles audience adaptation, narrative structure, plain-language translation, deliverable formatting, and communication quality review.

How to Use This Skill

Reference File Structure

FilePurposeWhen to Read
audience-analysis.mdFive audience types with strategy tablesIdentifying who you're writing for
narrative-frameworks.mdSix narrative structures with selection guideChoosing how to structure your story
plain-language.mdJargon translation, hedging, uncertainty, causal languageWriting findings in accessible language
deliverable-templates.mdExecutive summary, policy brief, presentation, talking pointsFormatting a specific deliverable type
communication-review.md10-point checklist, common pitfalls, seven deadly sinsReviewing a deliverable before finalization
accessibility-equity.mdWCAG standards, people-first language, equity-aware framingEnsuring inclusive, accessible communication

Reading Order

  1. Writing a report or brief? Start with audience-analysis.md, then narrative-frameworks.md, then deliverable-templates.md
  2. Translating technical findings? Read plain-language.md first
  3. Reviewing a draft? Go straight to communication-review.md
  4. Concerned about equity or accessibility? Read accessibility-equity.md

The reference-file routing in this skill applies to advisory and brainstorming turns as much as implementation. Recommending an approach, reviewing a plan, or answering a question that touches a routed topic calls for reading the routed reference file just as much as drafting the deliverable does — the reference files carry curated caveats and audience-tested frameworks that this overview and general knowledge lack.

Quick Decision Trees

"Who am I writing for?"

Identifying your audience?
├─ Academic researchers or peer reviewers
│   └─ ./references/audience-analysis.md (Academic section)
├─ Policymakers or legislative staff
│   └─ ./references/audience-analysis.md (Policy section)
├─ Executives or board members
│   └─ ./references/audience-analysis.md (Executive section)
├─ General public or community members
│   └─ ./references/audience-analysis.md (Public section)
├─ Journalists or media
│   └─ ./references/audience-analysis.md (Media section)
└─ Mixed or unclear audience
    └─ ./references/audience-analysis.md (Assessment checklist)

"How should I structure this?"

Choosing a narrative structure?
├─ Need to deliver a recommendation quickly
│   └─ Pyramid Principle → ./references/narrative-frameworks.md
├─ Framing a problem that needs solving
│   └─ SCQA → ./references/narrative-frameworks.md
├─ Walking through a discovery journey
│   └─ Three-Act Data Story → ./references/narrative-frameworks.md
├─ Translating findings into action
│   └─ "So What?" Framework → ./references/narrative-frameworks.md
├─ Presenting data with narrative and visuals together
│   └─ Data-Narrative-Visual Triad → ./references/narrative-frameworks.md
├─ Persuading stakeholders to act
│   └─ AIDA → ./references/narrative-frameworks.md
└─ Not sure which to use
    └─ Selection guide table → ./references/narrative-frameworks.md

"How do I say this in plain language?"

Translating technical language?
├─ Statistical jargon (p-value, confidence interval, etc.)
│   └─ Jargon translation table → ./references/plain-language.md
├─ Expressing how certain you are
│   └─ Hedging language scale → ./references/plain-language.md
├─ Using calibrated uncertainty terms
│   └─ IPCC uncertainty framework → ./references/plain-language.md
├─ Describing causal vs correlational findings
│   └─ Causal language guide → ./references/plain-language.md
├─ General readability improvement
│   └─ Reading level guidance → ./references/plain-language.md
└─ Replacing formal/bureaucratic words
    └─ Word replacement list → ./references/plain-language.md

"What format should this take?"

Choosing a deliverable format?
├─ One-page summary for decision makers
│   └─ Executive summary → ./references/deliverable-templates.md
├─ Informing policy decisions
│   └─ Policy brief → ./references/deliverable-templates.md
├─ Presenting to a room
│   └─ Stakeholder presentation → ./references/deliverable-templates.md
├─ Talking to a journalist
│   └─ Media talking points → ./references/deliverable-templates.md
└─ Full research report
    └─ (Use REPORT_TEMPLATE.md from agent_reference/)

"Is this ready to share?"

Reviewing before finalization?
├─ Comprehensive quality check
│   └─ 10-point checklist → ./references/communication-review.md
├─ Statistical interpretation errors
│   └─ Seven deadly sins → ./references/communication-review.md
├─ Common communication pitfalls
│   └─ Pitfall catalog → ./references/communication-review.md
├─ Accessibility compliance
│   └─ WCAG checklist → ./references/accessibility-equity.md
└─ Equity and framing review
    └─ Do No Harm checklist → ./references/accessibility-equity.md

The Communication Gap

Research findings fail to reach their audience not because they lack rigor, but because they lack translation. The core challenge is bridging two worlds:

Researcher InstinctAudience Need
Lead with methodologyLead with the finding
Hedge everythingState what you know, clearly
Use precise technical languageUse familiar words
Present all caveats upfrontPresent the insight, then appropriate caveats
Show comprehensive dataShow the data that answers the question
Write for peer reviewersWrite for the person making a decision

The AAAS communication framework captures this as Goal → Audience → Message: define your purpose first, identify who can act on it, then craft language for that specific reader. This inverts the typical scientific structure where content comes first and audience comes last.

Core Principles

  1. Audience determines everything. The same finding requires different structure, vocabulary, detail level, and uncertainty communication for each audience type. Always identify your audience before drafting.

  2. Lead with the "so what." In scientific communication, conclusions come last. In stakeholder communication, the bottom line comes first. The reader's time and attention are scarce — earn continued reading with immediate relevance.

  3. Translate, don't simplify. Plain language is not dumbing down. It is precise communication calibrated to the reader's vocabulary. A well-translated finding preserves its meaning while making it accessible.

  4. Show uncertainty honestly. Hedging is not weakness — it is intellectual honesty. But hedge appropriately: too much hedging obscures the finding; too little overstates the evidence. Match your language to your inferential capacity.

  5. Every deliverable gets reviewed. Use the 10-point communication checklist before sharing anything. Communication errors — jargon leakage, causal overclaiming, missing the "so what" — are as consequential as analytical errors.

  6. Equity is not optional. How you frame data about people reflects values. People-first language, equity-aware color choices, inclusive framing, and accessible design are baseline requirements, not enhancements.

Topic Index

TopicReference File
Academic audience strategy./references/audience-analysis.md
Policy audience strategy./references/audience-analysis.md
Executive audience strategy./references/audience-analysis.md
Public audience strategy./references/audience-analysis.md
Media audience strategy./references/audience-analysis.md
Audience assessment checklist./references/audience-analysis.md
Pyramid Principle./references/narrative-frameworks.md
SCQA framework./references/narrative-frameworks.md
Three-Act Data Story./references/narrative-frameworks.md
"So What?" framework./references/narrative-frameworks.md
Data-Narrative-Visual Triad./references/narrative-frameworks.md
AIDA framework./references/narrative-frameworks.md
Framework selection guide./references/narrative-frameworks.md
Jargon translation table./references/plain-language.md
Reading level guidance./references/plain-language.md
Hedging language scale./references/plain-language.md
IPCC calibrated uncertainty./references/plain-language.md
Causal vs correlational language./references/plain-language.md
Word replacement list./references/plain-language.md
Executive summary template./references/deliverable-templates.md
Policy brief template./references/deliverable-templates.md
Stakeholder presentation template./references/deliverable-templates.md
Media talking points template./references/deliverable-templates.md
10-point communication checklist./references/communication-review.md
Seven deadly sins of statistics./references/communication-review.md
Communication pitfall catalog./references/communication-review.md
WCAG data communication standards./references/accessibility-equity.md
People-first language./references/accessibility-equity.md
Do No Harm principles./references/accessibility-equity.md
Alt text guidance./references/accessibility-equity.md
Colorblind-safe communication./references/accessibility-equity.md
Multi-format presentation./references/accessibility-equity.md
Mixed audience strategies./references/audience-analysis.md
Cross-audience comparison table./references/audience-analysis.md
Tone and register by audience./references/audience-analysis.md
Combining frameworks./references/narrative-frameworks.md
Framework-to-deliverable matching./references/narrative-frameworks.md
Hedging anti-patterns./references/plain-language.md
Number formatting standards./references/plain-language.md
Domain-specific jargon guidance./references/plain-language.md
How to distill long reports./references/deliverable-templates.md
Cross-deliverable consistency./references/deliverable-templates.md
Pre-release review protocol./references/communication-review.md
Comprehensive accessibility checklist./references/accessibility-equity.md
Stereotype-aware color choices./references/accessibility-equity.md
Evolving terminology guidance./references/accessibility-equity.md
Identity-first vs people-first language./references/accessibility-equity.md

Citation Responsibility

When reporting standards or communication frameworks from this skill shape how findings are presented in a DAAF report (causal language guidelines, uncertainty frameworks, equity-sensitive visualization principles), the report-writer includes the relevant citation in the report's Reporting Standards references section.

Each citation must include a brief rationale explaining why it is included.

For the master citation index and inclusion thresholds, consult agent_reference/CITATION_REFERENCE.md.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Guide for creating DAAF agent definition files. Covers 12-section template, hook registration, skills-in-frontmatter, integration checklist. Use when adding or revising agents. For SKILL.md files, use skill-authoring instead.

The English summary is being prepared. Showing the original description.

DAAF-Contribution-Community/daaf238Updated Oct 17, 2026

Researcher-facing analytic triangulation ("creative verification") for stress-testing provisional findings and designing pre-specified challenges before an analysis runs. Turns a researcher's concern or focal claim into competing explanations, bounded discriminating tests, audited diagnostic artifacts, and evidence-calibrated interpretations in a hypothesis/evidence ledger — behavioral, output-level verification replacing line-by-line code review. Covers 12 challenge families organized by Shadish-Cook-Campbell validity type, named sensitivity statistics, pre-committed interpretation rules, anti-fishing guardrails, and interactive diagnostic-artifact QA. Use in Ad Hoc Collaboration to verify, challenge, or stress-test a result, or to design discriminating tests before an analysis runs. Not code-change verification (verify skill / code review) and not final adjudication or re-execution (data-verifier, Reproducibility Verification) — prospective, hypothesis-driven challenge design of analytic claims.

The English summary is being prepared. Showing the original description.

DAAF-Contribution-Community/daaf238Updated Oct 17, 2026

In-situ smoke testing that verifies a LIVE DAAF deployment functions end-to-end in whatever provider route it is configured for. Auto-detects the active install route (anthropic-subscription, openrouter, chatgpt-subscription shim, openai-api shim) and runs tiered probes: Tier 0 free preflight (route/env coherence, hooks, statuslines, shim health); Tier 1 one live round-trip (~cents); Tier 2 a six-probe functional battery (dispatch, coding, web, skill loading, isolation-strip, nested-dispatch deny); Tier D a zero-cost deterministic battery (bats, Pester, lint, safety-hook tests). Use after install, after a rebuild or update, after any provider/config change (new API key, model remap, shim change), for pre-release validation, or when asked "is my install working" or to "smoke test the deployment/config." Requires the DAAF_DEV=1 dev image; a contributor tool, not end-user-facing. NOT DAAFBench (model behavioral-adherence evaluation under benchmarks/) and NOT scripts/smoke_tests/ (R/Python library-package smoke tests).

The English summary is being prepared. Showing the original description.

DAAF-Contribution-Community/daaf238Updated Oct 17, 2026

Operational framework for the DAAF orchestrator. Defines engagement modes, confirmation protocol, subagent dispatch, context budget, and reference-loading. Loaded exclusively by the orchestrator — not for subagents or user questions.

The English summary is being prepared. Showing the original description.

DAAF-Contribution-Community/daaf238Updated Oct 17, 2026

Data science methodology and method-selection routing for quantitative research. Covers EDA, data validation, descriptive analysis, causal inference (IV, DiD, RD, synthetic control), clustering/PCA/UMAP, supervised ML, geospatial analysis, network analysis, and visualization design. Contains the canonical method-to-library routing tree, routed by execution language — Python: statsmodels (OLS/GLM/time series), pyfixest (FE/DiD), linearmodels (RE/GMM/SUR), svy (complex surveys), scikit-learn (clustering/prediction ML), geopandas (spatial), igraph (network analysis); R: r-stats (OLS/GLM/time series), fixest (FE/DiD), plm (panel/RE/IV), survey-r (complex surveys), tidymodels (ML), sf-terra (spatial), igraph-r (network analysis). Load the routed tool-specific skill before giving tool-specific advice or writing code — library skills encode environment constraints and curated caveats absent from general knowledge.

The English summary is being prepared. Showing the original description.

DAAF-Contribution-Community/daaf238Updated Oct 17, 2026

Interpretation guidance for Urban Institute Education Data Portal datasets. The Portal is a curation layer over federal data: lowercase variable names, integer-encoded categoricals, standardized missing codes (-1 missing, -2 not applicable, -3 suppressed). Covers year definitions, grade encoding (grade=-1 is Pre-K, not missing), suppression rates, ODC-By licensing, and cross-source join identifiers. Load before analyzing any Portal data. Routes to source-specific deep-dive skills for individual datasets.

The English summary is being prepared. Showing the original description.

DAAF-Contribution-Community/daaf238Updated Oct 17, 2026

See all skills by DAAF-Contribution-Community

Report a problem with this skill