NarrativeOS

NarrativeOS is an agentic skill and CLI for Solana hackathon teams that need a credible X strategy immediately after submitting a project.

It works like a small, local corpus-backed playbook: give it a project or founder profile, and it returns the story angle, content calendar, X Spaces/AMA strategy, engagement plan, and ready-to-post copy required by the SagaPad Colosseum Hackathon track.

Compatible with the skills CLI:

npx skills add dexarxbt/narrative-os

Install

npm install
npm run build

Run locally:

node dist/index.js quick --name "YourProject" --description "What it does for whom"

After publishing as an npm package or SagaPad skill, users can run:

npx narrative-os quick --name "YourProject" --description "What it does for whom"

Commands

Quick Project Playbook

node dist/index.js quick \
  --name "CompressedNFT" \
  --description "Compresses NFT storage on Solana for GameFi teams" \
  --tech-stack "Rust, Anchor, TypeScript"

Outputs:

• Archetype classification
• Clarity score
• Core story angle
• Narrative moat
• First 5 X posts

Deep Project Playbook

node dist/index.js deep \
  --name "CompressedNFT" \
  --description "Compresses NFT storage on Solana for GameFi teams" \
  --audience "GameFi studios and NFT marketplaces" \
  --tech-stack "Rust, Anchor, TypeScript" \
  --team-background "Protocol engineers and game infra builders"

Outputs:

• Core story angle
• 4-week content plan
• X Spaces to join with pre-written intros
• 5 AMA formats
• Community event calendar
• Engagement strategy
• First 5 posts

Founder Personal Brand Playbook

node dist/index.js founder \
  --name "Ada" \
  --building "an AI agent skill marketplace for Solana" \
  --background "technical founder" \
  --care-about "AI agents and developer tools" \
  --communication-style "analytical but casual"

Outputs:

• Founder voice archetype
• Unique POV
• 3 to 4 content pillars
• Writing style guide
• Weekly rhythm
• Engagement playbook
• First 10 posts in the founder's voice

Why This Fits The SagaPad Track

SagaPad asks for skills that help Colosseum projects win attention on X. NarrativeOS directly covers both listed topics:

• Topic 1: Hackathon Project Social Playbook
• Topic 2: Founder Personal Brand Playbook

It does not require credits or an external API key. The output is deterministic and can be tested by judges with a normal npm install && npm run build.

Repository Structure

narrative-os/
  skills/
    narrative-os/
      SKILL.md            <-- Professional skill manifest
      BREAKOUT_MODELS.md  <-- Documentation of winner patterns
  src/                    <-- Implementation logic
  examples/
    project-output.md
    founder-output.md

License

MIT