Local Knowledge Base Retriever
ConardLi/rag-skill
Answers questions from a local knowledge base folder by walking hierarchical index files and searching with grep, pdfplumber and pandas instead of loading whole files.
Applies a formal address protocol to manuscript text and TheBrain thoughts, assigning each a stable address, structured index, and verified links.
Install BIRD Knowledge Address Protocol
$ npx skills add twhsi/skills --skill thebrain-bird-address -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install twhsi/skills thebrain-bird-address --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/twhsi/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/thebrain-bird-address .claude/skills/thebrain-bird-address && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "thebrain-bird-address" agent skill from https://github.com/twhsi/skills/tree/main/skills/thebrain-bird-address into .claude/skills/thebrain-bird-address/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "thebrain-bird-address", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/twhsi/skills/tree/main/skills/thebrain-bird-addressType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add twhsi/skills --skill thebrain-bird-address -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install twhsi/skills thebrain-bird-address --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/twhsi/skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/thebrain-bird-address .agents/skills/thebrain-bird-address && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "thebrain-bird-address" agent skill from https://github.com/twhsi/skills/tree/main/skills/thebrain-bird-address into .agents/skills/thebrain-bird-address/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "thebrain-bird-address", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add twhsi/skills --skill thebrain-bird-address -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install twhsi/skills thebrain-bird-address --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/twhsi/skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/thebrain-bird-address .cursor/skills/thebrain-bird-address && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "thebrain-bird-address" agent skill from https://github.com/twhsi/skills/tree/main/skills/thebrain-bird-address into .cursor/skills/thebrain-bird-address/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "thebrain-bird-address", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/twhsi/skills.git --path skills/thebrain-bird-address--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add twhsi/skills --skill thebrain-bird-address -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install twhsi/skills thebrain-bird-address --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/twhsi/skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/thebrain-bird-address .gemini/skills/thebrain-bird-address && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "thebrain-bird-address" agent skill from https://github.com/twhsi/skills/tree/main/skills/thebrain-bird-address into .gemini/skills/thebrain-bird-address/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "thebrain-bird-address", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install twhsi/skills thebrain-bird-addressInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add twhsi/skills --skill thebrain-bird-address -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/twhsi/skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/thebrain-bird-address .github/skills/thebrain-bird-address && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "thebrain-bird-address" agent skill from https://github.com/twhsi/skills/tree/main/skills/thebrain-bird-address into .github/skills/thebrain-bird-address/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "thebrain-bird-address", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add twhsi/skills --skill thebrain-bird-address -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install twhsi/skills thebrain-bird-address --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/twhsi/skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/thebrain-bird-address .opencode/skills/thebrain-bird-address && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "thebrain-bird-address" agent skill from https://github.com/twhsi/skills/tree/main/skills/thebrain-bird-address into .opencode/skills/thebrain-bird-address/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "thebrain-bird-address", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
thebrain-bird-address- GitHub stars
- 259
- Token cost
- ~2.5k tokens
- SKILL.md length
- 1,164 words
- Files
- 14 (incl. scripts, references)
- Skills in repo
- 18
- Repo updated
- First seen
- Licence
- None found
At a glance
Applies a formal address protocol to manuscript text and TheBrain thoughts, assigning each a stable address, structured index, and verified links.
- Works in 8 steps: Identify book, part, chapter, section,… → Preserve existing addresses. Use 待編 only… → Treat 章 and 節 as structural containers.… → …
- Splitting a long manuscript into addressable chapter and section nodes
- SKILL.md covers Three Kings 2.2 Integration, Formal Protocol, Distinguish Two Types and Choose the Mode, plus 10 more sections
- Runs JavaScript scripts from its folder; calls node
What it does
This skill applies a numbered version of a protocol it calls BIRD, splitting a book or manuscript into chapter, section, and item-level knowledge nodes and giving each one a stable address plus a structured index built from weight, type, keyword, and alias fields. It separates a node's structural role, such as part or chapter, from its knowledge type, such as concept or example, and treats mixing the two as an error to fix during migration from older versions.
Depending on what's asked for, it can analyze a single existing TheBrain thought, break unstructured prose into a full node hierarchy, produce a validated spreadsheet of the analysis, turn that spreadsheet into populated TheBrain thoughts, or export the result as Roam Research-importable data. It also fits into a three-skill chain, receiving structured input from one skill and passing ordered routes and links on to another.
When your agent uses it
- Splitting a long manuscript into addressable chapter and section nodes
- Assigning a structured knowledge index to an existing TheBrain thought
- Converting a BIRD analysis into a spreadsheet or Roam JSON export
Example prompts
- “Deconstruct this manuscript chapter into BIRD knowledge nodes.”
- “Assign a book address and knowledge index to this thought.”
- “Export this BIRD analysis as Roam-importable JSON.”
Requirements
- Node.js to run the bundled Roam JSON conversion scripts
Workflow steps
8 steps, taken from the first numbered list in SKILL.md.
- Identify book, part, chapter, section, existing numbering, central question, and argument order.
- Preserve existing addresses. Use 待編 only when no reliable address exists; do not silently renumber.
- Treat 章 and 節 as structural containers. Treat 項 as the normal manuscript unit: one claim, explanation, evidence/example, and transition.
- Split when the claim, reader question, independent case, definition, or reusable reasoning step changes. Do not split mechanically by…
- Target 700-1000 Chinese characters per standard item Note; allow 300-600 for bridges/definitions and up to 1200 for an indivisible case.
- Build one BIRD object per item
- Preserve the author's stance, metaphors, examples, and evidence. Mark missing material 待補; never fabricate support.
- Return a structure tree, BIRD table, JSON objects, and item Note drafts unless the user requests only one format.
What it can do on your machine
Read from SKILL.md and the folder at commit 287d0f4. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 3 files in scripts/ (JavaScript), which the agent can run.
Shell commands in SKILL.md call:
node
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
BIRD Knowledge Address Protocol loads about 2.5k tokens when it runs, and up to ~8.4k if it reads all its reference files. Until then it costs about 147 tokens; SKILL.md has 1,164 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
Without a licence we can't republish the file, so here is its outline and opening line. It has 1,164 words (~2,465 tokens).
“Convert complex structural text into addressable, searchable, cross-linked book nodes for TheBrain, Excel, Roam Research, Obsidian, and AI Agents.”
- name
- thebrain-bird-address
Files
SKILL.md and 13 other files (scripts, references) in skills/thebrain-bird-address of twhsi/skills.
- SKILL.md
- agents/openai.yaml
- references/bird-2.0-spec.md
- references/bird-2.1-spec.md
- references/black-white-double-nine-grid.md
- references/excel-schema.md
- references/manuscript-structuring.md
- references/roam-json-import.md
- references/thebrain-instruction.md
- references/thebrain-manuscript-instruction.md
- references/thebrain-scaffold-import.md
- scripts/bird_to_roam_json.mjs
- scripts/roam-converter.mjs
- scripts/roam-converter.test.mjs
Open the folder on GitHubat commit 287d0f4
Compare with similar skills
BIRD Knowledge Address Protocol next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| BIRD Knowledge Address Protocol this skilltwhsi/skills | 259 | — | ~2.5k | Automated safety check: Pass | None | |
| Local Knowledge Base RetrieverConardLi/rag-skill | 715 | 2 repos | ~1.7k | Automated safety check: Pass | None | |
| Baalda Guidenaveedharri/baalda | 156 | — | ~1.8k | Automated safety check: Pass | Apache-2.0 | |
| Drkg QueryQSong-github/DrugClaw | 116 | 1 repos | ~915 | Automated safety check: Pass | None | |
| Ncats AraxK-Dense-AI/scientific-agent-skills | 48k | 1 repos | ~2.3k | Automated safety check: Notes | MIT | |
| Oregano QueryQSong-github/DrugClaw | 116 | 1 repos | ~664 | Automated safety check: Pass | None |
Similar skills
Baalda Guide
naveedharri/baalda
Answer any question about Baalda (the team second-brain app at baalda.com) in plain, non-technical language — what it is, what it can and cannot do, which file formats it supports (Markdown, images…
Drkg Query
QSong-github/DrugClaw
Query the DRKG (Drug Repurposing Knowledge Graph). An agent skill from QSong-github/DrugClaw.
Ncats Arax
K-Dense-AI/scientific-agent-skills
Queries the NCATS Translator ARAX production API for bounded, typed, provenance-rich one-hop and endpoint-pinned two-hop biomedical knowledge-graph relationships.
Oregano Query
QSong-github/DrugClaw
Query the OREGANO knowledge graph for computational drug repurposing.
Neo4j Document Import Skill
neo4j-contrib/neo4j-skills
Ingests unstructured and semi-structured documents into Neo4j as a knowledge graph.
More from twhsi/skills
All 18 skills in this repoA4 Eight Page Booklet
twhsi/skills
Compiles notes, outlines, PDFs or BIRD and iMandalArt content into an eight-page mini book, with upright page PDFs, a reading PDF, an editable DOCX and an A4 landscape print sheet.
Luhmann Note Numberer
twhsi/skills
Assigns and checks Luhmann-style codes for book manuscript notes and Obsidian card folders without renumbering existing notes.
Fantastical Calendar
twhsi/skills
Turns scheduling requests into Fantastical events or reminders on macOS, previewing the parsed item in the app first and adding it only when you confirm.
iMandalArt Mandala Cards
twhsi/skills
Turns source material into a pure-text 3x3 iMandalArt 2.2 card with a five-character center and eight labeled surrounding angles, laid out with hard line breaks.
Todays Daily Plan
twhsi/skills
Write spoken daily planning notes into an Obsidian Mandala Grid day-plan Markdown file.
EPUB to HyperCard Obsidian
twhsi/skills
Converts an EPUB card book into an Obsidian folder with one Markdown file per card, keyword cards, navigation links and an optional shareable zip.
Related
Works with
Categories
Questions about BIRD Knowledge Address Protocol
What does BIRD Knowledge Address Protocol do?
Applies a formal address protocol to manuscript text and TheBrain thoughts, assigning each a stable address, structured index, and verified links. This skill applies a numbered version of a protocol it calls BIRD, splitting a book or manuscript into chapter, section, and item-level knowledge nodes and giving each one a stable address plus a structured index built from weight, type, keyword, and alias fields. It separates a node's structural role, such as part or chapter, from its knowledge type, such as concept or example, and treats mixing the two as an error to fix during migration from older versions.
When should I use BIRD Knowledge Address Protocol?
BIRD Knowledge Address Protocol fits situations like: splitting a long manuscript into addressable chapter and section nodes; assigning a structured knowledge index to an existing TheBrain thought; converting a BIRD analysis into a spreadsheet or Roam JSON export.
How do I install BIRD Knowledge Address Protocol in Claude Code?
Run `npx skills add twhsi/skills --skill thebrain-bird-address -a claude-code`. Or copy the skill folder (skills/thebrain-bird-address in twhsi/skills) into .claude/skills/thebrain-bird-address in your project. Claude Code loads it when a task matches its description.
How do I install BIRD Knowledge Address Protocol in Codex?
Run `npx skills add twhsi/skills --skill thebrain-bird-address -a codex`. Or copy the skill folder (skills/thebrain-bird-address in twhsi/skills) into .agents/skills/thebrain-bird-address in your project. Codex loads it when a task matches its description.
Can I use BIRD Knowledge Address Protocol in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add twhsi/skills --skill thebrain-bird-address -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/thebrain-bird-address, .gemini/skills/thebrain-bird-address, .github/skills/thebrain-bird-address and .opencode/skills/thebrain-bird-address in your project.
What does BIRD Knowledge Address Protocol need to run?
Going by SKILL.md and its folder, BIRD Knowledge Address Protocol needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node). Our summary lists: Node.js to run the bundled Roam JSON conversion scripts.
Does BIRD Knowledge Address Protocol access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is BIRD Knowledge Address Protocol safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does BIRD Knowledge Address Protocol use?
No licence was found for BIRD Knowledge Address Protocol or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.
How many tokens does BIRD Knowledge Address Protocol use?
About 2.5k tokens (SKILL.md is roughly 9.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.9k tokens, read only when the agent opens those files.
What are the alternatives to BIRD Knowledge Address Protocol?
Skills that share tags, products or a category with BIRD Knowledge Address Protocol: Local Knowledge Base Retriever (ConardLi/rag-skill, 715 stars), Baalda Guide (naveedharri/baalda, 156 stars), Drkg Query (QSong-github/DrugClaw, 116 stars) and Ncats Arax (K-Dense-AI/scientific-agent-skills, 48k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains BIRD Knowledge Address Protocol?
twhsi (a GitHub user) maintains it in twhsi/skills, which has 259 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on July 21, 2026.
Source: twhsi/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.