Skip to main content
skill CX Codex

impact-report-writer — Claude Code skill for impact reports

The impact-report-writer skill helps structure program impact reports, choose outcome metrics, and plan data visualizations. Use it for annual reports or program evaluations.

MIT 145 installs ★ 114 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add travisjneuman/.claude --skill impact-report-writer -a claude-code
Open on GitHub

What impact-report-writer does

The skill lays out report sections for a leadership letter, mission, key figures, program highlights, participant stories, finances, and future plans. Its metrics framework distinguishes activities delivered from changes for participants and longer-term effects. That distinction matters: a service count alone does not show what changed for the people served.

It includes metric and chart selection guidance, a participant story outline, and advice for respectful storytelling. For instance, it pairs bar charts with program comparisons and line charts with trends over time. You’ll need program data and outcome figures to build the report. Participant stories should be shared with consent and preserve the person’s agency.

What it helps with

  • organize an annual report into clear sections
  • separate service counts from participant outcomes and long-term impact
  • choose charts for program comparisons and financial summaries
  • present participant stories with consent and respect

Example prompts for the agent

  • Draft an annual impact report outline from our program results and financial figures.
  • Sort these metrics into activities, participant outcomes, and long-term impact.
  • Suggest charts for comparing program outcomes and showing revenue sources.

How to install impact-report-writer

1Skills CLI (Vercel)

npx skills add travisjneuman/.claude --skill impact-report-writer -a claude-code

2Manually: put the files in place

~/.claude/skills/impact-report-writer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/impact-report-writer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about impact-report-writer

How do I install impact-report-writer in Claude Code?

Run npx skills add travisjneuman/.claude --skill impact-report-writer -a claude-code. The skill file is at ~/.claude/skills/impact-report-writer/SKILL.md.

What does impact-report-writer do?

It helps plan impact reports, select metrics and charts, and present program outcomes, finances, and participant stories.

What information do I need to prepare a report?

Gather program data, outcome measures, and financial figures. For participant stories, the skill calls for written consent and review by the person featured.

Source text

SKILL.md · MIT
---
name: impact-report-writer
description: Nonprofit/NGO impact report generation with data visualization suggestions, outcome metrics, narrative structure, and program data presentation. Use when writing impact reports, annual reports, or program evaluation summaries.
---

# Impact Report Writer

Frameworks for creating compelling impact reports that communicate program outcomes, organizational effectiveness, and social change to stakeholders, funders, and the public.

## Impact Report Structure

### Standard Report Template

```
IMPACT REPORT: [Organization Name]
Reporting Period: [Fiscal Year / Program Period]

1. LETTER FROM LEADERSHIP (1 page)
   - Personal voice from ED/CEO
   - Year's theme or narrative arc
   - Highlight 1-2 major achievements
   - Thank supporters

2. MISSION AND VISION (half page)
   - Mission statement
   - Vision statement
   - Theory of change (brief)

3. YEAR IN NUMBERS (1-2 pages — highly visual)
   - 5-8 key metrics as large callout numbers
   - Simple icons or graphics per metric
   - Year-over-year comparison where relevant
   - Geographic reach map (if applicable)

4. PROGRAM HIGHLIGHTS (3-5 pages)
   For each major program:
   - Program description (2-3 sentences)
   - Key outcomes with data
   - Beneficiary story/testimonial
   - Photo or visual element

5. STORIES OF IMPACT (2-3 pages)
   - 2-3 detailed beneficiary narratives
   - Before/during/after arc
   - Direct quotes
   - Respectful, consent-based storytelling

6. FINANCIAL SUMMARY (1-2 pages)
   - Revenue by source (pie chart)
   - Expenses by category (pie chart)
   - Program vs admin ratio
   - Year-over-year financial comparison
   - Key financial health indicators

7. DONORS AND SUPPORTERS (1-2 pages)
   - Donor acknowledgment lists (by tier)
   - Partner organizations
   - Volunteer recognition
   - In-kind supporters

8. LOOKING AHEAD (1 page)
   - Next year's goals
   - Strategic priorities
   - Call to action for supporters
   - How to get involved
```

## Metrics and Outcomes

### Output vs Outcome vs Impact

| Level | Definition | Example | Measurement |
|-------|-----------|---------|-------------|
| **Outputs** | What you did / produced | "Served 500 meals" | Activity logs, counts |
| **Outcomes** | What changed for beneficiaries | "85% reported reduced food insecurity" | Surveys, assessments |
| **Impact** | Long-term systemic change | "Neighborhood child malnutrition rate dropped 15%" | Population-level data |

### Metrics Selection Framework

