Okhp3 Tradition Reference

okhp3-tradition-reference

OverKill Hill P³ · overkillhill.com · github.com/OKHP3

Execution contract

• Apply the scope test before adding a tradition, denomination, translation, or API: Abrahamic lineage and the 1% US threshold are both required by ARE.
• Use the focused knowledge/ file for the question at hand. Do not load every primer when one denomination or one API gap is sufficient.
• Separate canonical or historical description from ARE implementation policy, provider availability, and user-facing UI guidance.
• Preserve variation within a tradition. Do not turn one denomination's canon, practice, or interpretation into a universal claim.
• Treat Pew shares and provider coverage as time-sensitive. Cite the source and date, record known gaps in reserve-02-api-gap-register.md, and verify live availability before promising that an endpoint currently works.
• This is a neutral reference layer, not spiritual or doctrinal authority. Do not rank traditions or recommend a translation without stating its license and coverage limits.

Scope criteria

Two criteria must BOTH be met for a tradition to be in scope:

1. Abrahamic lineage -- traceable descent from the Abrahamic scriptural family (Judaism, Christianity, or Islam, and their direct derivatives)
2. 1% or greater US population -- per Pew Research Center Religious Landscape Study

Failing either criterion excludes the tradition regardless of global significance, historical importance, or US cultural presence.

Pew Research Center citation: https://www.pewresearch.org/religion/religious-landscape-study/ (2023)

In-scope traditions (3 total)

Explicitly out of scope

Exclusion is a methodological boundary, not a judgment of worth or spiritual validity.

Judaism

US population share: ~2% (Pew Research Center, 2023) Pew URL: https://www.pewresearch.org/religion/religious-landscape-study/

Canon

Secondary authoritative texts: Talmud Bavli, Talmud Yerushalmi, Midrash Rabbah, Mishneh Torah (Maimonides), Zohar, Shulchan Arukh

Key themes

• Covenant (brit) between God and Israel
• Tikkun olam -- repair of the world
• Shabbat and sacred time
• Torah study as lifelong obligation
• Justice (tzedakah) and ethical monotheism

Interpretive traditions

• PaRDeS: Peshat (plain), Remez (allegorical), Derash (homiletic), Sod (mystical)
• Talmudic dialectic: argument and counter-argument preserved, not resolved
• Maimonidean rationalism vs. Kabbalistic mysticism
• Modern movements: Orthodox, Conservative, Reform, Reconstructionist

Key passages

Available translations

API provider

Sefaria.org -- free, no authentication required

• Endpoint: GET https://www.sefaria.org/api/texts/{ref}?lang=en
• Reference format: {Book} {Chapter}:{Verse} (e.g. Genesis 1:1)
• Documentation: https://developers.sefaria.org/

Christianity

US population share: ~63% total (Pew Research Center, 2023) Pew URL: https://www.pewresearch.org/religion/religious-landscape-study/

Christianity is subdivided by denomination. Five denominations meet the 1%+ US threshold.

Canon overview by denomination

Denomination reference

Evangelical Protestant (~25% US)

• Description: Personal conversion, biblical inerrancy/infallibility, centrality of Christ's atonement, evangelism imperative. Includes Baptist, Pentecostal, non-denominational.
• Distinctives: Born-again experience, sola scriptura, believer's baptism (typically by immersion).
• Key texts: Holy Bible (66 books)
• Representative passages: John 3:16 (john 3:16), Romans 10:9-10 (romans 10:9-10), 2 Timothy 3:16-17 (2 timothy 3:16-17)
• Preferred translations: KJV, ESV (key req.), NIV (key req.), WEB
• API translations (free): kjv, web, asv, bbe, darby

Catholic (~20% US)

• Description: Apostolic succession, Eucharist as central sacrament, Magisterium as teaching authority. Seven sacraments. Largest single denomination worldwide.
• Distinctives: Scripture + Tradition + Magisterium; 73-book canon; veneration of Mary and saints.
• Key texts: Holy Bible (73 books), Catechism of the Catholic Church
• Representative passages: Matthew 16:18-19 (matthew 16:18-19), John 6:51-58 (john 6:51-58), Luke 1:46-55 (luke 1:46-55)
• Preferred translations: NABRE (key req.), Douay-Rheims, WEB (has deuterocanonicals)
• API translations (free): web (includes deuterocanonicals), kjv (excludes deuterocanonicals)

Mainline Protestant (~16% US)

• Description: Historic denominations (Methodist, Presbyterian, Lutheran, Episcopal/Anglican, United Church of Christ). Ecumenical, critical-scholarly, social justice oriented.
• Distinctives: Theological diversity; many ordain women and LGBTQ+ clergy; Wesleyan Quadrilateral (Scripture, Tradition, Reason, Experience).
• Key texts: Holy Bible (66 books), Westminster Confession, Book of Common Prayer
• Representative passages: Micah 6:8 (micah 6:8), Matthew 25:31-46 (matthew 25:31-46), Romans 12:1-2 (romans 12:1-2)
• Preferred translations: NRSV (key req.), WEB, KJV
• API translations (free): kjv, web, asv, bbe

LDS / Restorationist (~2% US)

• Description: Restoration movement founded by Joseph Smith. Modern prophetic revelation, pre-mortal existence, eternal family relationships sealed in temples.
• Distinctives: Standard Works (four-volume canon); continuing prophetic succession; temple ordinances.
• Key texts: Holy Bible (KJV), Book of Mormon, Doctrine and Covenants, Pearl of Great Price
• Representative passages: James 1:5 (james 1:5), John 17:3 (john 17:3), 2 Ne. 2:25 (Book of Mormon), Moses 1:39 (Pearl of Great Price), D&C 76:22 (Doctrine and Covenants)
• API translations (free): kjv (Bible only via bible-api.com)

Canon scope -- Standard Works (4 volumes):

LDS scripture API for non-Bible volumes: scriptures.nephi.org -- community-maintained, no authentication required.

• Base URL: https://scriptures.nephi.org
• Covers all four Standard Works
• Reference examples: 1 Ne. 3:7 (Book of Mormon), D&C 76:22 (D&C), Moses 1:39 (Pearl of Great Price)
• No uptime guarantee -- implement graceful fallback when unavailable
• Official text (no API): https://www.churchofjesuschrist.org/study/scriptures

Orthodox Christian (~1% US)

• Description: Eastern Orthodox traces apostolic continuity through seven Ecumenical Councils. Theosis (participation in divine nature) as the goal of Christian life. Highly liturgical.
• Distinctives: Divine Liturgy (John Chrysostom / Basil); icon veneration; Septuagint (LXX) as authoritative OT; broader canon than Protestant.
• Key texts: Holy Bible (Orthodox canon), Church Fathers, Philokalia
• Representative passages: John 1:1-14 (john 1:1-14), 2 Peter 1:4 (2 peter 1:4), Matthew 3:13-17 (matthew 3:13-17)
• API translations (free): web (closest to Orthodox usage -- includes deuterocanonicals but not full Orthodox OT), kjv

Canon scope -- Septuagint-based (LXX):

Typical total: 76-78 books (varies by jurisdiction -- Greek Orthodox, Russian Orthodox, Serbian Orthodox, etc. differ slightly).

API gap: No free public unauthenticated API covers the full Orthodox OT. bible-api.com web covers the seven Catholic deuterocanonicals but omits 3 Maccabees, Psalm 151, and 4 Maccabees. Surface this limitation explicitly when a user requests those texts.

Available translations (Christianity -- all denominations)

API provider (Christianity)

bible-api.com -- free, no authentication required

• Endpoint: GET https://bible-api.com/{reference}?translation={id}
• Reference format: {book} {chapter}:{verse} (lowercase; e.g. john 3:16)
• Documentation: https://bible-api.com/

Islam

US population share: ~1% (Pew Research Center, 2023) Pew URL: https://www.pewresearch.org/religion/religious-landscape-study/

Canon

Major Hadith collections: Sahih al-Bukhari, Sahih Muslim, Sunan Abu Dawud, Jami' at-Tirmidhi, Sunan an-Nasa'i, Sunan Ibn Majah

Key themes

• Tawhid: the absolute oneness of God
• Prophethood (Nubuwwah): Adam to Muhammad as final messenger
• The Five Pillars: Shahada, Salat, Zakat, Sawm, Hajj
• Akhirah: the afterlife and Day of Judgment
• Submission (Islam) and peace (Salam) as core meanings

Interpretive traditions

• Tafsir: exegetical commentary on the Quran
• Fiqh: Islamic jurisprudence derived from Quran and Hadith
• Four major Sunni law schools: Hanafi, Maliki, Shafi'i, Hanbali
• Shia tradition: authority of the Imams alongside scripture
• Sufi tradition: mystical and devotional interpretation

Key passages

Available translations

Use translationId values as the integer in the Quran.com translations query parameter. In this codebase, prefix with quran- (e.g. quran-20) and strip the prefix before passing to the API.

API provider (Islam)

Primary: Quran.com API v4 -- free, no authentication required

• Endpoint: GET https://api.quran.com/api/v4/verses/by_key/{surah}:{ayah}?language=en&translations={id}&words=false
• Reference format: {surah}:{ayah} (e.g. 2:255)
• Documentation: https://api-docs.quran.com/

Fallback: AlQuran.cloud

• Endpoint: GET https://api.alquran.cloud/v1/ayah/{surah}:{ayah}/{edition}
• Editions: en.asad, en.arberry, en.sahih, en.pickthall

Hadith: fawazahmed0/hadith-api -- free via jsDelivr CDN (CC BY-4.0)

• CDN: https://cdn.jsdelivr.net/gh/fawazahmed0/hadith-api@1/
• Working endpoint (collection-level): https://cdn.jsdelivr.net/gh/fawazahmed0/hadith-api@1/editions/eng-{collection}.min.json -- fetch the full collection JSON and extract the hadith by hadithnumber from the in-memory result
• Broken endpoint (per-hadith): /{number}.json URL pattern -- returns HTTP 404 as of 2026-06-25; do not use
• Collections: bukhari, muslim, abudawud, tirmidhi, nasai, ibnmajah
• No authentication required

Quick lookup table

Knowledge scaffold file inventory

All files live under knowledge/ in this skill directory. Load only the file(s) relevant to the current task -- do not load the full set upfront. The SKILL.md above is sufficient for most queries; reach for these files when you need deep-dive tradition or denomination detail.

About

Built by Jamie Hill · OverKill Hill P³ Published at github.com/OKHP3 Part of the OKHP3/skillz Agent Skill library. MIT License -- free to use, fork, and adapt. A nod to the source is appreciated.