List Builder

List Builder: Entropy List Curation Skill

You build comprehensive, high-quality lists for creative randomization. These lists feed into entropy tools that inject unpredictability into story development.

Core Principle

Good entropy lists have three properties:

1. Size — Large enough (50-200+ items) to feel genuinely random
2. Variety — Spans the full possibility space, not just obvious examples
3. Specificity — Concrete enough to spark ideas, not vague categories

LLMs are good at research, categorization, and quality control. Scripts are good at storage and random selection. This skill bridges them.

Dataset Maturity Levels

See references/dataset-quality-criteria.md for complete criteria.

Key metrics:

• Size: Large enough for genuine randomness
• Variety: Covers all relevant dimensions (see criteria doc)
• Specificity: Concrete enough to spark ideas (20-60 char average)
• Freshness: >30% items that surprise (not first-thought)

Current built-in lists are Starter/Functional level. This skill exists to build them up to Production.

List Quality Criteria

What Makes a Good List Item

Good: "Elevator inspector" (specific, unexpected, sparks questions) Bad: "Office worker" (generic, expected, no hooks)

Good: "Self-storage facility at midnight" (specific time, atmosphere implied) Bad: "Building" (too vague to use)

Good: "They're solving a completely different case that uses same evidence" (specific collision mechanism) Bad: "They get in the way" (no mechanism, just effect)

Variety Dimensions

When building a list, ensure coverage across relevant dimensions:

Professions:

• Industries (medical, legal, construction, arts, service, tech)
• Status levels (entry-level to expert)
• Visibility (public-facing vs. behind-scenes)
• Unusual vs. common
• Historical vs. modern vs. emerging

Locations:

• Public vs. private
• Indoor vs. outdoor
• Urban vs. rural vs. suburban
• Time of day implications
• Emotional valence (creepy, mundane, sacred, liminal)

Character traits:

• Positive vs. negative vs. neutral
• Visible vs. hidden
• Self-aware vs. blind spots
• Stable vs. situational

Research Process

Step 1: Define the List

• What category of things?
• What will it be used for?
• What makes an item useful vs. useless?
• Target size (minimum 50, ideally 100+)

Step 2: Seed with Obvious Examples

Start with 10-20 items that come to mind immediately. These are the "available" options—the ones that would occur to anyone. They're valid but not sufficient.

Step 3: Research for Variety

Use available sources to expand beyond obvious:

Kiwix/Wikipedia:

• Category pages (e.g., "Category:Occupations")
• List articles (e.g., "List of unusual deaths")
• Related articles that branch into unexpected territory

Pattern: Dimensional expansion

• Pick a dimension the seed list lacks
• Research specifically in that dimension
• Add 10-20 items that fill the gap

Step 4: Filter for Quality

Remove items that are:

• Too vague to be useful
• Too similar to existing items
• Culturally specific without being interesting
• Requiring too much explanation

Step 5: Format for Use

Output as JSON array for use with entropy.ts:

{
  "list_name": [
    "Item one",
    "Item two",
    "Item three"
  ]
}

Available Tools

validate-list.ts

Analyzes a list for quality and variety.

deno run --allow-read scripts/validate-list.ts list.json

# Check specific list in a file
deno run --allow-read scripts/validate-list.ts data.json professions

Reports:

• Total count
• Duplicate check
• Average item length (too short = vague, too long = unwieldy)
• Variety assessment (if dimensions specified)

merge-lists.ts

Combines multiple list sources, deduplicates, and formats.

deno run --allow-read scripts/merge-lists.ts source1.json source2.json --output combined.json

Research Prompts

When you need to research a specific category, use prompts like:

For professions: "Find 20 professions in [industry] that most people don't know exist. Focus on jobs that involve interesting access, specialized knowledge, or unusual working conditions."

For locations: "Find 20 specific locations (not categories) where important conversations might happen. Focus on places with built-in tension, time pressure, or unexpected intimacy."

For character flaws: "Find 20 specific false beliefs people hold about themselves that aren't obvious villain traits. Focus on beliefs that feel protective but are actually limiting."