Patient Consent Simplifier

Usage

# Simplify from text
python scripts/main.py --text "Lumbar puncture will be performed under sterile conditions..."

# Simplify from file
python scripts/main.py --input consent_form.pdf --output simplified_consent.pdf --target-grade 8

# Check compliance only
python scripts/main.py --input document.pdf --check compliance

Parameters

Target Reading Levels

• General population: 8th grade
• Vulnerable populations: 6th grade
• Health literacy challenges: 4th–5th grade

Required Consent Elements (must be preserved)

Purpose of research · Procedures · Risks and discomforts · Benefits · Alternatives · Confidentiality · Compensation · Contact information · Voluntary participation

Simplification Rules

• Break sentences longer than 20 words
• Replace medical jargon with common terms
• Use active voice and second person ("you")
• Add visual aid placeholders where appropriate
• Never remove required legal elements

Stress-Case Rules

For complex multi-constraint requests, always include these explicit blocks:

1. Assumptions
2. Simplification Applied
3. Readability Report
4. Compliance Status
5. Risks and Limits

Error Handling

• If required inputs are missing, state exactly which fields are missing and request only the minimum additional information.
• If the task goes outside the documented scope, stop instead of guessing or silently widening the assignment.
• If scripts/main.py fails, report the failure point, summarize what still can be completed safely, and provide a manual fallback.
• Do not fabricate compliance status or remove legally required consent elements.

Input Validation

This skill accepts: informed consent documents or text passages for readability simplification, with a target reading level and compliance preservation requirement.

If the request does not involve consent document simplification — for example, asking to draft new legal consent forms from scratch, provide regulatory legal advice, or simplify non-consent documents — do not proceed with the workflow. Instead respond:

"patient-consent-simplifier is designed to simplify existing informed consent documents for patient readability while preserving regulatory compliance. Your request appears to be outside this scope. For drafting new consent forms, consult your institution's IRB template library or a regulatory affairs specialist. Please provide a consent document or text, or use a more appropriate tool."

Response Template

Use the following fixed structure for non-trivial requests:

1. Objective
2. Inputs Received
3. Assumptions
4. Workflow
5. Deliverable
6. Risks and Limits
7. Next Checks

If the request is simple, you may compress the structure, but still keep assumptions and limits explicit when they affect correctness.