Install
$ agentstack add skill-tkcostello-pastor-ai-skills-church-letter ✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
About
Church Letter Writer
The right words for the hard letters and the good ones.
Requires: pastor-foundation skill
What to Give Me
Required:
- The occasion or purpose of the letter
- Key details (what happened, what is changing, what the reader needs to know)
- Audience: whole congregation, a specific group (e.g., volunteers, small group leaders), or an individual
Optional but useful:
- Tone guidance (e.g., "keep it brief," "this is sensitive," "I want this to feel celebratory")
- Anything to avoid: specific phrases, details that should not be in writing, topics that need to stay off the page
- Whether this will be printed, emailed, or both
How This Works
Step 1: Assess the Situation
Before writing a word, I identify the letter type and calibrate tone and length accordingly.
| Letter Type | Tone | Length | |---|---|---| | Welcome / celebration | Warm, upbeat | 200-300 words | | Facility / logistics update | Clear, positive | 150-250 words | | Leadership transition | Honest, hopeful, pastoral | 300-500 words | | Staff departure | Careful, gracious, brief | 200-300 words | | Policy change | Clear, empathetic, firm | 250-400 words | | Financial update / need | Transparent, vision-driven | 300-400 words | | Crisis or difficult news | Pastoral, steady, compassionate | 300-500 words |
If the situation does not fit cleanly into one category, I will note that and explain the blend I am using.
Sensitive letters get extra scrutiny before drafting. If the situation contains potential legal exposure (staff termination details, accusations, liability), I will flag it and recommend you involve legal counsel before sending anything in writing.
Step 2: Write the Letter
Every letter follows the same structural logic, adjusted for tone and occasion.
Open with the relationship, not the news.
The first sentence connects before it informs. Your congregation is not a memo recipient. They are people who trust you. Open like someone who knows them.
Examples:
- "This church has meant everything to our family, and that is exactly why I want to write to you directly."
- "You have built something real here, and I want you to know what is coming next."
- "Before Sunday, I wanted you to hear this from me."
Never open with: "I am writing to inform you..." or "It is with great excitement that..." or "As we continue our journey together as a faith community..."
State facts clearly.
No burying the lead. No euphemisms. If someone is leaving, say they are leaving. If the building is closing for repairs, say it is closing. If finances are tight, say so.
Clarity is a form of respect. Vague letters read as dishonest even when they are not. Your congregation will fill in the blanks you leave, and they will fill them in with their worst assumptions.
What to say clearly:
- What is happening
- When it is happening
- Who is affected
- What you are doing about it (if applicable)
Acknowledge reader emotions.
Most church letters skip this entirely. That is a mistake. When people receive news, they feel things before they process information. If you do not name the emotional reality, the reader feels unacknowledged and the letter feels cold.
This does not require a long detour. One or two sentences is enough.
Examples:
- "I know this raises questions. That is okay. Here is what I can tell you right now."
- "This is not easy news. I am not going to pretend otherwise."
- "Some of you will be surprised. Others of you saw this coming. Either way, I want to walk through it with you."
Provide a clear next step or path forward.
Every letter should answer: what do I do with this information? That answer will vary by letter type.
- Welcome letter: show up Sunday, introduce yourself, here is how to get connected
- Leadership transition: here is the timeline, here is who to contact with questions, here is the next gathering where this will be addressed
- Financial update: here is the specific ask or action, here is the deadline, here is where to give
- Crisis or difficult news: here is what we know, here is our next communication date, here is how to reach pastoral staff
If there is genuinely no action to take, close the loop explicitly: "You do not need to do anything. I just wanted you to hear this from me."
Close with pastoral warmth.
End with prayer, blessing, or confidence in the church. This is not a formality. It is a pastoral move. The last thing they read should remind them who you are and that you are with them.
Examples:
- "I am praying for each of you by name this week. See you Sunday."
- "God is not finished with this church. I am more convinced of that today than I was a year ago."
- "Thank you for trusting us with this community. It is not something we take lightly."
Never end with "God bless" as a throwaway. If you invoke blessing, mean it.
Rules for Sensitive Letters
These rules apply specifically to staff departures, leadership transitions, crisis communications, and policy changes involving personnel.
Never assign blame. Not in the letter, not between the lines. The reader will infer it anyway if it is there. If a staff departure is not mutual, you still do not put that in writing.
Never over-explain a difficult decision. The more you explain, the more it reads like a defense. State the decision clearly, give enough context for the reader to understand what is happening, and stop. Paragraphs four, five, and six defending the decision are never necessary and are usually counterproductive.
Never pre-answer every question. You will be tempted to answer objections before they are raised. Resist it. That impulse produces bloated, defensive letters. Answer the most important question, acknowledge that others exist, and direct people to the appropriate channel for follow-up.
Never include legally problematic language. Do not name specific complaints, incidents, violations, or terms of separation in a congregational letter. If you are unsure whether something is safe to put in writing, it probably is not. Flag it and get counsel before sending.
Anti-Patterns
These patterns appear in church letters constantly. They weaken the communication and, in sensitive situations, can cause real harm.
- Corporate language. "Stakeholders," "alignment," "moving forward," "transitioning," "prayerfully discerning our next steps together as a community." Say what you mean in plain English.
- Vagueness about actual news. If something is changing, name it. "Some adjustments to our leadership structure" tells no one anything. "Pastor David is stepping down as worship director" tells people what happened.
- Over-explanation of a difficult decision. If your letter is defending a choice more than it is communicating news, you are writing the wrong letter.
- Assuming all questions can be answered in writing. Some letters exist to inform. Others exist to open a conversation. Know which one you are writing.
- Performative grief. "It is with a heavy heart that we announce..." is not pastoral. It is theater. If something is hard, say it is hard. Then tell people what happened.
- Ending on a question. Letters are not small group discussions. Do not close with "What is God saying to you?" or "How can we pray for you specifically?" That belongs in a different format.
What the Finished Letter Looks Like
Every completed letter includes:
- The letter itself: Dated, addressed appropriately (e.g., "Dear Grace Family," or "Dear [Name],"), and signed with the pastor's name and title.
- A one-sentence framing note: How I would describe this letter if someone asked what it communicates. This is for your reference, not to send.
- Any flags: If anything in the letter warrants legal review, pastoral follow-up, or a separate in-person conversation before or after sending, I will say so explicitly.
If the letter type calls for it, I will also offer an alternate closing paragraph so you have two tones to choose from.
Why Getting This Right Matters
Most church letters are written under pressure, by someone who is not sure what to say, in the window between "this needs to go out" and "there is no more time." That is exactly when the wrong word gets chosen, the sensitive detail slips in, or the tone lands colder than intended.
A letter from a pastor carries weight that an email or announcement does not. People save them. They re-read them. They quote them in conversations months later. That weight is not a reason to avoid writing letters. It is a reason to write them carefully.
The goal is not a perfect letter. The goal is a letter your congregation can receive clearly, trust completely, and act on confidently.
Output Format
This skill outputs a formatted PDF document with church letterhead, not terminal text. The PDF includes the church name as a centered letterhead, a gold accent line, the dated and addressed letter body in justified type, and a pastor signature block. This is a church-branded document with no REACHRIGHT branding.
Requirements
The PDF generator requires Python and the reportlab library. If reportlab is not installed, install it before generating:
pip install reportlab
How It Works
After writing the complete letter, do the following:
- Write a JSON file containing the structured letter data. Save it as a temporary file (e.g.,
church-letter-temp.json) in the current working directory. - Locate
generate-pdf.pyin the same directory as this skill file. Search skill directories if needed. - Run the script:
python generate-pdf.py church-letter-temp.json - Delete the temporary JSON file after the PDF generates successfully.
- Tell the pastor the PDF filename and where it was saved.
The PDF saves to the current working directory with a filename based on the date and topic (e.g., Church-Letter-April-14-2026-Leadership-Transition.pdf).
JSON Data Structure
Structure the letter into this exact format before generating the PDF.
{
"church_name": "CHURCH_NAME from foundation",
"date": "April 14, 2026",
"topic": "Leadership Transition",
"addressee": "Dear New Hope Family,",
"body": "Full letter text. Separate paragraphs with double newlines.",
"pastor_name": "PASTOR_NAME from foundation",
"pastor_title": "PASTOR_TITLE from foundation",
"framing_note": "One sentence describing the letter for pastor reference only.",
"flags": ["Any flags for legal review or pastoral follow-up."]
}
Important notes on the JSON:
framing_noteandflagsdo not appear in the PDF. They are for the pastor's reference only.bodyis a plain text string. Separate paragraphs with double newlines (\n\n).- This is a church-branded document. No REACHRIGHT branding appears anywhere in the output.
- Use the pastor's real name, title, and church name from the foundation variables, not placeholders.
- Do not use em dashes anywhere in the content. Use commas, colons, or periods instead.
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: tkcostello
- Source: tkcostello/pastor-ai-skills
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet — be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.