```
METRICS FRAMEWORK:

REACH METRICS (How many?):
  - People served: ______
  - Communities reached: ______
  - Programs delivered: ______
  - Hours of service: ______
  - Volunteers engaged: ______

DEPTH METRICS (How much change?):
  - % showing improvement: _____%
  - Average change in [indicator]: ______
  - Completion/graduation rate: _____%
  - Satisfaction score: ______/10

DURATION METRICS (How lasting?):
  - 6-month follow-up retention: _____%
  - 12-month sustained outcomes: _____%
  - Recidivism/relapse rate: _____%
  - Long-term tracking data: ______

EFFICIENCY METRICS (At what cost?):
  - Cost per beneficiary served: $______
  - Cost per outcome achieved: $______
  - Program expense ratio: _____%
  - Fundraising efficiency: _____%

COMPARISON:
  - Year-over-year change: _____%
  - Benchmark vs similar orgs: ______
  - Goal vs actual: ______
```

### Year-in-Numbers Page Design

```
YEAR IN NUMBERS LAYOUT:

[Large number]    [Icon]    [Label]
12,500            [people]  People Served

[Large number]    [Icon]    [Label]
94%               [chart]   Satisfaction Rate

[Large number]    [Icon]    [Label]
$2.3M             [dollar]  Programs Delivered

[Large number]    [Icon]    [Label]
85%               [arrow]   Showed Improvement

[Large number]    [Icon]    [Label]
47                [map pin] Communities Reached

[Large number]    [Icon]    [Label]
1,200             [hands]   Volunteer Hours

DESIGN RULES:
  - Maximum 8 metrics on one page
  - Use the largest, most impressive numbers
  - Round to clean numbers (12,500 not 12,487)
  - Include one comparison ("up 23% from last year")
  - Use consistent icon style
  - White space between metrics
```

## Data Visualization Guidelines

### Chart Selection Guide

| Data Type | Recommended Chart | When to Use |
|-----------|------------------|-------------|
| **Part of whole** | Pie or donut chart | Revenue by source, expense breakdown |
| **Comparison** | Bar chart (horizontal) | Program outcomes side by side |
| **Change over time** | Line chart | Multi-year trend data |
| **Before/after** | Paired bar chart | Pre-post program comparison |
| **Geographic** | Map with color coding | Where programs operate |
| **Single metric** | Large callout number | Year-in-numbers hero stats |
| **Progress** | Progress bar or gauge | Goal completion percentage |
| **Ranking** | Horizontal bar (sorted) | Top programs by outcome |

### Visualization Best Practices

```
DATA VIZ RULES FOR IMPACT REPORTS:

DO:
  ✓ Start bar charts at zero
  ✓ Label data points directly (avoid legends when possible)
  ✓ Use organization's brand colors
  ✓ Include data source and date
  ✓ Round numbers for readability
  ✓ Use consistent scales across similar charts
  ✓ Make charts accessible (alt text, patterns not just color)

DON'T:
  ✗ Use 3D charts (distorts perception)
  ✗ Use more than 5-6 colors in one chart
  ✗ Include raw data tables (summarize visually)
  ✗ Use pie charts with more than 5 slices
  ✗ Truncate axes to exaggerate change
  ✗ Present data without context or comparison
```

## Storytelling Framework

### Beneficiary Story Template

```
IMPACT STORY TEMPLATE:

TITLE: [Compelling, human-centered headline]

THE CHALLENGE (2-3 sentences):
  [Describe the situation before your intervention]
  [Include specific, relatable details]
  [Build empathy without exploiting vulnerability]

THE JOURNEY (3-5 sentences):
  [How the person connected with your program]
  [What services/support they received]
  [Key moments of growth or breakthrough]
  [Direct quote from the beneficiary]

THE OUTCOME (2-3 sentences):
  [Measurable change in their situation]
  [How their life is different now]
  [Forward-looking statement about their future]

PULL QUOTE:
  "[Powerful direct quote that captures the transformation]"
  — [First name], [program name] participant

ETHICAL STORYTELLING CHECKLIST:
  [ ] Informed written consent obtained
  [ ] Story reviewed and approved by subject
  [ ] Subject chose how to be identified (name, photo)
  [ ] Story preserves dignity and agency
  [ ] Subject is portrayed as active, not passive
  [ ] No poverty porn or exploitation of vulnerability
  [ ] Cultural context respected
```

## Financial Transparency

### Financial Summary Template

```
FINANCIAL SUMMARY: FY [Year]

REVENUE:                           AMOUNT        %
  Government grants               $________     ___%
  Foundation grants                $________     ___%
  Individual donations             $________     ___%
  Corporate sponsorship            $________     ___%
  Program/earned revenue           $________     ___%
  Other                            $________     ___%
  TOTAL REVENUE:                   $________     100%

EXPENSES:                          AMOUNT        %
  Program services                 $________     ___%
  Management and general           $________     ___%
  Fundraising                      $________     ___%
  TOTAL EXPENSES:                  $________     100%

KEY RATIOS:
  Program expense ratio:           ___% (target: >75%)
  Admin expense ratio:             ___% (target: <15%)
  Fundraising expense ratio:       ___% (target: <10%)

  Revenue growth (YoY):            ___%
  Operating surplus/deficit:       $_______
  Months of operating reserves:    ___ months

NOTES:
  - Audited financial statements available upon request
  - [Organization] is a 501(c)(3) tax-exempt organization
  - EIN: [Number]
```

## Report Design Guidelines

### Accessibility and Readability

```
DESIGN STANDARDS:

TYPOGRAPHY:
  - Body text: 11-12pt minimum
  - Headlines: 18-24pt
  - Call-out numbers: 36-72pt
  - Line spacing: 1.4-1.6
  - Maximum line width: 75 characters

COLOR:
  - Use brand colors consistently
  - Ensure 4.5:1 contrast ratio for text
  - Don't use color as the only way to convey information
  - Limit palette to 3-5 colors

LAYOUT:
  - White space is a feature, not waste
  - One hero element per spread
  - Photos of real people (with consent)
  - Infographics over data tables
  - Consistent page grid throughout

ACCESSIBILITY:
  - Alt text for all images and charts
  - Logical reading order for screen readers
  - Tagged PDF for digital distribution
  - Available in multiple formats (print, digital, plain text)
```

## See Also

- [Grant Proposal Builder](../grant-proposal-builder/SKILL.md)
- [Fundraising Analyzer](../fundraising-analyzer/SKILL.md)
- [Data Science](../data-science/SKILL.md)

© travisjneuman · MIT · travisjneuman/.claude

Similar skills

All skills for Writing and docs →
grant-rfp-writer official anthropics grant-rfp-writer finds grants and solicitations your organization qualifies for, decides whether to bid, and drafts the response from past submissions. After an award it tracks deadlines and reports. CX Codex +1 392installs agency-grant-writer huytran1120 agency-grant-writer is a Claude Code skill for researching funders and preparing grant applications for nonprofits, research institutions, and social enterprises. It covers the grant cycle through post-award reporting. CX Codex +1 ★ 85repo stars tufte-report glebis tufte-report is a Claude Code skill that builds HTML reports with interactive charts and tables in Edward Tufte’s style, for presenting data with minimal decoration. CX Codex +1 202installs report-with-html daymade report-with-html is a Claude Code skill that builds standalone visual HTML reports, dashboards, and review workbenches. Activates on requests for browser-based reports or interactive data views. CX Codex +1 143installs power-bi-report-design-consultation official github The power-bi-report-design-consultation skill guides Power BI report planning, from chart choices to page layout and accessibility. Use it when a report needs to support specific decisions for a defined audience. CX Codex +1 9,390installs pdf-report-generator datadrivenconstruction The pdf-report-generator skill automates PDF report creation from construction project data. Combines charts, tables, and KPIs into a formatted document without manual assembly. CX Codex +1 132installs

From the same set117

The whole set →
security This Claude Code skill covers security architecture, incident response, and vulnerability assessment. It activates for security program design, incident handling, and reviews against frameworks such as NIST and ISO 27001. CX Codex +1 148installs generic-code-reviewer generic-code-reviewer inspects code diffs for security risks, runtime errors, bundle bloat, and WCAG AA gaps. It adapts checks to your project stack and enforces workflow rules from CLAUDE.md. CX Codex +1 147installs monitoring-observability monitoring-observability equips AI coding agents to set up OpenTelemetry, structured JSON logging, and distributed tracing. Useful when defining SLO alerts or instrumenting services. CX Codex +1 146installs codebase-documenter codebase-documenter turns a repository into readable docs: README, architecture overview, onboarding guide, API reference and code comments. Handy when someone new has to understand the project. CX Codex +1 145installs frontend-enhancer frontend-enhancer polishes the visual side of a web app: palette, layout, motion, component states. Useful when the UI still reads as a stock starter. CX Codex +1 145installs status-report-generator The status-report-generator Claude Code skill builds project status reports from Git activity, task context, and milestone tracking. It can create weekly updates, sprint reviews, and stakeholder reports. CX Codex +1 145installs generic-ux-designer generic-ux-designer — a UX skill for Claude and other coding agents: design-thinking steps, heuristic review and accessibility checks, packaged as checklists the agent follows. CX Codex +1 145installs performance-engineering performance-engineering — a skill for Claude Code designed for full-stack web application performance optimization. Activates when Core Web Vitals drop, bundle sizes increase, or page response times degrade. CX Codex +1 144installs

Project sponsors

Companies that keep this analytics open