Agent skill

Patient Consent Simplifier

by aipoch in aipoch/medical-research-skills

Simplifies informed consent documents into patient-friendly language while maintaining regulatory compliance.

MITAuto-check passedLegal & Compliance

Install Patient Consent Simplifier

skills CLI
$ npx skills add aipoch/medical-research-skills --skill patient-consent-simplifier -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aipoch/medical-research-skills patient-consent-simplifier --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aipoch/medical-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/scientific-skills/Other/patient-consent-simplifier .claude/skills/patient-consent-simplifier && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
patient-consent-simplifier
GitHub stars
1.9k
Token cost
~1.8k tokens
SKILL.md length
667 words
Files
4 (incl. scripts)
Skills in repo
578
Repo updated
First seen
Licence
MIT

At a glance

Simplifies informed consent documents into patient-friendly language while maintaining regulatory compliance.

  • Works in 4 steps: Document Simplification → Risk/Benefit Clarification → Reading Level Assessment → …
  • Tasks that involve Healthcare and finance regulation
  • SKILL.md covers Quick Check, Audit-Ready Commands, When to Use and Workflow, plus 8 more sections
  • Runs Python scripts from its folder; calls python

What it does

Patient Consent Simplifier is an agent skill from aipoch/medical-research-skills. Simplifies informed consent documents into patient-friendly language while maintaining regulatory compliance. Readability assessment targeting 6th-8th grade level, risk/benefit clarification in table format, and FDA 21CFR50/ICH-GCP/HIPAA compliance validation.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `POLISH_CHANGELOG.md`, `eval_report_patient-consent-simplifier_result.json` and `scripts/main.py`).

It sits in Legal & Compliance, covering Healthcare and finance regulation, Regulatory compliance and Plain language and style rules. It works with Google Cloud. The repository describes itself as: Hundreds of agent skills for medical research, including protocol design, data analysis, evidence insights, and academic writing. The licence is MIT.

When your agent uses it

  • Tasks that involve Healthcare and finance regulation
  • Tasks that involve Regulatory compliance
  • Tasks that involve Plain language and style rules

Example prompts

  • “Use the patient-consent-simplifier skill to simplify informed consent documents into patient-friendly language while maintaining regulatory compliance”
  • “/patient-consent-simplifier”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Document Simplification
  2. Risk/Benefit Clarification
  3. Reading Level Assessment
  4. Regulatory Compliance Check

What it can do on your machine

Read from SKILL.md and the folder at commit 686e09d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Patient Consent Simplifier loads about 1.8k tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 667 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~72
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from aipoch/medical-research-skills at commit 686e09d, republished under its MIT licence (© aipoch). 667 words, ~1,784 tokens.

Download SKILL.mdSave it as .claude/skills/patient-consent-simplifier/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
patient-consent-simplifier
description
Simplifies informed consent documents into patient-friendly language while maintaining regulatory compliance. Readability assessment targeting 6th-8th grade level, risk/benefit clarification in table format, and FDA 21CFR50/ICH-GCP/HIPAA compliance validation.
license
MIT
author
AIPOCH

Source: https://github.com/aipoch/medical-research-skills

Transform complex informed consent documents into patient-friendly language while maintaining regulatory compliance and ethical standards.

Quick Check

Use this command to verify that the packaged script entry point can be parsed before deeper execution.

bash
python -m py_compile scripts/main.py

Audit-Ready Commands

Use these concrete commands for validation. They are intentionally self-contained and avoid placeholder paths.

bash
python -m py_compile scripts/main.py
python scripts/main.py --help
python scripts/main.py --text "Audit validation sample with explicit methods, findings, and conclusion."

When to Use

  • Use this skill when simplifying informed consent documents or translating medical procedures for patients.
  • Use this skill when creating patient-friendly research summaries or adapting clinical trial information for lay audiences.
  • Use this skill when the user says "simplify consent", "plain language consent", or "patient-friendly consent form".

Workflow

  1. Receive document and target: Collect the consent document text and confirm target reading level (default: 8th grade for general population; 6th grade for vulnerable populations; 4th-5th grade for health literacy challenges).
  2. Extract legal elements: Catalog all required regulatory elements: purpose, procedures, risks, benefits, alternatives, confidentiality, compensation, contacts, voluntary participation statement.
  3. Checkpoint: Verify with user that all required legal elements are captured before simplification begins. If elements are missing, list them explicitly.
  4. Simplify each section: Break sentences >20 words; replace jargon with common terms (use active voice, "you/your"); add visual aid placeholders.
  5. Clarify risks and benefits: Present risk/benefit information in table format with likelihood and severity. Use emoji or color scales for accessibility.
  6. Checkpoint: User confirms that risk/benefit balance is accurately preserved after simplification. If risk is downplayed, revise.
  7. Assess readability: Run readability assessment. If target grade not met, iterate on complex sections.
  8. Check compliance: Validate against FDA 21CFR50, ICH-GCP, HIPAA. Flag any missing elements.
  9. Output: Deliver simplified document with readability metrics (grade level, suggestions) and compliance status.
  10. Fallback: If source document is too fragmentary to simplify, return a structured checklist of missing elements and a partial simplification of available sections.

Quick Start

python
from scripts.consent_simplifier import ConsentSimplifier

simplifier = ConsentSimplifier()

# Simplify consent form
simplified = simplifier.simplify(
    document="clinical_trial_consent.pdf",
    reading_level="8th_grade",
    preserve_legal=True
)

Core Capabilities

1. Document Simplification
python
result = simplifier.simplify_section(
    section="procedure_description",
    text="Lumbar puncture will be performed under sterile conditions...",
    max_sentences=3
)

Simplification Rules:

  • Break long sentences (>20 words)
  • Replace medical jargon with common terms
  • Use active voice
  • Add visual aids placeholders
  • Maintain key legal elements
2. Risk/Benefit Clarification
python
risks = simplifier.clarify_risks(
    original_text="Potential adverse events include...",
    format="table",
    severity_scale="emoji"  # or "color", "text"
)

Risk Presentation:

RiskLikelihoodSeverity
HeadacheCommon (1 in 10)Mild 😊
InfectionRare (1 in 1000)Serious ⚠️
3. Reading Level Assessment
python
metrics = simplifier.assess_readability(document)
print(f"Current grade level: {metrics.grade_level}")
print(f"Suggested improvements: {metrics.suggestions}")

Target Levels:

  • General population: 8th grade
  • Vulnerable populations: 6th grade
  • Health literacy challenges: 4th-5th grade
4. Regulatory Compliance Check
python
compliance = simplifier.check_compliance(
    simplified_document,
    regulations=["FDA_21CFR50", "ICH-GCP", "HIPAA"]
)

Required Elements:

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

CLI Usage

text
# Simplify PDF
python scripts/consent_simplifier.py \
  --input consent_form.pdf \
  --output simplified_consent.pdf \
  --grade-level 8

# Check compliance only
python scripts/consent_simplifier.py \
  --check compliance \
  --input document.pdf
Show full SKILL.md (268 more words)Show less

Best Practices

Do:

  • Use "you" and "your"
  • Define terms on first use
  • Use bullet points for lists
  • Include visual aids
  • Test with patient advocates

Don't:

  • Remove required legal elements
  • Downplay significant risks
  • Use coercive language
  • Exceed recommended length

Skill ID: 208 | Version: 1.0 | License: MIT

Output Requirements

Every final response should make these items explicit when they are relevant:

  • Objective or requested deliverable
  • Inputs used and assumptions introduced
  • Workflow or decision path
  • Core result, recommendation, or artifact
  • Constraints, risks, caveats, or validation needs
  • Unresolved items and next-step checks

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 files, citations, data, search results, or execution outcomes.

Input Validation

This skill accepts requests that match the documented purpose of patient-consent-simplifier 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:

patient-consent-simplifier only handles its documented workflow. Please provide the missing required inputs or switch to a more suitable skill.

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.

© aipoch, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts) in scientific-skills/Other/patient-consent-simplifier of aipoch/medical-research-skills.

  • SKILL.md
  • POLISH_CHANGELOG.md
  • eval_report_patient-consent-simplifier_result.json
  • scripts/main.py

Open the folder on GitHubat commit 686e09d

Compare with similar skills

Patient Consent Simplifier next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Patient Consent Simplifier compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Patient Consent Simplifier this skillaipoch/medical-research-skills1.9k—~1.8kAutomated safety check: PassMIT
Clinical Reportsdavila7/claude-code-templates33k11 repos~9.9kAutomated safety check: NotesMIT
HIPAA Pre-Deployment Compliance Checkmaziyarpanahi/openmed5.5k—~2kAutomated safety check: PassApache-2.0
Hipaa ComplianceSushegaad/Claude-Skills-Governance-Risk-and-Compliance9461 repos~2.3kAutomated safety check: PassMIT
ISO Standards Readiness EvidenceK-Dense-AI/scientific-agent-skills48k1 repos~4.6kAutomated safety check: NotesMIT
Shifting Clinical Datesmaziyarpanahi/openmed5.5k—~1.7kAutomated safety check: PassApache-2.0

Similar skills

  • Clinical Reports

    davila7/claude-code-templates

    Write comprehensive clinical reports including case reports (CARE guidelines), diagnostic reports (radiology/pathology/lab), clinical trial reports (ICH-E3, SAE, CSR), and patient documentation…

    33k GitHub starsUsed in 11 repos~9.9k tokens
    Legal & ComplianceAuto-check: notes
  • Walks a data pipeline against the HIPAA Privacy and Security Rule checklist and produces a gap report before it processes patient data.

    5.5k GitHub stars~2k tokensUpdated today
    Legal & ComplianceAuto-check passed
  • Hipaa Compliance

    Sushegaad/Claude-Skills-Governance-Risk-and-Compliance

    Expert HIPAA compliance assistant for healthcare and software contexts.

    946 GitHub starsUsed in 1 repo~2.3k tokens
    Legal & ComplianceAuto-check passed
  • ISO Standards Readiness Evidence

    K-Dense-AI/scientific-agent-skills

    Organizes scope, controlled documents, risk files and traceability into draft evidence for human review against ISO 13485, 14971, 17025 and 15189.

    48k GitHub starsUsed in 1 repo~4.6k tokens
    Legal & ComplianceAuto-check: notes
  • Shifting Clinical Dates

    maziyarpanahi/openmed

    Apply consistent per-patient date shifting in OpenMed that preserves intervals between events while satisfying HIPAA Safe Harbor's date rule.

    5.5k GitHub stars~1.7k tokensUpdated today
    Legal & ComplianceAuto-check passed
  • Policy Opa

    AgentSecOps/SecOpsAgentKit

    Policy-as-code enforcement and compliance validation using Open Policy Agent (OPA).

    220 GitHub starsUsed in 1 repo~3.5k tokens
    Legal & ComplianceAuto-check passed

