菜单
Study scripture by retrieving and merging all available commentary data for one or more verses. Supports verse ranges, depth levels (light/medium/full), and optional filtering by tool type.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Fetch and display Bible verses in multiple translations with optional language filtering. Use when users explicitly request to quote a specific verse (e.g., "quote John 3:16" or "quote Matthew 5:3"). The skill retrieves verses from BibleHub and eBible corpus (1000+ translations) using STANDARDIZATION.md format with language filtering support.
Systematically work through TBTA features using the 6-stage STAGES.md workflow. Use when user wants to improve TBTA features, work on TBTA, or continue TBTA feature work.
Use for all .md file creation/editing. README ≤200 lines (self-contained overview), topic files ≤400 lines. Plan ahead - if content will exceed limits, create directory structure from start.
Interactive skill for creating new bible study tools that generate AI-readable commentary data. Guides users through defining practical tasks, setting up proper file structure, and establishing self-learning loops for data generation.
Fetch source language (Greek/Hebrew) word data for Bible verses. Use this when users want to study Greek or Hebrew words, understand original language meanings, or analyze source text morphology. The skill retrieves Macula source language data and merges it with Strong's dictionary entries to provide comprehensive linguistic information. Also supports direct Strong's number lookups and English word searches across all Greek/Hebrew lexicon entries.
| name | scripture-study |
| description | Study scripture by retrieving and merging all available commentary data for one or more verses. Supports verse ranges, depth levels (light/medium/full), and optional filtering by tool type. |
Retrieve and merge all available commentary data for Bible verses to enable comprehensive scripture study. This skill aggregates YAML commentary files from various Bible study tools, providing a unified view of lexical, theological, historical, and practical insights.
This skill requires the mybibletoolbox-data repository for verse commentary data.
Before using this skill, check if data exists for the requested book(s). If not, auto-clone with sparse checkout:
# Function to ensure book data is available
ensure_book_data() {
local BOOK=$1 # e.g., "MAT", "JHN", "ROM"
# Check if data repo exists
if [ ! -d "data" ]; then
echo "Data not found. Cloning mybibletoolbox-data with sparse checkout..."
git clone --filter=blob:none --sparse https://github.com/authenticwalk/mybibletoolbox-data data
cd data
git sparse-checkout init --cone
git sparse-checkout set bible/${BOOK}
cd ..
echo "✓ Data ready for ${BOOK}"
else
# Check if specific book is available
if [ ! -d "data/bible/${BOOK}" ]; then
echo "Adding ${BOOK} to sparse checkout..."
cd data
git sparse-checkout add bible/${BOOK}
cd ..
echo "✓ ${BOOK} added"
fi
fi
}
# Example: For studying Matthew 5:3-10
ensure_book_data "MAT"
Expected location:
data/bible/{BOOK}/ - All verse data for bookSparse checkout strategy:
git sparse-checkout addUse this skill when:
Do NOT use this skill when:
Extract verse reference(s) from the user's request. References must use USFM 3.0 three-letter codes:
Formats supported:
Book codes: USFM 3.0 standard (MAT, JHN, GEN, ROM, PSA, etc.)
Identify the depth level from the user's request or default to "medium":
Depth levels:
light: Core files only (essential commentary, translations, key insights)medium: Core files + verse-level tools (default)full: All available data including chapter-level and book-level contextDetermining depth from user intent:
lightmediumfullUse the Bash tool to execute:
python3 /home/user/context-grounded-bible/src/lib/scripture_study.py "BOOK CHAPTER:VERSE" --depth <level>
Examples:
Single verse with default depth:
python3 /home/user/context-grounded-bible/src/lib/scripture_study.py "JHN 3:16"
Verse range with full depth:
python3 /home/user/context-grounded-bible/src/lib/scripture_study.py "MAT 5:3-10" --depth full
Multiple verses:
python3 /home/user/context-grounded-bible/src/lib/scripture_study.py "JHN 3:16 JHN 3:17"
Filter by tool type:
python3 /home/user/context-grounded-bible/src/lib/scripture_study.py "JHN 3:16" --filter sermon-illustrations
The script returns merged YAML data containing all available commentary organized by verse. Present the information clearly to the user:
For single verse:
For verse ranges:
For comprehensive study:
reference: Verse reference in USFM 3.0 format (BOOK CHAPTER:VERSE)--depth <level>: Depth level (light|medium|full) - default: medium--filter <tool>: Include only specific tool types (can specify multiple)--exclude <tool>: Exclude specific tool types (can specify multiple)--output <file>: Save results to YAML file--json: Output as JSON instead of YAML--list-tools: Show available tools for the verse(s)Use --filter to focus on specific commentary types:
# Only sermon illustrations
--filter sermon-illustrations
# Only source language data
--filter original-language-words
# Multiple filters
--filter sermon-illustrations --filter translations
Use --exclude to omit specific types:
# Exclude translations (often very large)
--exclude translations-ebible
User: "Give me a quick overview of John 3:16"
Action: Execute:
python3 /home/user/context-grounded-bible/src/lib/scripture_study.py "JHN 3:16" --depth light
Expected behavior: Returns core commentary with essential insights, avoiding overwhelming detail
User: "I want to study the Beatitudes in Matthew 5"
Action: Execute:
python3 /home/user/context-grounded-bible/src/lib/scripture_study.py "MAT 5:3-12" --depth medium
Expected behavior: Returns verse-by-verse commentary for each Beatitude with moderate detail
User: "Give me everything you have on Genesis 1:1"
Action: Execute:
python3 /home/user/context-grounded-bible/src/lib/scripture_study.py "GEN 1:1" --depth full
Expected behavior: Returns all available commentary including chapter and book-level context
User: "I'm preaching on Romans 8:28, show me sermon illustrations"
Action: Execute:
python3 /home/user/context-grounded-bible/src/lib/scripture_study.py "ROM 8:28" --filter sermon-illustrations
Expected behavior: Returns only sermon illustration data for targeted preparation
User: "Compare John 3:16, Romans 5:8, and 1 John 4:8"
Action: Execute:
python3 /home/user/context-grounded-bible/src/lib/scripture_study.py "JHN 3:16 ROM 5:8 1JN 4:8"
Expected behavior: Returns commentary for all three verses, enabling comparison
The skill aggregates data from:
./bible/commentary/{BOOK}/{chapter:03d}/{BOOK}.{chapter:03d}.{verse:03d}-{tool}.yaml./bible/commentary/{BOOK}/{chapter:03d}/{BOOK}.{chapter:03d}-{tool}.yaml./bible/commentary/{BOOK}/{BOOK}-{tool}.yamlLight depth includes:
Medium depth includes:
Full depth includes:
The script reads from bible-study-tools/tool-registry.yaml to determine:
Scope Mapping:
core: Always included (light, medium, full queries)standard: Included in medium and full queries onlycomprehensive: Included in full queries onlyUses yaml_merger.py to merge multiple YAML files:
If the script fails:
When creating new Bible study tools with bible-study-tool-creator:
bible-study-tools/tool-registry.yamlcore: Essential data, always included (<50 KB)standard: Standard research depth (50-500 KB) - most toolscomprehensive: Exhaustive reference (>500 KB){BOOK}_{chapter}_{verse:03d}.{tool-suffix}.yamlWhen using tool-experimenter to improve tools: