# Executive Brief Writer

> Writes a 1-page executive brief from dense technical or project content. No puffery, every sentence earns its place.

- **Type:** Skill
- **Install:** `agentstack add skill-nicholashidalgo-claude-skillforge-executive-brief-drafter`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [nicholashidalgo](https://agentstack.voostack.com/s/nicholashidalgo)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [nicholashidalgo](https://github.com/nicholashidalgo)
- **Source:** https://github.com/nicholashidalgo/claude-skillforge/tree/main/writing/executive-brief-drafter

## Install

```sh
agentstack add skill-nicholashidalgo-claude-skillforge-executive-brief-drafter
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# executive-brief-writer

**Purpose:** Distill a complex project, proposal, or decision into a 1-page executive brief with situation, recommendation, evidence, and ask.

## Input Schema

| Field | Type | Required |
|---|---|---|
| `title` | string | yes |
| `situation` | string | yes - 2-3 sentence context |
| `recommendation` | string | yes |
| `supporting_evidence` | string[] | yes - 3-5 data points |
| `risks` | string[] | yes |
| `ask` | string | yes - what exec needs to decide or approve |
| `preserve_facts` | string[] | yes |

```json
{
  "title": "Migrate billing to Stripe - Q2 decision",
  "situation": "Current billing provider charges 2.9% + $0.30 per transaction. Stripe charges 2.5% + $0.15. At $3M/month volume, the delta is $12,000/month.",
  "recommendation": "Migrate to Stripe by June 30.",
  "supporting_evidence": ["$12K/month savings = $144K/year", "Migration estimated 6 weeks engineering", "Zero-downtime cutover proven via 3 internal dry runs"],
  "risks": ["1-week risk window during cutover", "EU tax reporting requires Stripe Tax add-on ($500/month)"],
  "ask": "Approve migration budget ($15K eng time + $500/mo Stripe Tax)",
  "preserve_facts": ["$12K/month", "$144K/year", "June 30", "3 dry runs"]
}
```

## Prompt Flow

**Pass 1:** Write tight, structured brief: Situation (2 sentences), Recommendation (1-2 sentences), Evidence (3-5 bullets), Risks (2-3 bullets), Ask (1 sentence). Remove: P1, P4, P5, P7, P14, P15, P22, P24.

**Pass 2:** "What in this brief wastes a busy exec's time?" -> trim aggressively. Final should be under 350 words.

## Examples

### Short - situation sentence
**Before:** "The current billing infrastructure serves as a pivotal component in our financial ecosystem, underscoring the transformative potential of modernization."
**After:** "Our billing provider charges $12K/month more than Stripe at current transaction volume."

### Medium - evidence section
**Before:** "Additionally, industry observers have noted that payment infrastructure modernization fosters long-term scalability and vibrant growth opportunities."
**After:** "Evidence: (1) $144K/year savings at $3M/month volume. (2) 6-week migration with 3 completed dry runs. (3) Zero-downtime cutover confirmed in staging."

### Long

## Unit Tests

```python
# tests/skills/test_executive_brief_writer.py
from ai_pattern_scrubber import detect_patterns

SITUATION = "Our billing provider charges $12K/month more than Stripe at current transaction volume."
EVIDENCE = "Evidence: $144K/year savings. 6-week migration, 3 dry runs completed. Zero-downtime confirmed in staging."

def test_situation_no_significance_inflation():
    assert not [h for h in detect_patterns(SITUATION) if h.id == 1]

def test_evidence_no_ai_vocab():
    assert not [h for h in detect_patterns(EVIDENCE) if h.id == 7]

def test_evidence_no_weasel_words():
    assert not [h for h in detect_patterns(EVIDENCE) if h.id == 5]
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [nicholashidalgo](https://github.com/nicholashidalgo)
- **Source:** [nicholashidalgo/claude-skillforge](https://github.com/nicholashidalgo/claude-skillforge)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-nicholashidalgo-claude-skillforge-executive-brief-drafter
- Seller: https://agentstack.voostack.com/s/nicholashidalgo
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.