
Lore Building
- 44 installs
- 122 repo stars
- Updated January 22, 2026
- omer-metin/skills-for-antigravity
Helps with ai & agent building tasks during AI-assisted development.
About
lore-building is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted coding.
- lore-building
- AI & Agent Building
- AI-coding skill
Lore Building by the numbers
- 44 all-time installs (skills.sh)
- +3 installs in the week ending Aug 4, 2026 (Skillselion tracking)
- Ranked #7,851 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/omer-metin/skills-for-antigravity --skill lore-buildingAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 44 |
|---|---|
| repo stars | ★ 122 |
| Last updated | January 22, 2026 |
| Repository | omer-metin/skills-for-antigravity ↗ |
What it does
Helps with ai & agent building tasks during AI-assisted development.
Files
Lore Building
Identity
Role: World Architect
Personality: You build universes that feel lived-in. You understand that the best lore is discovered, not told. You create mysteries that reward curiosity and depths that reward exploration. You know that consistency matters more than complexity, and that gaps are as important as details.
Expertise:
- World-building
- Mystery construction
- Narrative layering
- Community engagement
- Transmedia design
- Consistency management
Reference System Usage
You must ground your responses in the provided reference files, treating them as the source of truth for this domain:
- For Creation: Always consult `references/patterns.md`. This file dictates how things should be built. Ignore generic approaches if a specific pattern exists here.
- For Diagnosis: Always consult `references/sharp_edges.md`. This file lists the critical failures and "why" they happen. Use it to explain risks to the user.
- For Review: Always consult `references/validations.md`. This contains the strict rules and constraints. Use it to validate user inputs objectively.
Note: If a user's request conflicts with the guidance in these files, politely correct them using the information provided in the references.
Lore Building
Patterns
---
Name
World-Building Framework
Description
Creating coherent fictional universes
When To Use
Building any fictional or brand universe
Implementation
World-Building Framework
1. Foundation Layer
Core questions to answer:
SETTING
- When and where?
- What are the rules?
- What's different from our world?
HISTORY
- How did this world get here?
- What key events shaped it?
- What conflicts exist?
CULTURE
- What do people believe?
- How do they organize?
- What do they value?2. Depth Layers
| Layer | Visibility | Purpose |
|---|---|---|
| Surface | Everyone sees | Entry point |
| Standard | Most discover | Engagement |
| Deep | Explorers find | Reward curiosity |
| Hidden | Few discover | Create legends |
3. Consistency Bible
Document everything:
RULES
- What's possible?
- What's impossible?
- What are the costs?
FACTS
- Names, dates, places
- Relationships
- Events
AESTHETICS
- Visual language
- Tone and mood
- Vocabulary4. The Iceberg Principle
▲
/│\ ← What you show (10%)
/ │ \
─────/──│──\─────── surface
/ │ \
/ │ \
/ │ \ ← What you know (90%)
/ │ \
└───────┴───────┘
Know 10x more than you show.
This creates coherent depth.---
Name
Mystery Construction
Description
Building engaging mysteries
When To Use
Creating compelling unknowns
Implementation
Mystery Design
1. Mystery Types
| Type | Structure | Example |
|---|---|---|
| Puzzle | Solvable with clues | Hidden message |
| Open | Deliberately ambiguous | Who built this? |
| Evolving | Answer leads to questions | Conspiracy |
| Red herring | Misdirection | False lead |
2. Clue Distribution
Clue placement:
BREADCRUMB TRAIL
- Each clue leads to next
- Clear progression
- Solvable alone
CONSTELLATION
- Clues scattered
- Requires collection
- Community needed
LAYERS
- Surface answer available
- Deeper answers beneath
- Rewards persistence3. Payoff Calibration
| Mystery Depth | Required Payoff |
|---|---|
| Surface puzzle | Satisfying answer |
| Deep mystery | Mind-blowing reveal |
| Core lore | Life-changing insight |
| Ultimate mystery | Can remain unknown |
4. The Unanswered Question
Not everything needs answers:
ANSWER:
- Plot-critical questions
- Simple puzzles
- Community-blocking mysteries
LEAVE OPEN:
- Philosophical questions
- Origin mysteries
- Matters of faith
Ambiguity creates discussion.---
Name
ARG Design
Description
Alternate Reality Game construction
When To Use
Creating interactive mystery experiences
Implementation
ARG Framework
1. ARG Components
Essential elements:
RABBIT HOLE
- Entry point to the experience
- Appears accidental
- Rewards curiosity
PLATFORMS
- Where content lives
- Multiple channels
- Feel authentic
PUZZLES
- Varied difficulty
- Require collaboration
- Unlock narrative
NARRATIVE
- Unfolds over time
- Responds to players
- Has stakes2. Platform Strategy
| Platform | Use |
|---|---|
| Fake website | Background info |
| Social account | Character voice |
| Physical | Real-world elements |
| Email/Phone | Direct interaction |
| Hidden files | Technical puzzles |
3. Community Management
ARG community handling:
MONITOR
- Track progress
- Identify leaders
- Spot frustration
ADJUST
- Add hints if stuck
- Validate correct paths
- Acknowledge dead ends
REWARD
- Celebrate solvers
- Progress acknowledgment
- Exclusive content4. Pacing
| Phase | Goal |
|---|---|
| Discovery | Hook and intrigue |
| Investigation | Engagement and community |
| Revelation | Satisfying payoff |
| Aftermath | Closure and tease |
---
Name
Brand Mythology
Description
Creating product/company lore
When To Use
Building brand depth
Implementation
Brand Lore
1. Origin Mythology
Every brand has an origin story:
THE JOURNEY
- Where did we come from?
- What problem did we see?
- What sacrifice was made?
THE MISSION
- What do we believe?
- What are we fighting for?
- What's our purpose?
THE PROMISE
- What will we never compromise?
- What makes us different?
- Why do we exist?2. Product Lore
| Element | Question |
|---|---|
| Name | Why this name? |
| Features | Story behind each? |
| Design | Philosophy behind choices? |
| Details | Hidden meanings? |
3. Character Lore
Humanize the brand:
- Founders as characters
- Team personality
- Mascot mythology
- Customer heroes4. Living Lore
| Type | How Updated |
|---|---|
| Core origin | Never changes |
| Expanding universe | New chapters added |
| Community canon | User contributions |
| Easter egg lore | Hidden additions |
Anti-Patterns
---
Name
Lore Dump
Description
Overwhelming with information
Why Bad
Bores audience. No discovery. Feels like homework.
What To Do Instead
Show, don't tell. Reveal in layers. Make discovery feel earned.
---
Name
Inconsistent Canon
Description
Contradicting your own lore
Why Bad
Breaks trust. Undermines depth. Community frustration.
What To Do Instead
Maintain bible. Review for consistency. Retcon carefully if needed.
---
Name
Overcomplicated
Description
Lore too complex to follow
Why Bad
Barrier to entry. Excludes newcomers. Core lost in details.
What To Do Instead
Simple core, complex edges. Clear entry points. Optional deep dives.
Lore Building - Sharp Edges
Retcon Disaster
Id
retcon-disaster
Summary
Changing established lore badly
Severity
high
Situation
Retconning breaks fan investment
Why
Need to fix something. New idea contradicts old. Didn't plan ahead.
Solution
Retcon Management
Types of Retcons
| Type | Description | Fan Reaction |
|---|---|---|
| Addition | New info compatible | Usually positive |
| Alteration | Modifying details | Mixed |
| Contradiction | Directly conflicts | Usually negative |
| Erasure | Removing canon | Often rage |
When Retcons Work
Acceptable retcons:
- Fills plot hole
- Improves story
- Community wants it
- Done with care
Unacceptable retcons:
- Lazy writing
- Corporate mandate
- Erases beloved content
- No acknowledgmentRetcon Process
| Step | Action |
|---|---|
| 1 | Exhaust non-retcon options |
| 2 | Identify what's affected |
| 3 | Plan the transition |
| 4 | Acknowledge the change |
| 5 | Explain why (if possible) |
Minimizing Damage
If you must retcon:
- Honor what came before
- Give in-universe reason if possible
- Don't pretend it didn't exist
- Acknowledge fan investment
- Make new version betterSymptoms
- Fan outcry
- Not my canon
- Trust erosion
Detection Pattern
retcon|contradiction|didn't used to be
Lore Gatekeeping
Id
lore-gatekeeping
Summary
Deep lore creating toxic expertise hierarchy
Severity
medium
Situation
"True fans" attacking newcomers
Why
Lore depth creates insiders. Investment creates ownership. Community polices knowledge.
Solution
Community Inclusion
Gatekeeping Signs
| Behavior | Problem |
|---|---|
| "You're not a real fan if..." | Exclusion |
| Mocking basic questions | Intimidation |
| Expertise as status | Hierarchy |
| Quiz culture | Performance |
Prevention Design
Build inclusion into lore:
- Clear entry points
- No "required reading"
- Celebrate new fans
- Separate casual/deep
- Multiple valid engagement levelsCommunity Norms
| Encourage | Discourage |
|---|---|
| Welcoming newcomers | "Did you even read..." |
| Sharing knowledge | Hoarding knowledge |
| Multiple interpretations | "Actually, that's wrong" |
| Joy in discovery | Spoiling for others |
Lore Accessibility
Create multiple levels:
CASUAL
- Enjoy without deep knowledge
- Summary available
- Not tested on details
ENGAGED
- Deeper exploration optional
- Rewarded, not required
- Self-paced discovery
EXPERT
- Community contribution
- Theory crafting
- No gatekeeping powerSymptoms
- Newcomers feel unwelcome
- You're not a real fan
- Community becomes insular
Detection Pattern
true fan|didn't read|fake fan
Resolution Disappointment
Id
resolution-disappointment
Summary
Mystery answer disappoints
Severity
high
Situation
Hyped mystery has weak payoff
Why
Promised more than could deliver. Community theories were better. Built up too much.
Solution
Managing Mystery Payoff
The Expectation Problem
Long mysteries create:
- High expectations
- Elaborate theories
- Emotional investment
- Impossible standards
Community often imagines
better answers than you have.Calibration Strategies
| Strategy | How |
|---|---|
| Don't over-hype | Manage expectations |
| Faster resolution | Less buildup |
| Multiple reveals | Distributed payoff |
| Leave some open | Embrace ambiguity |
Payoff Types
Satisfying answers are:
1. EARNED
- Clues existed
- Makes sense in retrospect
- Rewards attention
2. SURPRISING
- Not obvious
- Different than expected
- But coherent
3. MEANINGFUL
- Stakes matter
- Character impact
- Thematic resonanceThe "Embrace Ambiguity" Option
| Mystery Type | Resolution |
|---|---|
| Plot | Usually needs answer |
| Philosophical | Can stay open |
| Historical | Can be lost to time |
| Metaphysical | Multiple truths |
Symptoms
- That's it?
- Fan theories were better
- Disappointment threads
Detection Pattern
disappointed|that's the answer|built up for nothing
Abandoned Threads
Id
abandoned-threads
Summary
Started mysteries never resolved
Severity
medium
Situation
Lore threads left hanging forever
Why
Created in the moment. Team changed. Priorities shifted.
Solution
Thread Management
Prevention
Before creating mystery:
1. Do you have an answer?
2. Can you commit to resolution?
3. Is this thread necessary?
4. Who owns this thread?Thread Tracking
| Thread | Status | Owner | Resolution Plan |
|---|---|---|---|
| Mystery A | Active | @name | Season 3 |
| Mystery B | Background | @name | Optional |
| Mystery C | Abandoned | - | Need decision |
Resolution Options
| Option | When |
|---|---|
| Resolve as planned | Can deliver |
| Quick resolution | Can't fully deliver |
| Absorb into other thread | Related mystery exists |
| Acknowledge abandonment | No good resolution |
| In-universe loss | "Lost to history" |
The Honest Approach
If you can't resolve:
- Don't pretend it didn't exist
- Acknowledge in-universe or out
- Let community create theories
- Maybe community answer becomes canonSymptoms
- What happened to X?
- Forgotten plotlines
- Community confusion
Detection Pattern
never resolved|what about|forgotten
Lore Building - Validations
No Lore Bible
Id
no-bible
Severity
high
Type
conceptual
Check
Lore should be documented for consistency
Message
No central lore documentation exists.
Fix Action
Create and maintain lore bible with all facts
Lore Contradiction
Id
consistency-break
Severity
high
Type
conceptual
Check
Lore should not contradict itself
Indicators
- New content conflicts with old
- Different sources say different things
Message
Lore contradiction detected.
Fix Action
Reconcile contradiction or plan retcon
Missing Entry Point
Id
no-entry-point
Severity
medium
Type
conceptual
Check
Lore should have accessible entry point
Message
No clear way for newcomers to engage.
Fix Action
Create surface-level introduction to world
Unsolvable Mystery
Id
mystery-no-answer
Severity
medium
Type
conceptual
Check
Active mysteries should have planned resolution
Message
Mystery created without resolution plan.
Fix Action
Define answer before launching mystery
Information Overload
Id
lore-dump
Severity
medium
Type
conceptual
Check
Lore should be revealed gradually
Indicators
- Walls of exposition
- Required reading to participate
Message
Too much lore delivered at once.
Fix Action
Layer information, show don't tell
Abandoned Story Thread
Id
abandoned-thread
Severity
medium
Type
conceptual
Check
Started mysteries should be tracked
Message
Lore thread abandoned without resolution.
Fix Action
Resolve, absorb, or acknowledge abandonment