# bible-bsb

Adopt this skill: https://proskills.md/skills/other/soniccyclops-bot-collab-bible-bsb-skill

Page: https://proskills.md/skills/other/soniccyclops-bot-collab-bible-bsb-skill
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 2267
upstream: https://github.com/soniccyclops-bot-collab/bible-bsb-skill/blob/HEAD/SKILL.md

````text
---
name: bible-bsb
description: "Look up Bible verses and chapters via the helloao.org API. Default translation: Berean Study Bible (BSB). Supports 1000+ translations, 6 commentaries, and 344k cross-references. Use when the user asks for a Bible verse, passage, chapter, or Scripture reference."
metadata:
  openclaw:
    emoji: "📖"
    requires:
      anyBins: ["bb"]
---

# Bible BSB — helloao.org API

Look up verses, commentaries, and cross-references. Requires [Babashka](https://babashka.org/) (`bb`).

## Usage

Run from the skill directory. Replace `{skill_dir}` with the resolved skill path.

```bash
# Single verse
bb {skill_dir}/scripts/bible_lookup.clj "John 3:16"

# Verse range
bb {skill_dir}/scripts/bible_lookup.clj "Romans 8:28-30"

# Full chapter
bb {skill_dir}/scripts/bible_lookup.clj "Psalm 23"

# Different translation
bb {skill_dir}/scripts/bible_lookup.clj "John 3:16" --translation KJV

# Study mode (include footnotes)
bb {skill_dir}/scripts/bible_lookup.clj "John 3:16" --study

# Compare translations (BSB + KJV + WEB side by side)
bb {skill_dir}/scripts/bible_lookup.clj "John 3:16" --compare

# Commentary (dynamically resolved from API)
bb {skill_dir}/scripts/bible_lookup.clj "Psalm 32:1" --commentary gill
bb {skill_dir}/scripts/bible_lookup.clj "Psalm 32:1" --commentary henry
bb {skill_dir}/scripts/bible_lookup.clj "Psalm 32:1" --commentary tyndale

# Cross-references
bb {skill_dir}/scripts/bible_lookup.clj "Psalm 32:5" --cross-refs

# Cross-references with verse text
bb {skill_dir}/scripts/bible_lookup.clj "Psalm 32:5" --cross-refs --expand

# Combine flags
bb {skill_dir}/scripts/bible_lookup.clj "Romans 8:28" --study --cross-refs --expand
```

## When to use

- User asks for a Bible verse, passage, or chapter
- User asks for commentary or "what does X mean"
- User asks for cross-references or "related verses"
- User asks to compare translations
- User asks about a biblical topic (look up key verses)

## Available commentaries (resolved dynamically)

John Gill, Matthew Henry, Adam Clarke, Jamieson-Fausset-Brown, Keil & Delitzsch (OT), Tyndale Study Notes. Use any partial name match.

## Translation IDs

Default: BSB. Common: KJV (→ eng_kjv), WEB (→ ENGWEBP). Any valid translation ID from the API works.
````

## File: README.md
upstream: https://github.com/soniccyclops-bot-collab/bible-bsb-skill/blob/HEAD/README.md

````text
# bible-bsb — OpenClaw Bible Skill

Bible verse and chapter lookup for OpenClaw agents via the [helloao.org](https://bible.helloao.org/) free Bible API.

## Features

- Look up individual verses, verse ranges, or full chapters
- Default translation: **Berean Study Bible (BSB)**
- Supports 1000+ translations (override by name)
- Footnotes and study notes (optional)
- Multi-translation comparison
- No API key required — free and open

## Installation

```bash
# From ClawHub (once published)
openclaw skills install bible-bsb

# Manual: clone into your skills directory
git clone https://github.com/soniccyclops-bot-collab/bible-bsb-skill.git ~/.openclaw/workspace/skills/bible-bsb
```

## How It Works

This is an **instructions-only skill** — no scripts or dependencies. The agent uses `web_fetch` to call the helloao.org JSON API directly. The SKILL.md teaches the agent how to parse references, construct API URLs, and format output.

## API

All data comes from [bible.helloao.org](https://bible.helloao.org/):

- **Free** — no usage limits, no API keys
- **1000+ translations** in JSON format
- **Hosted on AWS** — low latency globally

> "Freely you have received; freely give." — Matthew 10:8 (BSB)

## Credits

- **API:** [AO Lab](https://helloao.org/) — a non-profit dedicated to making the Bible freely available
- **Translation:** [Berean Study Bible](https://bereanbibles.com/) team
- **Skill:** Built by [SonicCyclops](https://github.com/soniccyclops-bot-collab)

## License

MIT
````
