naming

Big-endian file naming as semantic binding

⭐4stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill implements a big-endian file naming convention designed to treat the filesystem as a structured semantic network. By utilizing the 'TYPE-VARIANT.ext' pattern, it enables logical clustering, superior sorting capabilities, and clear semantic binding for all project assets. This approach simplifies data discovery and ensures that files are organized by their primary category first, making it an essential tool for developers and knowledge architects seeking a scalable way to manage complex file hierarchies.

Use Cases

  • Scenario 1: Organizing game development or narrative assets (e.g., ROOM.yml, character-hero.yml) to ensure all related entities cluster together during file browsing.
  • Scenario 2: Standardizing configuration and schema files in large-scale software projects to improve maintainability and predictable sorting in IDEs and terminal environments.
  • Scenario 3: Managing personal or professional knowledge bases where semantic relationships between documents need to be immediately apparent from the filename.
  • Scenario 4: Streamlining automated scripts and CI/CD pipelines that process files based on category-specific patterns (e.g., 'cat-*.yml').
namenaming
descriptionBig-endian file naming as semantic binding
licenseMIT
tier1
allowed-tools[]
related[room, character, yaml-jazz, k-lines]
tags[moollm, naming, filesystem, semantic, convention]

Naming Skill

"The filesystem is a semantic network."

This skill wraps kernel/NAMING.yml.

Core Pattern

TYPE-VARIANT.ext
Part Meaning Examples
TYPE Category/role cat, staff, ROOM
VARIANT Specific instance terpie, marieke
ext File type .yml, .md

Examples

pub/
├── ROOM.yml            # Type only — the pub itself
├── cat-terpie.yml      # Type-variant
├── cat-stroopwafel.yml
├── staff-marieke.yml
└── menu-strains.yml    # Menu type, strains variant

Sorting Advantage

ls *.yml | sort
# cat-stroopwafel.yml
# cat-terpie.yml
# menu-strains.yml
# ROOM.yml
# staff-marieke.yml

Categories cluster. Finding "all cats" → cat-*.yml

Special Filenames

Name Purpose
ROOM.yml Room definition
CHARACTER.yml Character definition
SKILL.md Skill specification
README.md Human landing page
INDEX.yml Registry

Canonical Forms

See kernel/NAMING.yml for:

  • Full naming rules
  • Big-endian rationale
  • Minsky K-line connection

Dovetails With

Kernel