olore: Skill for Claude Code

Download Docs

Download documentation files from a source config and filter non-useful files.

Usage

/download-docs prisma@latest         # Download specific version
/download-docs prisma@latest --force  # Re-download even if exists

Input

$ARGUMENTS format: {config_name}@{version} (e.g., prisma@latest, [email protected])

Optional flags:

• --force - Re-download even if already built

Execution Steps

Step 1: Parse Arguments and Load Config

Parse $ARGUMENTS:

• Extract config_name and version from {config_name}@{version}
• Check for --force flag

Load config file:

cat vault/configs/{config_name}.json

Extract:

• name - Package name
• _source.type - Source type (github or url)
• _source.repo - GitHub repo (if github type)
• versions.{version}.ref - Git ref for the version

Step 2: Check if Already Built

test -f vault/packages/{config_name}/{version}/olore-lock.json && echo "EXISTS" || echo "NOT_FOUND"

If exists and no --force flag:

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

Return early.

Step 3: Download Documentation

For GitHub sources:

bash -c 'source .claude/skills/build-docs/scripts/github.sh && download_from_github "vault/configs/{config_name}.json" "vault/packages" "{version}"'

For URL sources:

bash -c 'source .claude/skills/build-docs/scripts/url.sh && download_from_urls "vault/configs/{config_name}.json" "vault/packages" "{version}"'

Verify download succeeded:

test -f vault/packages/{config_name}/{version}/olore-lock.json && echo "OK" || echo "FAILED"

If download failed, return error:

error: {config_name}@{version} download failed

Step 4: Count Files and 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)