Skip to content
Back to skills

Story Engineer

ASecurity

Use when transforming evidence-rich project histories, case studies, launches, research journeys, or retrospectives into truthful narrative structures. Not for inventing greenfield brand concepts from sparse briefs.

  • 24 stars
  • 0 votes
  • 0 copies
  • 2 views
  • Added September 3, 2026
ai-agentsgo

Security analysis

A100/100

Pro scans all 4 files and shows the line behind each finding

Scanned September 3, 2026

npx -y skills add J-StaR-Films-Studios/VibeCode-Protocol-Suite --skill story-engineer --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Story Engineer?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Story Engineer
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/j-star-films-studios-story-engineer/badge)](https://www.skillsdirectory.com/skills/j-star-films-studios-story-engineer)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: story-engineer
description: Use when transforming evidence-rich project histories, case studies, launches, research journeys, or retrospectives into truthful narrative structures. Not for inventing greenfield brand concepts from sparse briefs.
author: J StaR Films / Takomi
coauthored: J StaR Films / Takomi
version: 2.0.0
---

# Story Engineer

Turn real events, artifacts, decisions, and outcomes into a compelling interface narrative without inventing drama or forcing every project through the same arc.

## Applicability

Use this skill when the material contains a meaningful transformation, investigation, trial, construction process, consequence, or sequence of discoveries.

For a sparse request such as “make a website for this business,” use a creative-direction workflow instead. A category name is not a project history.

## 1. Build the Evidence Ledger

Extract:

- Events and their actual order.
- Decisions and known causes.
- Artifacts that can be shown.
- Claims and their support.
- Accurate metrics that materially change understanding.
- Unknowns requiring confirmation.

Keep facts, interpretations, and unknowns distinguishable. Do not invent failures, competitions, milestones, quotations, metrics, or turning points.

### Completion Gate

- [ ] Narrative claims trace to supplied evidence.
- [ ] Missing facts remain visible.

## 2. Identify the Narrative Engine

Choose the real source of motion:

- Transformation
- Investigation
- Trial
- Construction
- Reframing
- Consequence

State it in one sentence. Use a contradiction or driving question only when the evidence earns it.

### Completion Gate

- [ ] The engine describes actual change or discovery.
- [ ] The proposed conclusion can answer it honestly.

## 3. Choose the Shape

Select among chronological, question-and-evidence, problem-attempt-resolution, artifact-first reconstruction, parallel comparison, or thematic chapters.

Protect a reveal only when early disclosure would weaken genuine discovery. Keep products, services, prices, locations, and primary actions available when visitors need them.

### Completion Gate

- [ ] Structure follows evidence rather than a fixed beat sheet.
- [ ] Essential utility is not sacrificed for suspense.

## 4. Construct the Rail

For every beat, specify:

1. Evidence introduced.
2. Question answered.
3. New understanding created.
4. Emotional register earned.
5. Artifact or data carrying the beat.
6. Any withheld information and the reason.

Remove beats that do not advance understanding, emotional context, or visitor action.

### Completion Gate

- [ ] Every beat changes what the visitor knows, feels, or can do.
- [ ] The ending resolves the narrative engine.

## 5. Translate into Interface

Define content, composition, optional visual metaphor, interaction, transition, and persistent utility for each beat. Prefer real artifacts over invented spectacle.

Use cinematic choreography only when time-based progression is essential. Editorial and utility-led narratives are equally valid.

For extended pattern vocabulary, consult [references/narrative-patterns.md](references/narrative-patterns.md). For physicalizing genuinely abstract evidence, consult [references/visual-metaphors.md](references/visual-metaphors.md). Treat [references/examples.md](references/examples.md) as historical examples, not reusable scripts.

### Final Gate

- [ ] Every claim and beat remains evidence-backed.
- [ ] The structure would change if the source material changed.
- [ ] Interaction deepens evidence rather than decorating it.
- [ ] Accessibility and essential visitor utility remain complete.

Files in this skill

  • SKILL.md3.6 KB
  • references/examples.md5.2 KB
  • references/narrative-patterns.md3.5 KB
  • references/visual-metaphors.md3 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.