Atlas / Skills / revfactory / Ir Narrative Builder

Ir Narrative BuilderSAFE

skills/revfactory/ir-narrative-builder
Verdict
SAFE
Grade
B
Trust score
89 /100
Version
—
Hosts
—
License
Apache-2.0
Stars
1,297
01

Overview

An agent skill published by revfactory.

Read from source at commit 459e1bb8f76eOBSERVED · 2026-10-12
02

What it tells the agent

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: ir-narrative-builder
description: "A skill that professionally supports investor report narrative construction. Used by strategy-updater and ir-reviewer when designing the tone, structure, and storyline of investor communications. Automatically applied in contexts such as 'investor narrative', 'equity story', 'IR message', 'strategy update story'. However, drafting statutory disclosure text or writing brokerage reports are outside the scope of this skill."
---

# IR Narrative Builder — Investor Communication Narrative Construction Tool

A specialized skill that enhances the investor narrative capabilities of strategy-updater and ir-reviewer agents.

## Target Agents

- **strategy-updater** — Equity Story construction, strategy narrative writing
- **ir-reviewer** — Narrative consistency verification, investor-type-specific tone review

## Equity Story 5-Stage Framework

```
1. WHY NOW — Why this market right now (market opportunity)
2. WHY US — Why us (competitive advantage)
3. PROOF POINTS — Is there evidence (performance data)
4. WHERE NEXT — What is the next step (growth strategy)
5. WHY INVEST — Why should you invest (value creation)
```

### Stage-by-Stage Writing Guide

| Stage | Core Question | Elements to Include | Cautions |
|-------|-------------|---------------------|----------|
| WHY NOW | Market inflection point | TAM/SAM/SOM, regulatory changes | Guard against overestimation |
| WHY US | Differentiation basis | Technology moat, network effects | Avoid abstract expressions |
| PROOF POINTS | Quantitative results | Revenue, customers, NPS | Guard against cherry-picking |
| WHERE NEXT | Execution roadmap | Product, market expansion | Feasibility |
| WHY INVEST | Valuation | Multiples, comparable companies | Conservative estimates |

## Narrative Tone by Investor Type

### For VCs
**Tone**: Vision-centered, emphasize growth potential
**Structure**: Executive Summary → Market Opportunity → Product Milestones → Growth Metrics → Team → Runway → Next Targets

### For PE
**Tone**: Numbers-centered, emphasize operational efficiency
**Structure**: Executive Summary → P&L/CF/BS → EBITDA Bridge → KPI Benchmarks → Value Creation Plan → Risks → Initiatives

### For Public Shareholders
**Tone**: Balanced, emphasize transparency
**Structure**: CEO Letter → Financial Highlights → Business Unit Performance → Market Environment → ESG → Shareholder Returns → Outlook

## EBITDA Bridge Construction

```
Prior Quarter EBITDA
  (+) Revenue increase effect
  (+) Margin improvement effect
  (-) Labor cost increase
  (-) Marketing cost increase
  (+/-) FX effect
  (+/-) One-time items
= Current Quarter EBITDA
```

**Principles:** List in order of magnitude, positive before negative, distinguish one-time vs. structural

## Narrative Quality Checklist (for ir-reviewer)

### Consistency Verification
- [ ] Do figures exactly match the financial analysis?
- [ ] Is the narrative direction consistent with the prior quarter report?
- [ ] Is the balance between positive/negative information appropriate?
- [ ] Do forward-looking statements have disclaimers?

### Persuasiveness Verification
- [ ] Do all claims have data-backed evidence?
- [ ] Are risks honestly disclosed?
- [ ] Do next quarter targets meet SMART criteria?

## Risk Disclosure 3-Level Matrix

| Grade | Criteria | Expression Approach |
|-------|---------|---------------------|
| HIGH | High probability and high impact risk | Specific response plan required |
| MEDIUM | Monitoring needed | Specify early warning indicators |
| LOW | Controllable | Brief mention |

**Principle:** Do not hide risks → build investor trust. Present risk + response plan as a pair.
03

Trust audit

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

LayerWhat it checksResult
L0Provenance & inventoryPASS
L1Static analysis of the codeNA
L2Instruction surface (what it tells the agent)PASS
L3Class-specific surfacePASS
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
none-observed
Network
none-observed
Shell
none-observed
Dependencies
pinned
Secrets in source
none-found

Findings (0)

No findings outside the package's declared scope.

Gates applied: no_behavioural_pass.

Audited 2026-10-12 · audit v0.4.1 · source sha 459e1bb8f76efull audit observations/trust-audit/skill/revfactory__ir-narrative-builder.json · Report an issue / request a re-scan
04

Audit history

Every audit this skill has had.

DateSourceVerdictGradeScoreChange
2026-10-12459e1bb8f76eSAFEB89first audit
05

Questions

Is Ir Narrative Builder safe to install?

The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean skill reads B.

What can Ir Narrative Builder access on my machine?

The audit observed no filesystem, network or shell use at all in its source.

How current is this page?

The grade is for one exact copy of the source (459e1bb8f76e), read on 2026-10-12. The repository is watched, and a new audit runs when it changes — this is the first audit.

Advertisement