More from aipoch/medical-research-skills

All 578 skills in this repo
  • Academic Poster Generator

    aipoch/medical-research-skills

    Complete workflow for generating academic research posters from PDF literature; use when you need to extract paper content from PDFs and produce a LaTeX-based poster…

    1.9k GitHub stars~2.2k tokensUpdated 23 days ago
    Auto-check passed
  • Diagnostic Study Quality Assessment Quadas

    aipoch/medical-research-skills

    Analyzes clinical diagnostic accuracy studies for bias using the QUADAS-2 tool.

    1.9k GitHub stars~1.4k tokensUpdated 23 days ago
    Auto-check passed
  • Exploratory Data Analysis

    aipoch/medical-research-skills

    Perform comprehensive exploratory data analysis on scientific data files across 200+ file formats.

    1.9k GitHub stars~3.7k tokensUpdated 23 days ago
    Auto-check passed
  • Iso Certification

    aipoch/medical-research-skills

    A toolkit for preparing ISO 13485:2016 certification documentation for medical device QMS.

    1.9k GitHub stars~1.8k tokensUpdated 23 days ago
    Auto-check passed
  • Journal Skills

    aipoch/medical-research-skills

    Recommends target journals for manuscript submission by analyzing the paper topic/abstract and the journal distribution of similar PubMed literature; use when users ask for journal…

    1.9k GitHub stars~1.7k tokensUpdated 23 days ago
    Auto-check passed
  • Latex Posters

    aipoch/medical-research-skills

    Creates academic-poster writing packages for LaTeX using beamerposter, tikzposter, or baposter.

    1.9k GitHub stars~1.3k tokensUpdated 23 days ago
    Auto-check passed

Works with

Questions about Patient Consent Simplifier

What does Patient Consent Simplifier do?

Simplifies informed consent documents into patient-friendly language while maintaining regulatory compliance. Patient Consent Simplifier is an agent skill from aipoch/medical-research-skills. Simplifies informed consent documents into patient-friendly language while maintaining regulatory compliance.

When should I use Patient Consent Simplifier?

Patient Consent Simplifier fits situations like: tasks that involve Healthcare and finance regulation; tasks that involve Regulatory compliance; tasks that involve Plain language and style rules.

How do I install Patient Consent Simplifier in Claude Code?

Run `npx skills add aipoch/medical-research-skills --skill patient-consent-simplifier -a claude-code`. Or copy the skill folder (scientific-skills/Other/patient-consent-simplifier in aipoch/medical-research-skills) into .claude/skills/patient-consent-simplifier in your project. Claude Code loads it when a task matches its description.

How do I install Patient Consent Simplifier in Codex?

Run `npx skills add aipoch/medical-research-skills --skill patient-consent-simplifier -a codex`. Or copy the skill folder (scientific-skills/Other/patient-consent-simplifier in aipoch/medical-research-skills) into .agents/skills/patient-consent-simplifier in your project. Codex loads it when a task matches its description.

Can I use Patient Consent Simplifier in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aipoch/medical-research-skills --skill patient-consent-simplifier -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/patient-consent-simplifier, .gemini/skills/patient-consent-simplifier, .github/skills/patient-consent-simplifier and .opencode/skills/patient-consent-simplifier in your project.

What does Patient Consent Simplifier need to run?

Going by SKILL.md and its folder, Patient Consent Simplifier needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Patient Consent Simplifier access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Patient Consent Simplifier safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Patient Consent Simplifier use?

Patient Consent Simplifier is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Patient Consent Simplifier use?

About 1.8k tokens (SKILL.md is roughly 7.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Patient Consent Simplifier?

Skills that share tags, products or a category with Patient Consent Simplifier: Clinical Reports (davila7/claude-code-templates, 33k stars), HIPAA Pre-Deployment Compliance Check (maziyarpanahi/openmed, 5.5k stars), Hipaa Compliance (Sushegaad/Claude-Skills-Governance-Risk-and-Compliance, 946 stars) and ISO Standards Readiness Evidence (K-Dense-AI/scientific-agent-skills, 48k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Patient Consent Simplifier?

aipoch (a GitHub organization) maintains it in aipoch/medical-research-skills, which has 1,937 GitHub stars. The repository holds 578 skills in this directory. The repository was last updated on September 17, 2026.

Source: aipoch/medical-research-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.