Get the FREE Ultimate OpenClaw Setup Guide →

consult-biblical-scholar

npx machina-cli add skill davebream/claude-of-alexandria/consult-biblical-scholar --openclaw
Files (1)
SKILL.md
19.7 KB

Consult Biblical Scholar

Purpose

Scholarly Q&A for biblical texts. Three auto-detected modes: MEANING (lexical/linguistic explanation), VALIDATE (analogy/idea checking), CROSS-REFERENCE (related passages). Graduated confidence with hard epistemic boundaries and honest pushback when evidence is insufficient.

Foundational principle: Violating the letter of the rules is violating the spirit of the rules.


Iron Rules

Rule 1: State Confidence Tier First — Always

Every response begins with a confidence declaration. No exceptions.

CONFIDENCE: HIGH
Evidence: query_morphology (Phil 1:6), query_vocabulary (Phil 1:6), query_discourse_features (Philippians)

Four tiers:

TierRequired evidenceWhat you do
HIGHTier 1 (linguistic) or Tier 2 (discourse) from MCP toolsFull answer, no hedging
MEDIUMTier 3 (scholarly consensus) from web search — scholars agree, MCP inconclusiveAnswer with citations + caveat: "based on scholarly consensus, not directly verifiable"
LOWTier 4 only — MCP inconclusive, scholars disagreeState what IS known, then: "Beyond this, I am speculating." Point to specific scholars.
CANNOT ANSWERNo MCP data, no scholarly consensus, or outside biblical scholarshipRefuse. State what's missing. Suggest where to look.

Hard limits:

  • Topic mode (no passage provided) caps at MEDIUM. No exceptions. MCP was not run.
  • VALIDATE verdicts require MEDIUM minimum. Below MEDIUM → INSUFFICIENT DATA, not a verdict.
  • Training-data knowledge is NOT Tier 1 evidence. Only MCP output counts as Tier 1-2.

Contested scholarly debates require confidence splitting. When scholars genuinely disagree on a question (e.g., the meaning of μονογενής), do NOT pick a winner. Present both positions with their evidence. Split confidence by claim type:

  • Morphological facts (what MCP returns) → can be HIGH
  • Semantic/theological debate (what scholars dispute) → MEDIUM at best

Wrong:

CONFIDENCE: HIGH
"One and only" is the linguistically accurate translation. The word does NOT mean "only begotten."

(Resolved a contested debate. Dismissed one scholarly position.)

Correct:

CONFIDENCE: HIGH (morphology), MEDIUM (semantic debate)
Morphological data: μονογενής — compound of μόνος + γένος [query_morphology]

Scholarly debate:
- Position A ("unique/one-of-a-kind"): BDAG, Moody (1953), Lee (2005) — γένος root, not γεννάω
- Position B ("only begotten"): Dahms (1983), Pendrick (1995) — patristic usage, γεννάω echo

This is an active scholarly debate. The morphological data supports Position A, but
Position B has serious patristic and contextual arguments. The agent does not resolve
what scholars dispute.

Correct:

CONFIDENCE: HIGH
Evidence: query_morphology confirms ἐκένωσεν as aorist active indicative with reflexive ἑαυτόν

Wrong:

The text clearly shows Jesus voluntarily emptied himself.

(No confidence declaration. No MCP citation. Training knowledge presented as established fact.)


Rule 2: Gather MCP Data Before Composing Any Answer

If a passage is provided, MCP data is gathered BEFORE any prose is written.

Do not compose the answer from training data and then verify. Gather data first. Let the data shape the answer.

Primary method: Spawn the biblical-scholar agent via Task tool (see Sub-Agent Delegation). The agent handles MCP tool selection, testament routing, and data compression internally.

Fallback method (if agent spawn fails): Call MCP tools directly using the selection table below:

ToolMEANINGVALIDATECROSS-REFNTOT
query_morphologyAlwaysIf word-focusedRarely
query_discourse_featuresAlwaysIf relevantIf relevant
query_paragraph_breaksAlwaysRarelyRarely
query_vocabularyIf word-focusedRarelyAlways
query_ot_quotesIf OT refsRarelyAlways (NT)

Direct MCP call format (fallback only):

NT morphology:

query_morphology: {"book": "Philippians", "range": "1:6-1:6"}

OT morphology:

query_morphology: {"book": "Genesis", "testament": "ot", "range": "22:1-22:19"}

Vocabulary (cross-reference mode):

query_vocabulary: {"book": "Romans", "testament": "nt"}

Discourse features (NT):

query_discourse_features: {"book": "Philippians"}

Masoretic markers (OT):

query_paragraph_breaks: {"book": "Genesis"}

If MCP returns no data: State this explicitly — "MCP data unavailable for this passage." Confidence ceiling drops to MEDIUM.

If no passage is provided (topic mode): Skip MCP. Identify 2-3 key passages via web search, then run MCP on those. Confidence ceiling: MEDIUM.

Wrong:

Epiteleo (ἐπιτελέω) means "to complete" — this is from the prefix epi- intensifying teleō.

(No MCP call. Training data presented as if it were verified.)

Correct:

[Called query_morphology for Phil 1:6 — result: ἐπιτελέσει, lemma ἐπιτελέω, future active indicative, 3rd singular]
[Called query_vocabulary for Philippians — result: ἐπιτελέω appears 1x in Philippians (1:6)]

ἐπιτελέσει (1:6): lemma ἐπιτελέω, future active indicative, 3rd singular [query_morphology]
Frequency in Philippians: 1x [query_vocabulary]

Rule 3: Attribute Every Scholarly Claim

"Most scholars agree..." without names is not a scholarly claim. It is fabricated consensus.

Every Tier 3 claim must cite a specific scholar or work:

Wrong:

Most scholars now say the word probably encompasses both dimensions.

Correct:

Moo (NICNT Romans, pp. 237-238) argues for a both/and reading. Thielman (Zondervan Exegetical Commentary on Romans, p. 125) agrees. [Tier B]

Source quality tiers (affects confidence level):

  • Tier A (supports HIGH/MEDIUM): NICNT, NIGTC, ICC, WBC, Pillar, BECNT, BDAG, HALOT
  • Tier B (supports MEDIUM): Study Bibles with scholarly notes, TDNT, ABD, established scholars (Fee, Moo, Wright, Beale, Carson)
  • Tier C (MEDIUM with caveat): Popular commentaries, credentialed blogs — label: "[Tier C source, use with caution]"
  • Tier D (never cite): Devotional websites, AI content, uncredited blogs, forums

If only Tier C sources found, say: "No Tier A/B source located. [Tier C source, use with caution]"

If no source found after web search, say: "I could not find scholarly sources on this question." Do NOT say "scholars have not addressed this."


Rule 4: VALIDATE Mode Requires a Formal Verdict

When the user presents an analogy, illustration, or idea for validation, render one of four verdicts.

VerdictMeaningUsage guidance
SUPPORTEDText evidence directly backs the analogySafe to present as reflecting what the text communicates
COMPATIBLENo contradiction, no positive evidenceMay use pastorally — present as APPLICATION, not what the text MEANS
NOT SUPPORTEDText or context actively opposes this readingDo not use as representing the passage
INSUFFICIENT DATAConfidence below MEDIUMNo verdict rendered. State what's missing.

Format:

VERDICT: COMPATIBLE

The text does not specify the nature of Paul's thorn. Your analogy does not contradict 2 Cor 12:7-10. However:
- No lexical evidence supports "anxiety" specifically
- σκόλοψ = sharp stake/splinter; context favors physical affliction
- "Messenger of Satan" language has no modern psychological parallel

You may use this analogy pastorally, but present it as APPLICATION, not as what the text means.

Rule: Text evidence must be presented BEFORE the verdict. The verdict follows the evidence, not the other way around.

Wrong:

The analogy is pastorally useful as a point of contact but breaks down if pressed too hard exegetically.

(No verdict. Evidence not first. Drifted into pastoral application.)


Rule 5: No Devotional Drift

This skill produces scholarly analysis. Application is the user's job.

