plugins/claude-of-alexandria/skills/consult-biblical-scholar/SKILL.md
Use when user asks about a biblical passage's meaning, wants to validate an analogy or idea against the text, or needs cross-references with scholarly evidence. Also use when a question about Scripture lacks a passage anchor. Requires explicit confidence tiering, MCP data before answering, and formal verdict for analogy questions.
npx skillsauth add davebream/claude-of-alexandria consult-biblical-scholarInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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.
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:
| Tier | Required evidence | What you do | |------|------------------|-------------| | HIGH | Tier 1 (linguistic) or Tier 2 (discourse) from MCP tools | Full answer, no hedging | | MEDIUM | Tier 3 (scholarly consensus) from web search — scholars agree, MCP inconclusive | Answer with citations + caveat: "based on scholarly consensus, not directly verifiable" | | LOW | Tier 4 only — MCP inconclusive, scholars disagree | State what IS known, then: "Beyond this, I am speculating." Point to specific scholars. | | CANNOT ANSWER | No MCP data, no scholarly consensus, or outside biblical scholarship | Refuse. State what's missing. Suggest where to look. |
Hard limits:
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:
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.)
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 Agent 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:
| Tool | MEANING | VALIDATE | CROSS-REF | NT | OT |
|------|---------|---------|-----------|----|----|
| query_morphology | Always | If word-focused | Rarely | ✅ | ✅ |
| query_discourse_features | Always | If relevant | If relevant | ✅ | — |
| query_paragraph_breaks | Always | Rarely | Rarely | — | ✅ |
| query_vocabulary | If word-focused | Rarely | Always | ✅ | ✅ |
| query_ot_quotes | If OT refs | Rarely | Always (NT) | ✅ | — |
| query_cross_references | Rarely | Rarely | Always | ✅ | ✅ |
| query_people | If people | If people | Always | ✅ | ✅ |
| query_places | If places | Rarely | If relevant | ✅ | ✅ |
| query_person_network | If relationships | Rarely | Always | ✅ | ✅ |
| query_speakers | If dialogue | If dialogue | If dialogue | ✅ | ✅ |
| query_lexicon | If word-focused | Rarely | Rarely | ✅ | ✅ |
| query_syntax | If structure | Rarely | Rarely | ✅ | — |
| query_variants | If text-critical | If text-critical | Rarely | ✅ | — |
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]
"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):
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."
When the user presents an analogy, illustration, or idea for validation, render one of four verdicts.
| Verdict | Meaning | Usage guidance | |---------|---------|----------------| | SUPPORTED | Text evidence directly backs the analogy | Safe to present as reflecting what the text communicates | | COMPATIBLE | No contradiction, no positive evidence | May use pastorally — present as APPLICATION, not what the text MEANS | | NOT SUPPORTED | Text or context actively opposes this reading | Do not use as representing the passage | | INSUFFICIENT DATA | Confidence below MEDIUM | No 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.)
This skill produces scholarly analysis. Application is the user's job.
The skill explains what the text means. It does not:
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.
The skill detects mode from the question. No user flag needed.
Mode 1: MEANING — triggered by:
Mode 2: VALIDATE — triggered by:
Mode 3: CROSS-REFERENCE — triggered by:
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.
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 mode | Agent mode | Prompt format |
|------------|-----------|---------------|
| MEANING | ANALYZE | "ANALYZE [passage]. [question]" |
| VALIDATE | VALIDATE | "VALIDATE [passage]. Claim: [claim to evaluate]" |
| CROSS-REFERENCE | TRACE | "TRACE [passage]. [what to trace]" |
How to spawn:
Agent tool:
subagent_type: "claude-of-alexandria:biblical-scholar"
prompt: "[MODE] [passage]. [question/claim]"
Parsing agent output:
CONFIDENCE: line → inherit as skill's confidence ceilingVERDICT: line (VALIDATE mode) → use directly in skill output## Scholarly Sources → integrate into Data Sources## Limitations → surface in evidence summaryFallback: If Agent tool fails or agent returns CANNOT ANSWER, fall back to direct MCP tool calls per Rule 2 table. Note the fallback in the response.
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 Agent 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
Required in every response:
⚠️ TOPIC MODE block is the FIRST
thing output, before confidence, before anything else. Not optional.MEANING mode adds:
[query_morphology] attributionVALIDATE mode adds:
VERDICT: SUPPORTED / COMPATIBLE / NOT SUPPORTED / INSUFFICIENT DATACROSS-REFERENCE mode adds:
query_vocabulary evidence) or explicit citation (query_ot_quotes)query_people, query_places, or query_person_network)query_cross_references). Always label as "editorial tradition candidate (N votes)" — NOT as Primary or Secondary evidence. These are tradition-based associations, not linguistically verified connections.Speaker attribution in MEANING/CROSS-REF modes:
query_speakers data provides structured speaker attributionCall mcp__plugin_claude-of-alexandria_claude-of-alexandria-mcp__query_morphology with {"book": "[Book]", "range": "[chapter:verse-chapter:verse]"}
Call mcp__plugin_claude-of-alexandria_claude-of-alexandria-mcp__query_morphology with {"book": "[Book]", "testament": "ot", "range": "[chapter:verse-chapter:verse]"}
Call mcp__plugin_claude-of-alexandria_claude-of-alexandria-mcp__query_vocabulary with {"book": "[Book]", "testament": "[nt|ot]"}
Call mcp__plugin_claude-of-alexandria_claude-of-alexandria-mcp__query_discourse_features with {"book": "[Book]"}
Call mcp__plugin_claude-of-alexandria_claude-of-alexandria-mcp__query_paragraph_breaks with {"book": "[Book]"}
| Red flag | What happens | What the skill forces | |----------|-------------|----------------------| | Confidence inflation | Training knowledge presented as Tier 1 | Only MCP output counts as Tier 1-2 | | Skipping MCP | Answering from memory because "it's obvious" | MCP called BEFORE composing any answer | | Verdict without evidence | SUPPORTED/NOT SUPPORTED based on instinct | Verdicts require MEDIUM minimum; below → INSUFFICIENT DATA | | No verdict | "Partly works" prose instead of verdict | VALIDATE mode requires one of four explicit verdicts | | Devotional drift | "God uses this for..." pastoral content — including in the "modern explanation" section | Answer = 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 overconfidence | HIGH confidence on topic questions | Topic mode capped at MEDIUM, stated immediately | | Missing topic mode warning | Topic mode entered without the ⚠️ TOPIC MODE warning block | The 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 questions | Present both positions; split confidence; do not resolve | | Moralism | "Therefore you should be more humble" | Indicative only. Imperative is user's domain. | | TSK false confidence | Cross-references from CROSS_REFERENCES_SUMMARY cited as Primary evidence | TSK/OpenBible cross-references are editorial tradition candidates, NOT linguistically verified. Always label: "Editorial tradition (N votes) — candidate." Never cite as Primary or Secondary. | | Entity overconfidence | Disputed person identification presented as HIGH | When entity data marks a person as disputed=true, flag it. Split confidence: entity existence HIGH, identification MEDIUM. | | Speaker data as settled exegesis | Angel-of-the-LORD attribution presented as theological fact | Speaker attributions from MACULA/FCBH are dataset interpretations. Flag Angel-of-the-LORD as "dataset attribution, not settled exegesis." |
| Guardrail | Q&A enforcement | |-----------|----------------| | Anti-moralism | Answers explain what the text means. No moralistic application. | | Christ-centeredness | CROSS-REFERENCE surfaces redemptive-historical connections when present — does not force them where absent. | | Context primacy | Every answer anchored to the discourse unit. Pericope check in Step 2. Word meanings include clause function. | | Genre governance | Proverbs get wisdom treatment. Epistles get epistolary analysis. Genre detected from book-genres.yaml reference. | | Covenantal awareness | Cross-testament references note covenant administration differences. No flat proof-texting. |
/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.
testing
Pipeline smoke test. Use when asked to run a smoke test or pipeline verification.
testing
Use when validating whether a biblical passage constitutes a coherent discourse unit. Use when user asks to check passage boundaries, evaluate if a text range is a natural pericope, or needs to know if their selected passage should be extended or contracted.
development
Use when producing structured exegetical analysis of a biblical passage. Use when user asks for exegetical notes, verse analysis, passage study, word study with morphology, or detailed interpretive framework for a text. Always English output.
development
Use when helping users divide biblical books into sessions for sermon series, Bible study, or devotional reading. Use when user asks to segment, divide, or outline any biblical book. Use when user provides a verse range and asks for reading slices, reading portions, or SOAP/devotional divisions within a pericope.