Ir Narrative BuilderSAFE
Overview
An agent skill published by revfactory.
459e1bb8f76eOBSERVED · 2026-10-12What 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.
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.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | NA |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (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.
459e1bb8f76efull audit observations/trust-audit/skill/revfactory__ir-narrative-builder.json · Report an issue / request a re-scanAudit history
Every audit this skill has had.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-12 | 459e1bb8f76e | SAFE | B | 89 | first audit |
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.