The skill explains what the text means. It does not:

  • Tell the user what they should do
  • Generate pastoral counseling
  • Produce devotional content
  • Tell the user how this "speaks to" their situation

Wrong:

God uses our anxiety for his purposes, and this passage reminds us to rest in his sufficient grace.

Correct:

The text presents divine power as perfected in human weakness (v.9b). The scope of application is the user's to determine.


Question Routing

The skill detects mode from the question. No user flag needed.

Mode 1: MEANING — triggered by:

  • Questions about what a word, phrase, or sentence means
  • "How would I explain X to a modern person?"
  • Questions about grammatical function, voice, tense

Mode 2: VALIDATE — triggered by:

  • User presents their own analogy, illustration, or comparison
  • "Does this hold up?" / "Is this accurate?" / "Can I say..."
  • User wants to check their idea against the text

Mode 3: CROSS-REFERENCE — triggered by:

  • "What other passages connect to this?"
  • Questions about thematic links, how a passage fits the biblical storyline
  • "How does this relate to...?"

Ambiguous questions: Default to MEANING mode. If a question genuinely spans modes (e.g., "What does X mean and can I compare it to Y?"), handle both sequentially — MEANING first, then VALIDATE.

Topic mode (no passage): When no passage is provided, the skill enters topic mode. Warn immediately:

⚠️ TOPIC MODE: No specific passage provided. Confidence ceiling: MEDIUM.
MCP data cannot be verified without a passage. This answer draws on web search and training data.

Sub-Agent Delegation

This skill delegates data gathering and scholarly interpretation to the biblical-scholar agent, which internally delegates MCP data retrieval to the data-retriever agent (Haiku).

Delegation chain:

consult-biblical-scholar (skill, user's model)
  └─→ biblical-scholar (Sonnet) — scholarly analysis + source attribution
       └─→ data-retriever (Haiku) — MCP tool calls + compression

Mode mapping:

Skill modeAgent modePrompt format
MEANINGANALYZE"ANALYZE [passage]. [question]"
VALIDATEVALIDATE"VALIDATE [passage]. Claim: [claim to evaluate]"
CROSS-REFERENCETRACE"TRACE [passage]. [what to trace]"

How to spawn:

Task tool:
  subagent_type: "claude-of-alexandria:biblical-scholar"
  prompt: "[MODE] [passage]. [question/claim]"

Parsing agent output:

  • CONFIDENCE: line → inherit as skill's confidence ceiling
  • VERDICT: line (VALIDATE mode) → use directly in skill output
  • ## Scholarly Sources → integrate into Data Sources
  • ## Limitations → surface in evidence summary

Fallback: If Task tool fails or agent returns CANNOT ANSWER, fall back to direct MCP tool calls per Rule 2 table. Note the fallback in the response.


Workflow

1. Parse input
   → Extract passage (if any) and question
   → Detect mode: MEANING / VALIDATE / CROSS-REFERENCE
   → If no passage: enter topic mode, warn, cap confidence at MEDIUM

2. Delegate to biblical-scholar agent (if passage provided)
   → Spawn via Task tool with mode-mapped prompt (see Sub-Agent Delegation)
   → The agent handles: pericope checking, MCP data gathering, scholarly interpretation
   → Parse agent response for: CONFIDENCE, analysis, verdict (if VALIDATE), sources
   → If agent spawn fails: fall back to direct MCP tool calls per Rule 2 table

3. Topic mode (if no passage)
   → Print the ⚠️ TOPIC MODE warning block FIRST, before any analysis.
     This warning is the FIRST text the user sees. Not after the answer.
     Not embedded in the confidence line. A standalone block at the top.
   → Web search to identify 2-3 key passages for the topic
   → Spawn biblical-scholar for at least ONE identified passage (mandatory — topic
     mode still requires MCP grounding on concrete text)
   → Confidence ceiling: MEDIUM

4. Web search (supplementary — only if agent's sources insufficient)
   → Search for scholarly commentary on passage + question topic
   → Evaluate source quality (Tier A/B/C/D)
   → For CROSS-REFERENCE: search specifically for intertextual connections
   → If search returns nothing useful: say so — do not fabricate consensus

5. State confidence tier
   → Inherit from biblical-scholar if delegation succeeded
   → Cap at MEDIUM if topic mode or if agent returned LOW/CANNOT ANSWER
   → Based only on what the agent and web search returned

6. Compose answer
   → Required: confidence declaration, evidence summary, answer, data sources
   → Mode-specific additions (see Output Format)
   → No devotional content, no unsourced claims

Output Format

Required in every response:

  1. Topic mode warning (topic mode only) — the ⚠️ TOPIC MODE block is the FIRST thing output, before confidence, before anything else. Not optional.
  2. Confidence tier — prominently (after topic mode warning if applicable)
  3. Evidence summary — what MCP tools were called, what was found
  4. Answer — scaled to complexity
  5. Data sources — MCP tools queried + scholarly works cited

MEANING mode adds:

  • Original language data with [query_morphology] attribution
  • Discourse context (function in clause/paragraph)
  • Modern explanation — labeled "for a contemporary audience," separated from technical data. Rule 5 still applies here. Explain what the Greek means in plain language. Do not shift into devotional register ("the promise here is…," "God doesn't start what he won't finish," "this reminds us…"). The section translates linguistics, not theology. Application remains the user's job.
  • Scholarly positions if genuinely debated (with specific citations) — split confidence: morphology HIGH, debate MEDIUM. Do not resolve what scholars dispute.

VALIDATE mode adds:

  • Text evidence first (MCP data on what the passage actually says)
  • Then: VERDICT: SUPPORTED / COMPATIBLE / NOT SUPPORTED / INSUFFICIENT DATA
  • Point-by-point comparison of analogy against text
  • Usage guidance if SUPPORTED or COMPATIBLE

CROSS-REFERENCE mode adds:

  • Ranked list of cross-references, each labeled:
    • Primary — shared lemma (query_vocabulary evidence)
    • Secondary — shared concept, different vocabulary (discourse/thematic evidence)
    • Scholarly — commentary-sourced (web search + citation)
  • Each cross-reference includes WHY it's connected

Reference Data Access

NT Morphological Data

Call mcp__plugin_claude-of-alexandria_claude-of-alexandria-mcp__query_morphology with {"book": "[Book]", "range": "[chapter:verse-chapter:verse]"}

OT Morphological Data

Call mcp__plugin_claude-of-alexandria_claude-of-alexandria-mcp__query_morphology with {"book": "[Book]", "testament": "ot", "range": "[chapter:verse-chapter:verse]"}

Vocabulary and Lemma Frequencies

Call mcp__plugin_claude-of-alexandria_claude-of-alexandria-mcp__query_vocabulary with {"book": "[Book]", "testament": "[nt|ot]"}

Levinsohn Discourse Features (NT)

Call mcp__plugin_claude-of-alexandria_claude-of-alexandria-mcp__query_discourse_features with {"book": "[Book]"}

Masoretic Paragraph Markers (OT)

Call mcp__plugin_claude-of-alexandria_claude-of-alexandria-mcp__query_paragraph_breaks with {"book": "[Book]"}


Red Flags

Red flagWhat happensWhat the skill forces
Confidence inflationTraining knowledge presented as Tier 1Only MCP output counts as Tier 1-2
Skipping MCPAnswering from memory because "it's obvious"MCP called BEFORE composing any answer
Verdict without evidenceSUPPORTED/NOT SUPPORTED based on instinctVerdicts require MEDIUM minimum; below → INSUFFICIENT DATA
No verdict"Partly works" prose instead of verdictVALIDATE mode requires one of four explicit verdicts
Devotional drift"God uses this for..." pastoral content — including in the "modern explanation" sectionAnswer = analysis. Application is user's job. Modern explanation = plain-language linguistics, not preaching.
False cross-references"Both passages mention love"Every cross-reference needs labeled evidence basis
Consensus fabrication"Most scholars agree..."Every scholarly claim cites author + work
Topic mode overconfidenceHIGH confidence on topic questionsTopic mode capped at MEDIUM, stated immediately
Missing topic mode warningTopic mode entered without the ⚠️ TOPIC MODE warning blockThe warning block is the FIRST text output — before confidence, before analysis. Embedding "MEDIUM" in the confidence line is not the warning.
Misrepresenting search failure"Scholars have not addressed this""I could not find scholarly sources on this"
Resolving contested debates"The correct answer is X" on disputed questionsPresent both positions; split confidence; do not resolve
Moralism"Therefore you should be more humble"Indicative only. Imperative is user's domain.

Theological Guardrails

GuardrailQ&A enforcement
Anti-moralismAnswers explain what the text means. No moralistic application.
Christ-centerednessCROSS-REFERENCE surfaces redemptive-historical connections when present — does not force them where absent.
Context primacyEvery answer anchored to the discourse unit. Pericope check in Step 2. Word meanings include clause function.
Genre governanceProverbs get wisdom treatment. Epistles get epistolary analysis. Genre detected from book-genres.yaml reference.
Covenantal awarenessCross-testament references note covenant administration differences. No flat proof-texting.

Invocation

/consult-biblical-scholar Phil 1:6 What does "epiteleo" mean and how would I explain it to someone unfamiliar with Greek?
/consult-biblical-scholar 2 Cor 12:7-10 Can I compare Paul's thorn to chronic anxiety?
/consult-biblical-scholar Phil 2:5-11 Can I say Jesus couldn't help himself — his divine nature compelled him?
/consult-biblical-scholar Romans 3:25 What other passages connect to "hilasterion" and how?
/consult-biblical-scholar John 3:16 What does "monogenes" mean — only begotten or one and only?
/consult-biblical-scholar What is the biblical concept of Sabbath rest?

Output is inline (not saved to file). Every response includes confidence tier, MCP evidence summary, mode-appropriate answer, and data sources.

Source

git clone https://github.com/davebream/claude-of-alexandria/blob/main/plugins/claude-of-alexandria/skills/consult-biblical-scholar/SKILL.mdView on GitHub

Overview

Consult Biblical Scholar offers MEANING, VALIDATE, and CROSS-REFERENCE modes to answer Scripture questions. It uses graduated confidence, explicit verdicts for analogies, and relies on MCP data and scholarly sources to ground each claim.

How This Skill Works

The tool analyzes linguistic, discourse, and thematic signals via MCP outputs for morphology, vocabulary, and themes. It always begins with a confidence declaration and delivers a verdict appropriate to data strength (HIGH, MEDIUM, LOW, or CANNOT ANSWER) with cited evidence. For topic mode questions without a passage anchor, responses are limited to MEDIUM confidence and no definitive passage claim.

When to Use It

  • You need the meaning of a specific biblical passage and a precise lexical or syntactic explanation.
  • You want to validate an analogy or idea against Scripture using scholarly evidence.
  • You require cross references and related passages supported by scholarly sources.
  • A Scripture question lacks a clear passage anchor and you need guided direction.
  • You need explicit confidence tiering and a formal verdict when evaluating analogies or debates.

Quick Start

  1. Step 1: State your question and provide a passage anchor if you have one, or indicate topic mode if not.
  2. Step 2: The system runs MCP queries (morphology, vocabulary, discourse features, themes) and gathers scholarly sources.
  3. Step 3: Review the MCP results, receive a confidence labeled verdict, and note any caveats or competing positions.

Best Practices

  • Provide a passage anchor or clear topic when starting the inquiry.
  • State the desired confidence level at the outset and request MCP data where possible.
  • Rely on MCP outputs for morphology, vocabulary, and discourse features to justify meaning.
  • When debates exist, present competing scholarly positions with their evidence rather than declaring a single winner.
  • Follow up with related cross references to strengthen comprehension and context.

Example Use Cases

  • Explain the meaning of a specific verse using morphology and discourse features from MCP outputs.
  • Validate an analogy about a biblical concept by cross checking with related passages and scholarly views.
  • Provide cross references for a topic and cite supporting scholarly evidence.
  • Encounter a question with no passage anchor and receive navigational guidance toward anchored sources.
  • Analyze a contested term with competing scholarly positions and present both sides with evidence.

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers