Bible Tools Skill

This skill helps you use the Bible Tools CLI to generate and manage church-related content.

Capabilities

• Generate sermon messages on any topic
• Process Sabbath School lesson outlines (downloads PDFs, generates AI outlines)
• Create Bible study materials
• Revise content with specific instructions
• Export content to Apple Notes
• List existing outputs

CLI Commands

The CLI is available as bible (symlinked to packages/cli/bin/bible).

Important: The --model flag is required for all generation/revision commands.

Messages

# Generate a new message
bible messages generate --model anthropic --topic "Hope in Christ"

# Revise an existing message
bible messages revise --model anthropic --file <path> --instructions "Make it more concise"

# List all messages
bible messages list [--json]

# Generate from Apple Note
bible messages from-note --model anthropic --note-id <id>

Sabbath School

# Process current week's lesson (downloads PDF, generates outline)
bible sabbath-school process --model anthropic --year 2025 --quarter 2 --week 5

# Revise an existing outline
bible sabbath-school revise --model anthropic --year 2025 --quarter 2 --week 5

# Export to Apple Notes
bible sabbath-school export --year 2025 --quarter 2 --week 5

Studies

# Generate a new study
bible studies generate --model anthropic --topic "Faith and Works"

# Revise an existing study
bible studies revise --model anthropic --file <path> --instructions "Add more scripture references"

# List all studies
bible studies list [--json]

Export

# Export files to Apple Notes
bible export --files <path1> --files <path2>

Context Awareness

Current Quarter/Week Calculation

Calculate the current Sabbath School quarter and week:

• Q1: January 1 - March 31 (weeks 1-13)
• Q2: April 1 - June 30 (weeks 1-13)
• Q3: July 1 - September 30 (weeks 1-13)
• Q4: October 1 - December 31 (weeks 1-13)

Each quarter starts on the first Saturday of the quarter's first month.

Output Locations

All outputs are stored in packages/cli/outputs/:

• outputs/messages/ - Generated messages (YYYY-MM-DD-slug.md)
• outputs/sabbath-school/ - Sabbath School outlines (YYYY-QX-WY.md)
• outputs/studies/ - Bible studies (YYYY-MM-DD-slug.md)
• outputs/readings/ - Chapter readings

Workflows

Generate Sabbath School Outline for This Week

1. Calculate current year, quarter, and week from today's date
2. Check if outline exists: ls packages/cli/outputs/sabbath-school/
3. If missing: bible sabbath-school process --model anthropic --year YYYY --quarter Q --week W
4. Read the generated file and summarize for the user

Revise Content (Agent-Orchestrated Loop)

1. User provides feedback on content
2. Run: bible <type> revise --model anthropic --file <path> --instructions "<feedback>"
3. Read the updated file and show to user
4. Ask if further revisions needed
5. Repeat until satisfied

Generate Message with Topic

1. Confirm topic with user
2. Run: bible messages generate --model anthropic --topic "<topic>"
3. Read the output file and summarize
4. Ask if user wants to revise or export

Tips

• Always check existing outputs before generating new ones
• Use --json flag on list commands for easier parsing
• When revising, be specific with instructions
• Quarter boundaries: Q1=Jan, Q2=Apr, Q3=Jul, Q4=Oct