Lore Creation

This skill provides guidance for creating structured lore - organized knowledge documentation that persists across sessions.

When to Use This Skill

Use this skill when you need to:

• Create structured knowledge documentation
• Build a project knowledge base
• Document complex systems or processes
• Establish persistent information repositories

Lore Structure

Basic Lore Document

# [Topic Name]

## Overview
Brief description of what this lore covers.

## Key Concepts
- Concept 1: Definition
- Concept 2: Definition

## Details

### Section 1
Detailed information about aspect 1.

### Section 2
Detailed information about aspect 2.

## Examples
Concrete examples demonstrating the concepts.

## References
Links to related lore or external resources.

Creating Effective Lore

1. Start with Overview

Always begin with a high-level summary:

• What is this about?
• Why is it important?
• Who needs to know this?

2. Define Terms

Establish shared vocabulary:

• Define domain-specific terms
• Use consistent naming
• Link to definitions

3. Structure Hierarchically

Organize information logically:

• General to specific
• Overview → Details → Examples
• Group related concepts

4. Include Examples

Demonstrate with concrete cases:

• Real-world usage
• Code snippets
• Diagrams if helpful

5. Cross-Reference

Link related lore:

• See also: [Related Topic](./related-topic.md)
• Build a connected knowledge graph

Lore Categories

Process Lore

How things work:

• Workflows
• Procedures
• Decision trees

Domain Lore

What things are:

• Concepts
• Definitions
• Architecture

Historical Lore

Why things are:

• Decisions made
• Rationale
• Evolution

Reference Lore

Quick lookup:

• Commands
• Configurations
• Patterns

Best Practices

Keep It Current

• Update when things change
• Mark outdated sections
• Version important documents

Make It Searchable

• Use clear headings
• Include keywords
• Add tags/metadata

Write for the Reader

• Assume minimal context
• Explain acronyms
• Provide navigation

Validation Checklist

Before finalizing lore:

• Overview explains purpose
• Key terms defined
• Logically structured
• Examples included
• Cross-references added
• Updated date noted