Source: https://github.com/aipoch/medical-research-skills
When to Use
Use this skill in any of the following situations:
- Starting ISO 13485 implementation and you need a structured documentation set (Quality Manual, procedures, records, templates).
- Assessing an existing QMS and you want a gap analysis against ISO 13485:2016 requirements and mandatory documentation.
- Preparing for a certification audit and you need readiness checks, evidence mapping, and prioritized remediation actions.
- Creating or updating specific SOPs (e.g., CAPA, complaint handling, internal audit, document/record control) using consistent templates.
- Transitioning or harmonizing with regulations (e.g., FDA QMSR alignment, EU MDR documentation expectations) and you need to reorganize device documentation (e.g., MDF).
Key Features
- Automated documentation gap analysis via
scripts/gap_analyzer.py to detect missing/covered QMS documents.
- Clause-by-clause ISO 13485 reference guidance using
references/iso-13485-requirements.md.
- Mandatory documentation mapping (procedures and required documents) using
references/mandatory-documents.md.
- Comprehensive audit-style checklist for detailed assessments using
references/gap-analysis-checklist.md.
- Template-based document generation for Quality Manual and key procedures under
assets/templates/.
- Medical Device File (MDF) guidance aligned to ISO 13485 Clause 4.2.3 and FDA QMSR harmonization concepts.
Dependencies
- Python: 3.10+ (recommended)
- pip: 23+ (recommended)
Note: This repository references a script (scripts/gap_analyzer.py). If it introduces additional third-party packages, install them per the repository’s requirements.txt (if present). If no requirements.txt exists, the script is expected to run on the Python standard library.
Example Usage
1) Run an automated gap analysis (end-to-end)
# 1) (Optional) Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate # macOS/Linux
# .venv\Scripts\activate # Windows PowerShell
# 2) Run the gap analyzer against your existing QMS document folder
python scripts/gap_analyzer.py \
--docs-dir ./my-qms-docs \
--output ./gap-report.json
# 3) Review the output
cat ./gap-report.json
2) Use the references and templates to draft core documents
A typical workflow after generating gap-report.json:
- Read ISO clause guidance:
references/iso-13485-requirements.md
- Confirm mandatory documents and applicability:
references/mandatory-documents.md
- Draft/update the Quality Manual:
assets/templates/quality-manual-template.md
- Guidance:
references/quality-manual-guide.md
- Draft priority procedures (examples):
assets/templates/procedures/document-control-procedure-template.md
assets/templates/procedures/CAPA-procedure-template.md
- Perform a detailed checklist-based assessment:
references/gap-analysis-checklist.md
Implementation Details
1) Gap analysis logic (practical model)
The gap analysis workflow is designed to answer:
- Existence: Do required documents/procedures appear to exist in the provided document set?
- Coverage: Which ISO 13485 clauses and mandatory procedures are addressed?
- Prioritization: What should be created/updated first to reduce audit risk?
Typical inputs
- A directory containing QMS documentation (e.g.,
.md, .txt, .docx, .pdf), including manuals, SOPs, work instructions, and forms.
Typical outputs
- A machine-readable report (e.g.,
gap-report.json) that can be summarized into:
- Present vs. missing procedures/documents
- Clause coverage estimates
- A prioritized action list (Critical/High/Medium/Low)
2) ISO 13485 documentation structure (recommended hierarchy)
- Level 1: Quality Manual (policy-level mapping to Clauses 4–8)
- Level 2: Procedures / SOPs (who/what/when; stable process requirements)
- Level 3: Work Instructions (how-to steps; task-level detail)
- Level 4: Forms / Records (evidence of implementation)
This skill emphasizes writing procedures that define what must be done and who is responsible, while keeping detailed step-by-step instructions in work instructions.
3) Quality Manual requirements (key checkpoints)
When drafting with assets/templates/quality-manual-template.md and references/quality-manual-guide.md, ensure:
- The manual includes required content aligned to ISO 13485 Clause 4.2.2.
- The scope is explicit and any exclusions are justified (only where permitted and not impacting safety/effectiveness).
- The manual references the supporting procedures and describes process interactions (e.g., a process map).
- Approval/signature expectations are met (top management ownership of policy-level commitments).
4) Medical Device File (MDF) content model (Clause 4.2.3)
For each device type/family, the MDF should consolidate or reference:
- Device description and intended use
- Labeling and IFU specifications
- Product and manufacturing specifications
- Purchasing/manufacturing/servicing procedures (as applicable)
- Monitoring and measurement procedures
- Installation requirements (if applicable)
- Risk management documentation
- Verification and validation evidence
- Design and development documentation (if applicable)
This structure supports ISO 13485 expectations and aligns with FDA QMSR’s direction toward consolidated device documentation.
5) Procedure customization parameters (what must be decided)
When generating SOPs from templates (e.g., CAPA, document control), the organization must define:
- Roles and responsibilities (role-based, not person-based)
- Triggers and inputs (complaints, audit findings, nonconformities, feedback)
- Timeframes (triage, investigation, closure, effectiveness checks)
- Decision criteria (severity, risk, escalation thresholds)
- Records and retention (what evidence is kept and for how long)
- Interfaces (how CAPA links to complaints, audits, risk management, change control)
6) Mandatory procedures list (reference-driven)
Use references/mandatory-documents.md as the source of truth for:
- Which procedures are required vs. conditional (“if applicable”)
- How to justify non-applicability
- What evidence/records each procedure should produce
For detailed clause interpretation, use references/iso-13485-requirements.md.
1---2name: iso-certification3description: A toolkit for preparing ISO 13485:2016 certification documentation for medical device QMS. Use when you need to perform a documentation gap analysis, draft or update a Quality Manual, create required procedures/work instructions, build Medical Device Files (MDF), interpret ISO 13485 clauses, or identify missing documents for certification (often triggered by ISO 13485, QMS certification, FDA QMSR, EU MDR, or quality system documentation requests).4license: MIT5---6> **Source**: [https://github.com/aipoch/medical-research-skills](https://github.com/aipoch/medical-research-skills)
7
8## When to Use
9
10Use this skill in any of the following situations:
11
121. **Starting ISO 13485 implementation** and you need a structured documentation set (Quality Manual, procedures, records, templates).
132. **Assessing an existing QMS** and you want a **gap analysis** against ISO 13485:2016 requirements and mandatory documentation.
143. **Preparing for a certification audit** and you need readiness checks, evidence mapping, and prioritized remediation actions.
154. **Creating or updating specific SOPs** (e.g., CAPA, complaint handling, internal audit, document/record control) using consistent templates.
165. **Transitioning or harmonizing with regulations** (e.g., **FDA QMSR** alignment, **EU MDR** documentation expectations) and you need to reorganize device documentation (e.g., MDF).
17
18## Key Features
19
20- **Automated documentation gap analysis** via `scripts/gap_analyzer.py` to detect missing/covered QMS documents.
21- **Clause-by-clause ISO 13485 reference guidance** using `references/iso-13485-requirements.md`.
22- **Mandatory documentation mapping** (procedures and required documents) using `references/mandatory-documents.md`.
23- **Comprehensive audit-style checklist** for detailed assessments using `references/gap-analysis-checklist.md`.
24- **Template-based document generation** for Quality Manual and key procedures under `assets/templates/`.
25- **Medical Device File (MDF) guidance** aligned to ISO 13485 Clause 4.2.3 and FDA QMSR harmonization concepts.
26
27## Dependencies
28
29- **Python**: 3.10+ (recommended)
30- **pip**: 23+ (recommended)
31
32> Note: This repository references a script (`scripts/gap_analyzer.py`). If it introduces additional third-party packages, install them per the repository’s `requirements.txt` (if present). If no `requirements.txt` exists, the script is expected to run on the Python standard library.
33
34## Example Usage
35
36### 1) Run an automated gap analysis (end-to-end)
37
38```bash
39# 1) (Optional) Create and activate a virtual environment
40python -m venv .venv
41source .venv/bin/activate # macOS/Linux
42# .venv\Scripts\activate # Windows PowerShell
43
44# 2) Run the gap analyzer against your existing QMS document folder
45python scripts/gap_analyzer.py \
46 --docs-dir ./my-qms-docs \
47 --output ./gap-report.json
48
49# 3) Review the output
50cat ./gap-report.json
51```
52
53### 2) Use the references and templates to draft core documents
54
55A typical workflow after generating `gap-report.json`:
56
571. Read ISO clause guidance:
58 - `references/iso-13485-requirements.md`
592. Confirm mandatory documents and applicability:
60 - `references/mandatory-documents.md`
613. Draft/update the Quality Manual:
62 - `assets/templates/quality-manual-template.md`
63 - Guidance: `references/quality-manual-guide.md`
644. Draft priority procedures (examples):
65 - `assets/templates/procedures/document-control-procedure-template.md`
66 - `assets/templates/procedures/CAPA-procedure-template.md`
675. Perform a detailed checklist-based assessment:
68 - `references/gap-analysis-checklist.md`
69
70## Implementation Details
71
72### 1) Gap analysis logic (practical model)
73
74The gap analysis workflow is designed to answer:
75
76- **Existence**: Do required documents/procedures appear to exist in the provided document set?
77- **Coverage**: Which ISO 13485 clauses and mandatory procedures are addressed?
78- **Prioritization**: What should be created/updated first to reduce audit risk?
79
80**Typical inputs**
81- A directory containing QMS documentation (e.g., `.md`, `.txt`, `.docx`, `.pdf`), including manuals, SOPs, work instructions, and forms.
82
83**Typical outputs**
84- A machine-readable report (e.g., `gap-report.json`) that can be summarized into:
85 - Present vs. missing procedures/documents
86 - Clause coverage estimates
87 - A prioritized action list (Critical/High/Medium/Low)
88
89### 2) ISO 13485 documentation structure (recommended hierarchy)
90
91- **Level 1**: Quality Manual (policy-level mapping to Clauses 4–8)
92- **Level 2**: Procedures / SOPs (who/what/when; stable process requirements)
93- **Level 3**: Work Instructions (how-to steps; task-level detail)
94- **Level 4**: Forms / Records (evidence of implementation)
95
96This skill emphasizes writing procedures that define **what must be done** and **who is responsible**, while keeping detailed step-by-step instructions in work instructions.
97
98### 3) Quality Manual requirements (key checkpoints)
99
100When drafting with `assets/templates/quality-manual-template.md` and `references/quality-manual-guide.md`, ensure:
101
102- The manual includes required content aligned to **ISO 13485 Clause 4.2.2**.
103- The **scope** is explicit and any **exclusions** are justified (only where permitted and not impacting safety/effectiveness).
104- The manual references the supporting procedures and describes **process interactions** (e.g., a process map).
105- Approval/signature expectations are met (top management ownership of policy-level commitments).
106
107### 4) Medical Device File (MDF) content model (Clause 4.2.3)
108
109For each device type/family, the MDF should consolidate or reference:
110
1111. Device description and intended use
1122. Labeling and IFU specifications
1133. Product and manufacturing specifications
1144. Purchasing/manufacturing/servicing procedures (as applicable)
1155. Monitoring and measurement procedures
1166. Installation requirements (if applicable)
1177. Risk management documentation
1188. Verification and validation evidence
1199. Design and development documentation (if applicable)
120
121This structure supports ISO 13485 expectations and aligns with FDA QMSR’s direction toward consolidated device documentation.
122
123### 5) Procedure customization parameters (what must be decided)
124
125When generating SOPs from templates (e.g., CAPA, document control), the organization must define:
126
127- **Roles and responsibilities** (role-based, not person-based)
128- **Triggers and inputs** (complaints, audit findings, nonconformities, feedback)
129- **Timeframes** (triage, investigation, closure, effectiveness checks)
130- **Decision criteria** (severity, risk, escalation thresholds)
131- **Records and retention** (what evidence is kept and for how long)
132- **Interfaces** (how CAPA links to complaints, audits, risk management, change control)
133
134### 6) Mandatory procedures list (reference-driven)
135
136Use `references/mandatory-documents.md` as the source of truth for:
137- Which procedures are required vs. conditional (“if applicable”)
138- How to justify non-applicability
139- What evidence/records each procedure should produce
140
141For detailed clause interpretation, use `references/iso-13485-requirements.md`.