# tkcostello/pastor-ai-skills architecture

> Architecture diagram of the GitHub repository tkcostello/pastor-ai-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tkcostello/pastor-ai-skills
- Repository: https://github.com/tkcostello/pastor-ai-skills

## Overview

Pastor AI Skills is a set of 14 pastoral workflows for Claude Code and Claude.ai Projects. A pastor can set up a church profile once; the README says the foundation carries its tone, theological sensitivity, and details across the other skills. Users invoke a skill in plain English or by command and receive ministry content, with eight workflows also offering formatted PDFs. The skill definitions are not excerpted, so links from those definitions to PDF generators are shown as unverified; generator imports of the shared PDF library are supported by the source index.

Main entry points: [`skills/pastor-foundation/SKILL.md`](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/pastor-foundation/SKILL.md) (Pastoral Foundation), [`shared/pdf_utils.py`](https://github.com/tkcostello/pastor-ai-skills/blob/main/shared/pdf_utils.py) (Shared PDF Utilities), [`skills/pastor-setup/SKILL.md`](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/pastor-setup/SKILL.md) (Church Setup), [`skills/sermon-research/SKILL.md`](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/sermon-research/SKILL.md) (Sermon Research)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundation["Shared Foundation"]
  node_foundation_skill["Pastoral Foundation<br/>[SKILL.md]"]
  node_setup["Church Setup<br/>[SKILL.md]"]
end

subgraph group_sermon["Sermon Preparation"]
  node_research["Sermon Research<br/>[SKILL.md]"]
  node_brainstorm["Sermon Brainstorm<br/>[SKILL.md]"]
  node_series["Sermon Series<br/>[SKILL.md]"]
end

subgraph group_writing["Church Communications"]
  node_email["Church Email<br/>[SKILL.md]"]
  node_announcement["Announcement Script<br/>[SKILL.md]"]
  node_letter["Church Letter<br/>[SKILL.md]"]
end

subgraph group_repurpose["Repurposing and Social"]
  node_questions["Small Group Questions<br/>[SKILL.md]"]
  node_blog["Sermon to Blog<br/>[SKILL.md]"]
  node_youtube["Sermon to YouTube<br/>[SKILL.md]"]
  node_social["Church Social Posts<br/>[SKILL.md]"]
  node_calendar["Social Calendar<br/>[SKILL.md]"]
end

subgraph group_rhythm["Pastoral Rhythm"]
  node_devotional["Midweek Devotional<br/>[SKILL.md]"]
  node_agenda["Meeting Agenda<br/>[SKILL.md]"]
end

subgraph group_pdf["PDF Rendering"]
  node_pdf_utils["Shared PDF Utilities<br/>[pdf_utils.py]"]
  node_research_pdf["Research PDF Renderer<br/>[generate-pdf.py]"]
  node_brainstorm_pdf["Brief PDF Renderer<br/>[generate-pdf.py]"]
  node_series_pdf["Series PDF Renderer<br/>[generate-pdf.py]"]
  node_announcement_pdf["Announcement PDF Renderer<br/>[generate-pdf.py]"]
  node_letter_pdf["Letter PDF Renderer<br/>[generate-pdf.py]"]
  node_questions_pdf["Group Guide Renderer<br/>[generate-pdf.py]"]
  node_devotional_pdf["Devotional PDF Renderer<br/>[generate-pdf.py]"]
  node_agenda_pdf["Agenda PDF Renderer<br/>[generate-pdf.py]"]
end

node_pastor(("Pastor"))
node_claude["Claude Runtime"]

node_pastor -->|"requests a workflow"| node_claude
node_claude -->|"selects setup"| node_setup
node_pastor -->|"provides church details"| node_setup
node_setup -->|"establishes profile"| node_foundation_skill
node_foundation_skill -->|"informs skill"| node_research
node_foundation_skill -->|"informs skill"| node_brainstorm
node_foundation_skill -->|"informs skill"| node_series
node_foundation_skill -->|"informs skill"| node_email
node_foundation_skill -->|"informs skill"| node_announcement
node_foundation_skill -->|"informs skill"| node_letter
node_foundation_skill -->|"informs skill"| node_questions
node_foundation_skill -->|"informs skill"| node_blog
node_foundation_skill -->|"informs skill"| node_youtube
node_foundation_skill -->|"informs skill"| node_social
node_foundation_skill -->|"informs skill"| node_calendar
node_foundation_skill -->|"informs skill"| node_devotional
node_foundation_skill -->|"informs skill"| node_agenda
node_research -.->|"may produce PDF"| node_research_pdf
node_brainstorm -.->|"may produce PDF"| node_brainstorm_pdf
node_series -.->|"may produce PDF"| node_series_pdf
node_announcement -.->|"may produce PDF"| node_announcement_pdf
node_letter -.->|"may produce PDF"| node_letter_pdf
node_questions -.->|"may produce PDF"| node_questions_pdf
node_devotional -.->|"may produce PDF"| node_devotional_pdf
node_agenda -.->|"may produce PDF"| node_agenda_pdf
node_research_pdf -->|"imports utilities"| node_pdf_utils
node_brainstorm_pdf -->|"imports utilities"| node_pdf_utils
node_series_pdf -->|"imports utilities"| node_pdf_utils
node_announcement_pdf -->|"imports utilities"| node_pdf_utils
node_letter_pdf -->|"imports utilities"| node_pdf_utils
node_questions_pdf -->|"imports utilities"| node_pdf_utils
node_devotional_pdf -->|"imports utilities"| node_pdf_utils
node_agenda_pdf -->|"imports utilities"| node_pdf_utils

click node_foundation_skill "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/pastor-foundation/SKILL.md"
click node_setup "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/pastor-setup/SKILL.md"
click node_research "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/sermon-research/SKILL.md"
click node_brainstorm "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/sermon-brainstorm/SKILL.md"
click node_series "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/sermon-series/SKILL.md"
click node_email "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/church-email/SKILL.md"
click node_announcement "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/announcement-script/SKILL.md"
click node_letter "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/church-letter/SKILL.md"
click node_questions "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/small-group-questions/SKILL.md"
click node_blog "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/sermon-to-blog/SKILL.md"
click node_youtube "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/sermon-to-youtube/SKILL.md"
click node_social "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/church-social-post/SKILL.md"
click node_calendar "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/social-media-calendar/SKILL.md"
click node_devotional "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/midweek-devotional/SKILL.md"
click node_agenda "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/meeting-agenda/SKILL.md"
click node_pdf_utils "https://github.com/tkcostello/pastor-ai-skills/blob/main/shared/pdf_utils.py"
click node_research_pdf "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/sermon-research/generate-pdf.py"
click node_brainstorm_pdf "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/sermon-brainstorm/generate-pdf.py"
click node_series_pdf "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/sermon-series/generate-pdf.py"
click node_announcement_pdf "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/announcement-script/generate-pdf.py"
click node_letter_pdf "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/church-letter/generate-pdf.py"
click node_questions_pdf "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/small-group-questions/generate-pdf.py"
click node_devotional_pdf "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/midweek-devotional/generate-pdf.py"
click node_agenda_pdf "https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/meeting-agenda/generate-pdf.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_foundation_skill,node_setup toneBlue
class node_research,node_brainstorm,node_series toneAmber
class node_email,node_announcement,node_letter toneMint
class node_questions,node_blog,node_youtube,node_social,node_calendar toneRose
class node_devotional,node_agenda,node_pastor,node_claude toneIndigo
class node_pdf_utils,node_research_pdf,node_brainstorm_pdf,node_series_pdf,node_announcement_pdf,node_letter_pdf,node_questions_pdf,node_devotional_pdf,node_agenda_pdf toneTeal
```

## Components

### Shared Foundation

- [Pastoral Foundation](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/pastor-foundation/SKILL.md): `skills/pastor-foundation/SKILL.md`
- [Church Setup](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/pastor-setup/SKILL.md): `skills/pastor-setup/SKILL.md`

### Sermon Preparation

- [Sermon Research](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/sermon-research/SKILL.md): `skills/sermon-research/SKILL.md`
- [Sermon Brainstorm](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/sermon-brainstorm/SKILL.md): `skills/sermon-brainstorm/SKILL.md`
- [Sermon Series](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/sermon-series/SKILL.md): `skills/sermon-series/SKILL.md`

### Church Communications

- [Church Email](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/church-email/SKILL.md): `skills/church-email/SKILL.md`
- [Announcement Script](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/announcement-script/SKILL.md): `skills/announcement-script/SKILL.md`
- [Church Letter](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/church-letter/SKILL.md): `skills/church-letter/SKILL.md`

### Repurposing and Social

- [Small Group Questions](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/small-group-questions/SKILL.md): `skills/small-group-questions/SKILL.md`
- [Sermon to Blog](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/sermon-to-blog/SKILL.md): `skills/sermon-to-blog/SKILL.md`
- [Sermon to YouTube](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/sermon-to-youtube/SKILL.md): `skills/sermon-to-youtube/SKILL.md`
- [Church Social Posts](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/church-social-post/SKILL.md): `skills/church-social-post/SKILL.md`
- [Social Calendar](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/social-media-calendar/SKILL.md): `skills/social-media-calendar/SKILL.md`

### Pastoral Rhythm

- [Midweek Devotional](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/midweek-devotional/SKILL.md): `skills/midweek-devotional/SKILL.md`
- [Meeting Agenda](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/meeting-agenda/SKILL.md): `skills/meeting-agenda/SKILL.md`

### PDF Rendering

- [Shared PDF Utilities](https://github.com/tkcostello/pastor-ai-skills/blob/main/shared/pdf_utils.py): `shared/pdf_utils.py`
- [Research PDF Renderer](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/sermon-research/generate-pdf.py): `skills/sermon-research/generate-pdf.py`
- [Brief PDF Renderer](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/sermon-brainstorm/generate-pdf.py): `skills/sermon-brainstorm/generate-pdf.py`
- [Series PDF Renderer](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/sermon-series/generate-pdf.py): `skills/sermon-series/generate-pdf.py`
- [Announcement PDF Renderer](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/announcement-script/generate-pdf.py): `skills/announcement-script/generate-pdf.py`
- [Letter PDF Renderer](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/church-letter/generate-pdf.py): `skills/church-letter/generate-pdf.py`
- [Group Guide Renderer](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/small-group-questions/generate-pdf.py): `skills/small-group-questions/generate-pdf.py`
- [Devotional PDF Renderer](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/midweek-devotional/generate-pdf.py): `skills/midweek-devotional/generate-pdf.py`
- [Agenda PDF Renderer](https://github.com/tkcostello/pastor-ai-skills/blob/main/skills/meeting-agenda/generate-pdf.py): `skills/meeting-agenda/generate-pdf.py`

### Other components

- **Pastor**
- **Claude Runtime**

## Connections

- Pastor → Claude Runtime: requests a workflow (evidence: `README.md`)
- Claude Runtime → Church Setup: selects setup (evidence: `README.md`)
- Pastor → Church Setup: provides church details (evidence: `README.md`)
- Church Setup → Pastoral Foundation: establishes profile (evidence: `README.md`)
- Pastoral Foundation → Sermon Research: informs skill (evidence: `README.md`)
- Pastoral Foundation → Sermon Brainstorm: informs skill (evidence: `README.md`)
- Pastoral Foundation → Sermon Series: informs skill (evidence: `README.md`)
- Pastoral Foundation → Church Email: informs skill (evidence: `README.md`)
- Pastoral Foundation → Announcement Script: informs skill (evidence: `README.md`)
- Pastoral Foundation → Church Letter: informs skill (evidence: `README.md`)
- Pastoral Foundation → Small Group Questions: informs skill (evidence: `README.md`)
- Pastoral Foundation → Sermon to Blog: informs skill (evidence: `README.md`)
- Pastoral Foundation → Sermon to YouTube: informs skill (evidence: `README.md`)
- Pastoral Foundation → Church Social Posts: informs skill (evidence: `README.md`)
- Pastoral Foundation → Social Calendar: informs skill (evidence: `README.md`)
- Pastoral Foundation → Midweek Devotional: informs skill (evidence: `README.md`)
- Pastoral Foundation → Meeting Agenda: informs skill (evidence: `README.md`)
- Sermon Research → Research PDF Renderer: may produce PDF
- Sermon Brainstorm → Brief PDF Renderer: may produce PDF
- Sermon Series → Series PDF Renderer: may produce PDF
- Announcement Script → Announcement PDF Renderer: may produce PDF
- Church Letter → Letter PDF Renderer: may produce PDF
- Small Group Questions → Group Guide Renderer: may produce PDF
- Midweek Devotional → Devotional PDF Renderer: may produce PDF
- Meeting Agenda → Agenda PDF Renderer: may produce PDF
- Research PDF Renderer → Shared PDF Utilities: imports utilities (evidence: `skills/sermon-research/generate-pdf.py`)
- Brief PDF Renderer → Shared PDF Utilities: imports utilities (evidence: `skills/sermon-brainstorm/generate-pdf.py`)
- Series PDF Renderer → Shared PDF Utilities: imports utilities (evidence: `skills/sermon-series/generate-pdf.py`)
- Announcement PDF Renderer → Shared PDF Utilities: imports utilities (evidence: `skills/announcement-script/generate-pdf.py`)
- Letter PDF Renderer → Shared PDF Utilities: imports utilities (evidence: `skills/church-letter/generate-pdf.py`)
- Group Guide Renderer → Shared PDF Utilities: imports utilities (evidence: `skills/small-group-questions/generate-pdf.py`)
- Devotional PDF Renderer → Shared PDF Utilities: imports utilities (evidence: `skills/midweek-devotional/generate-pdf.py`)
- Agenda PDF Renderer → Shared PDF Utilities: imports utilities (evidence: `skills/meeting-agenda/generate-pdf.py`)