Generate medical referral letters with patient summary, reason for referral.
A tool for generating professional medical referral letters for healthcare providers.
scripts/main.py.references/ for task-specific guidance.assets/sample_referral.json.See ## Prerequisites above for related details.
Python: 3.10+. Repository baseline for current packaged skills.dataclasses: unspecified. Declared in requirements.txt.docx: unspecified. Declared in requirements.txt.enum: unspecified. Declared in requirements.txt.reportlab: unspecified. Declared in requirements.txt.See ## Usage above for related details.
cd "20260318/scientific-skills/Academic Writing/referral-letter-generator"
python -m py_compile scripts/main.py
python scripts/main.py --help
Example run plan:
CONFIG block or documented parameters if the script uses fixed settings.python scripts/main.py with the validated inputs.See ## Workflow above for related details.
scripts/main.py.references/ contains supporting rules, prompts, or checklists.assets/.Use this command to verify that the packaged script entry point can be parsed before deeper execution.
python -m py_compile scripts/main.py
Use these concrete commands for validation. They are intentionally self-contained and avoid placeholder paths.
python -m py_compile scripts/main.py
python scripts/main.py --help
python scripts/main.py --input "Audit validation sample with explicit symptoms, history, assessment, and next-step plan." --format json
This skill generates structured medical referral letters containing:
python scripts/main.py --input patient_data.json --output referral_letter.pdf
from scripts.main import generate_referral_letter
letter = generate_referral_letter(
patient_data={...},
referring_provider={...},
receiving_provider={...},
reason="...",
output_format="pdf" # or "docx", "html", "txt"
)
| Parameter | Type | Required | Description |
|---|---|---|---|
| patient_name | str | Yes | Patient full name |
| patient_dob | str | Yes | Date of birth (YYYY-MM-DD) |
| patient_id | str | Yes | Medical record number |
| diagnosis | str | Yes | Primary diagnosis/reason for referral |
| history | str | No | Relevant medical history |
| medications | list | No | Current medications |
| urgency | str | No | Routine/Urgent/Emergent |
| referring_doctor | str | Yes | Referring physician name |
| receiving_provider | str | Yes | Target specialist/facility |
{
"patient_name": "John Doe",
"patient_dob": "1975-03-15",
"diagnosis": "Suspected coronary artery disease",
"reason": "Cardiology evaluation for chest pain",
"urgency": "Urgent"
}
See references/ folder for:
| Risk Indicator | Assessment | Level |
|---|---|---|
| Code Execution | Python/R scripts executed locally | Medium |
| Network Access | No external API calls | Low |
| File System Access | Read input files, write output files | Medium |
| Instruction Tampering | Standard prompt guidelines | Low |
| Data Exposure | Output files saved to workspace | Low |
# Python dependencies
pip install -r requirements.txt
Every final response should make these items explicit when they are relevant:
scripts/main.py fails, report the failure point, summarize what still can be completed safely, and provide a manual fallback.This skill accepts requests that match the documented purpose of referral-letter-generator and include enough context to complete the workflow safely.
Do not continue the workflow when the request is out of scope, missing a critical input, or would require unsupported assumptions. Instead respond:
referral-letter-generatoronly handles its documented workflow. Please provide the missing required inputs or switch to a more suitable skill.
Use the following fixed structure for non-trivial requests:
If the request is simple, you may compress the structure, but still keep assumptions and limits explicit when they affect correctness.