How do I install the Blz Source Management skill?

Run npx skillmds add majiayu000/blz-source-management in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Blz Source Management safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Blz Source Management?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Blz Source Management free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Blz Source Management?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Blz Source Management by majiayu000

Name: Blz Source Management
Rating: 4.666666666666667 (3 reviews)
Author: majiayu000

Blz Source Management

Teaches how to discover, validate, and add llms.txt documentation sources to the blz CLI. Use when adding documentation to blz, finding llms.txt or llms-full.txt files, validating sources, refreshing content, or managing the documentation index. Covers source discovery, dry-run validation, and index file handling.

majiayu000 efb1a95 2 files · 3.7 KB Updated Sep 9, 2026 567 repo stars

File contents

BLZ Source Management

Add and manage llms.txt documentation sources for local search.

Source Types

Type	Description	Action
`llms-full.txt`	Complete documentation (preferred)	Add directly
`llms.txt` (full)	Complete docs under standard name	Add directly
`llms.txt` (index)	Links to other docs (< 100 lines)	Expand linked files

Adding Sources

Standard Workflow

# 1. Dry-run to validate
blz add react https://react.dev/llms.txt --dry-run --quiet

# 2. Check output
# Good: contentType: "full", lineCount > 1000
# Index: contentType: "index", lineCount < 100 → find linked docs

# 3. Add if good
blz add react https://react.dev/llms.txt -y

# 4. Verify
blz list --json | jq '.[] | select(.alias=="react")'

Discovering URLs

Web search patterns:

"llms-full.txt" site:docs.example.com
"llms.txt" OR "llms-full.txt" <library-name>
site:github.com/org/repo "llms.txt"

Common URL patterns:

https://docs.example.com/llms-full.txt
https://example.com/llms.txt
https://example.com/llms-full.txt

Index File Handling

If dry-run shows contentType: "index" with < 100 lines:

# Inspect the index
curl -s <index-url> | head -50

# Look for .txt references like:
# ./guides.txt
# ./js.txt
# ./python.txt

# Resolve and add each linked file
blz add supabase-guides https://supabase.com/llms/guides.txt -y
blz add supabase-js https://supabase.com/llms/js.txt -y

Quality Criteria

Criteria	Good	Index	Skip
contentType	"full"	"index"	"unknown"
lineCount	> 1000	< 100	< 50
Action	Add	Expand	Investigate

Alias Best Practices

Good aliases:

bun, react, deno (short, clear)
supabase-guides (variant-specific)
langchain-python (language-specific)

Bad aliases:

b (too short)
my-docs (vague)
the-react-docs-2024 (too long)

Management Commands

# List sources
blz list --json
blz list --status --json    # With freshness

# Refresh sources
blz refresh --all --json    # Update all
blz refresh bun --json      # Update specific

# Remove source
blz remove bun

# Source details
blz info bun --json

Troubleshooting

Issue	Solution
404 Not Found	Try `/llms.txt` vs `/llms-full.txt`, check GitHub repo
Small line count	Likely index file - expand linked docs
contentType unknown	Inspect content manually, verify it's markdown/text
Already exists	Use `blz refresh <alias>` to update

---name: blz-source-managementdescription: Teaches how to discover, validate, and add llms.txt documentation sources to the blz CLI. Use when adding documentation to blz, finding llms.txt or llms-full.txt files, validating sources, refreshing content, or managing the documentation index. Covers source discovery, dry-run validation, and index file handling.--- # BLZ Source Management Add and manage llms.txt documentation sources for local search. ## Source Types | Type | Description | Action | |------|-------------|--------| | `llms-full.txt` | Complete documentation (preferred) | Add directly | | `llms.txt` (full) | Complete docs under standard name | Add directly | | `llms.txt` (index) | Links to other docs (< 100 lines) | Expand linked files | ## Adding Sources ### Standard Workflow ```bash # 1. Dry-run to validate blz add react https://react.dev/llms.txt --dry-run --quiet # 2. Check output # Good: contentType: "full", lineCount > 1000 # Index: contentType: "index", lineCount < 100 → find linked docs # 3. Add if good blz add react https://react.dev/llms.txt -y # 4. Verify blz list --json | jq '.[] | select(.alias=="react")' ``` ### Discovering URLs Web search patterns: ``` "llms-full.txt" site:docs.example.com "llms.txt" OR "llms-full.txt" <library-name> site:github.com/org/repo "llms.txt" ``` Common URL patterns: ``` https://docs.example.com/llms-full.txt https://example.com/llms.txt https://example.com/llms-full.txt ``` ## Index File Handling If dry-run shows `contentType: "index"` with < 100 lines: ```bash # Inspect the index curl -s <index-url> | head -50 # Look for .txt references like: # ./guides.txt # ./js.txt # ./python.txt # Resolve and add each linked file blz add supabase-guides https://supabase.com/llms/guides.txt -y blz add supabase-js https://supabase.com/llms/js.txt -y ``` ## Quality Criteria | Criteria | Good | Index | Skip | |----------|------|-------|------| | contentType | "full" | "index" | "unknown" | | lineCount | > 1000 | < 100 | < 50 | | Action | Add | Expand | Investigate | ## Alias Best Practices Good aliases: - `bun`, `react`, `deno` (short, clear) - `supabase-guides` (variant-specific) - `langchain-python` (language-specific) Bad aliases: - `b` (too short) - `my-docs` (vague) - `the-react-docs-2024` (too long) ## Management Commands ```bash # List sources blz list --json blz list --status --json # With freshness # Refresh sources blz refresh --all --json # Update all blz refresh bun --json # Update specific # Remove source blz remove bun # Source details blz info bun --json ``` ## Troubleshooting | Issue | Solution | |-------|----------| | 404 Not Found | Try `/llms.txt` vs `/llms-full.txt`, check GitHub repo | | Small line count | Likely index file - expand linked docs | | contentType unknown | Inspect content manually, verify it's markdown/text | | Already exists | Use `blz refresh <alias>` to update |

Frequently asked questions