Forge Load

forge-load

Lazy loading of skill metadata for non-Claude-Code providers. Provides `load_context` and `load_user_content` functions that session-start hooks source for metadata emission.

How It Works

Claude Code discovers skills natively via SKILL.md frontmatter. Other providers (OpenCode, Cursor) need session-start hooks to emit skill metadata. forge-load provides the loading infrastructure.

**Config mode**: When a module has config.yaml or defaults.yaml, reads system/user content paths and metadata field mapping from config.

**Convention mode**: When no config file exists, reads `module.yaml → metadata:` for field mapping and auto-discovers `skills/*/SKILL.md`. No config required.

Usage

Source from a module's session-start.sh:

FORGE_LOAD="${FORGE_ROOT:-$PROJECT_ROOT}/Modules/forge-load/src"
if [ -f "$FORGE_LOAD/load.sh" ]; then
  source "$FORGE_LOAD/load.sh"
  load_context "$MODULE_ROOT" "$PROJECT_ROOT" --index-only
fi

Functions

Function	Purpose
load_context	Load system + user content with metadata transformation
load_user_content	Load only user content (frontmatter stripped)
transform_front	Transform frontmatter per field mapping
strip_front	Strip frontmatter and H1 heading

Not in forge.yaml

forge-load has no events — it's a passive library discovered by path convention (`$FORGE_ROOT/Modules/forge-load/src/load.sh`). Modules source it when needed.