Build Artifacts

Generate SKILL.md and TOC.md for an existing documentation package.

Usage

/build-artifacts prisma@latest # Generate artifacts /build-artifacts prisma@latest --force # Regenerate even if exists

Input

$ARGUMENTS format: {config_name}@{version} (e.g., prisma@latest , nextjs@16.1.3 )

Optional flags:

• --force
• Regenerate even if artifacts already exist

Prerequisites

The contents/ directory and olore-lock.json must already exist at vault/packages/{config_name}/{version}/ . Run /download-docs first if they don't.

test -d vault/packages/{config_name}/{version}/contents && echo "OK" || echo "NOT_FOUND"

If contents/ not found:

error: {config_name}@{version} contents/ not found - run /download-docs first

Execution Steps

Step 1: Parse Arguments and Load Metadata

Parse $ARGUMENTS :

• Extract config_name and version from {config_name}@{version}

• Check for --force flag

Read metadata:

cat vault/packages/{config_name}/{version}/olore-lock.json cat vault/configs/{config_name}.json

Step 2: Check if Already Built

test -f vault/packages/{config_name}/{version}/SKILL.md && test -f vault/packages/{config_name}/{version}/TOC.md && echo "EXISTS" || echo "NOT_FOUND"

If both exist and no --force flag:

skip: {config_name}@{version} artifacts already built (use --force to rebuild)

Return early.

Step 3: Determine Tier

file_count=$(find vault/packages/{config_name}/{version}/contents -type f ( -name ".md" -o -name ".mdx" ) | wc -l) total_size=$(du -sk vault/packages/{config_name}/{version}/contents | cut -f1)

Tier Criteria

1 < 30 files AND < 500KB

2 30-100 files OR 500KB-2MB

3

100 files OR > 2MB

Step 4: Generate TOC.md

Read the appropriate template based on tier:

Tier 1

cat vault/packages/docs-packager/1.0.0/templates/toc-tier1.md

Tier 2

cat vault/packages/docs-packager/1.0.0/templates/toc-tier2.md

Tier 3

cat vault/packages/docs-packager/1.0.0/templates/toc-tier3.md

Create vault/packages/{config_name}/{version}/TOC.md following the template structure.

Step 5: Generate SKILL.md

IMPORTANT: The name field MUST be olore-{config_name}-{version} to match the installed folder name.

Read the appropriate template based on tier:

Tier 1

cat vault/packages/docs-packager/1.0.0/templates/skill-tier1.md

Tier 2

cat vault/packages/docs-packager/1.0.0/templates/skill-tier2.md

Tier 3

cat vault/packages/docs-packager/1.0.0/templates/skill-tier3.md

Create vault/packages/{config_name}/{version}/SKILL.md following the template structure.

Step 6: Return Summary

Return ONLY a brief summary:

done: {config_name}@{version} artifacts built (SKILL.md + TOC.md), tier {tier}

Outputs

• vault/packages/{config_name}/{version}/SKILL.md

• Skill definition

• vault/packages/{config_name}/{version}/TOC.md

• Table of contents