qms-audit-expert — Claude Code skill: ISO 13485 internal audit
A Claude Code skill that runs an ISO 13485 internal QMS audit from plan to CAPA check: risk-based schedule, evidence, finding classification.
/plugin marketplace add alirezarezvani/claude-skills
/plugin install ra-qm-skills@claude-code-skillsWhat qms-audit-expert does
The skill sets the order of an internal audit for a medical device QMS under ISO 13485. Planning comes first. List every process, tag it High, Medium or Low risk, then attach a frequency: quarterly for design control, CAPA and production validation, twice a year for purchasing and document control, once a year for infrastructure. A clause table follows, from 4.2 document control and 5.6 management review through 7.3 design control, 7.6 calibration and 8.5 CAPA.
Each finding gets a three-line record: requirement, evidence, gap. Severity comes out of a decision tree into Major, Minor or Observation, and a paired table tells you how deep the CAPA has to go and when effectiveness gets verified. The audit report is due within 5 business days, Major CAPA within 30 days, Minor within 60.
The detail sits in two files under references/: iso13485-audit-guide.md holds the full question sets per clause, nonconformity-classification.md the grading guidance. Without them you write the clause questions yourself, so verify the skill folder copied over completely after install.
What it helps with
- build an annual audit schedule with frequency set by process risk
- collect evidence against a single ISO 13485 clause
- decide whether a finding is Major, Minor or an observation
- verify CAPA effectiveness at the follow-up audit
- run a mock audit before the certification body arrives
Example prompts for the agent
- Build this year's internal audit schedule for ISO 13485 and set frequency by process risk.
- Audit clause 7.3 and write up the findings as requirement, evidence, gap.
- Classify this overdue calibration finding for me: Major, Minor or observation?
How to install qms-audit-expert
1Plugin marketplace
/plugin marketplace add alirezarezvani/claude-skills/plugin install ra-qm-skills@claude-code-skillsThis installs the whole ra-qm-skills plugin with all its skills
2Skills CLI (Vercel)
npx skills add alirezarezvani/claude-skills --skill qms-audit-expert -a claude-code3Manually: put the files in place
~/.claude/skills/qms-audit-expert/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/qms-audit-expert/
Manually: put the files in place
.agents/skills/qms-audit-expert/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/qms-audit-expert/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install alirezarezvani/claude-skills qms-audit-expert2Manually: put the files in place
.github/skills/qms-audit-expert/SKILL.mdPlatform CLI
gemini skills install https://github.com/alirezarezvani/claude-skills --path ra-qm-team/skills/qms-audit-expertManually: put the files in place
.devin/skills/qms-audit-expert/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set349
The whole set →Similar
Questions about qms-audit-expert
How do I install qms-audit-expert in Claude Code?
Use the marketplace: /plugin marketplace add alirezarezvani/claude-skills first, then /plugin install ra-qm-skills@claude-code-skills.
What does qms-audit-expert do?
It walks an ISO 13485 internal audit end to end: risk-based planning, evidence collection, finding write-up, CAPA tracking and preparation for an external audit.
Does the skill ship with everything it needs?
The full clause question sets and classification criteria live in references/iso13485-audit-guide.md and references/nonconformity-classification.md. Copy the whole skill folder, or those parts go missing.
Source text
SKILL.md · MIT
---
name: "qms-audit-expert"
description: ISO 13485 internal audit expertise for medical device QMS. Covers audit planning, execution, nonconformity classification, and CAPA verification. Use when planning internal audits, executing audits, classifying findings, preparing for external audits, or managing an audit program.
metadata:
triggers:
- ISO 13485 audit
- internal audit
- QMS audit
- audit planning
- nonconformity classification
- CAPA verification
- audit checklist
- audit finding
- external audit prep
- audit schedule
---
# QMS Audit Expert
ISO 13485 internal audit methodology for medical device quality management systems.
---
## Table of Contents
- [Audit Planning Workflow](#audit-planning-workflow)
- [Audit Execution](#audit-execution)
- [Nonconformity Management](#nonconformity-management)
- [External Audit Preparation](#external-audit-preparation)
- [Reference Documentation](#reference-documentation)
- [Tools](#tools)
---
## Audit Planning Workflow
Plan risk-based internal audit program:
1. List all QMS processes requiring audit
2. Assign risk level to each process (High/Medium/Low)
3. Review previous audit findings and trends
4. Determine audit frequency by risk level
5. Assign qualified auditors (verify independence)
6. Create annual audit schedule
7. Communicate schedule to process owners
8. **Validation:** All ISO 13485 clauses covered within cycle
### Risk-Based Audit Frequency
| Risk Level | Frequency | Criteria |
|------------|-----------|----------|
| High | Quarterly | Design control, CAPA, production validation |
| Medium | Semi-annual | Purchasing, training, document control |
| Low | Annual | Infrastructure, management review (if stable) |
### Audit Scope by Clause
| Clause | Process | Focus Areas |
|--------|---------|-------------|
| 4.2 | Document Control | Document approval, distribution, obsolete control |
| 5.6 | Management Review | Inputs complete, decisions documented, actions tracked |
| 6.2 | Training | Competency defined, records complete, effectiveness verified |
| 7.3 | Design Control | Inputs, reviews, V&V, transfer, changes |
| 7.4 | Purchasing | Supplier evaluation, incoming inspection |
| 7.5 | Production | Work instructions, process validation, DHR |
| 7.6 | Calibration | Equipment list, calibration status, out-of-tolerance |
| 8.2.2 | Internal Audit | Schedule compliance, auditor independence |
| 8.3 | NC Product | Identification, segregation, disposition |
| 8.5 | CAPA | Root cause, implementation, effectiveness |
### Auditor Independence
Verify auditor independence before assignment:
- [ ] Auditor not responsible for area being audited
- [ ] No direct reporting relationship to auditee
- [ ] Not involved in recent activities under audit
- [ ] Documented qualification for audit scope
---
## Audit Execution
Conduct systematic internal audit:
1. Prepare audit plan (scope, criteria, schedule)
2. Review relevant documentation before audit
3. Conduct opening meeting with auditee
4. Collect evidence (records, interviews, observation)
5. Classify findings (Major/Minor/Observation)
6. Conduct closing meeting with preliminary findings
7. Prepare audit report within 5 business days
8. **Validation:** All scope items covered, findings supported by evidence
### Evidence Collection
| Method | Use For | Documentation |
|--------|---------|---------------|
| Document review | Procedures, records | Document number, version, date |
| Interview | Process understanding | Interviewee name, role, summary |
| Observation | Actual practice | What, where, when observed |
| Record trace | Process flow | Record IDs, dates, linkage |
### Audit Questions by Clause
**Document Control (4.2):**
- Show me the document master list
- How do you control obsolete documents?
- Show me evidence of document change approval
**Design Control (7.3):**
- Show me the Design History File for [product]
- Who participates in design reviews?
- Show me design input to output traceability
**CAPA (8.5):**
- Show me the CAPA log with open items
- How do you determine root cause?
- Show me effectiveness verification records
See `references/iso13485-audit-guide.md` for complete question sets.
### Finding Documentation
Document each finding with:
```
Requirement: [Specific ISO 13485 clause or procedure]
Evidence: [What was observed, reviewed, or heard]
Gap: [How evidence fails to meet requirement]
```
**Example:**
```
Requirement: ISO 13485:2016 Clause 7.6 requires calibration
at specified intervals.
Evidence: Calibration records for pH meter (EQ-042) show
last calibration 2024-01-15. Calibration interval is
12 months. Today is 2025-03-20.
Gap: Equipment is 2 months overdue for calibration,
representing a gap in calibration program execution.
```
---
## Nonconformity Management
Classify and manage audit findings:
1. Evaluate finding against classification criteria
2. Assign severity (Major/Minor/Observation)
3. Document finding with objective evidence
4. Communicate to process owner
5. Initiate CAPA for Major/Minor findings
6. Track to closure
7. Verify effectiveness at follow-up
8. **Validation:** Finding closed only after effective CAPA
### Classification Criteria
| Category | Definition | CAPA Required | Timeline |
|----------|------------|---------------|----------|
| Major | Systematic failure or absence of element | Yes | 30 days |
| Minor | Isolated lapse or partial implementation | Recommended | 60 days |
| Observation | Improvement opportunity | Optional | As appropriate |
### Classification Decision
```
Is required element absent or failed?
├── Yes → Systematic (multiple instances)? → MAJOR
│ └── No → Could affect product safety? → MAJOR
│ └── No → MINOR
└── No → Deviation from procedure?
├── Yes → Recurring? → MAJOR
│ └── No → MINOR
└── No → Improvement opportunity? → OBSERVATION
```
### CAPA Integration
| Finding Severity | CAPA Depth | Verification |
|------------------|------------|--------------|
| Major | Full root cause analysis (5-Why, Fishbone) | Next audit or within 6 months |
| Minor | Immediate cause identification | Next scheduled audit |
| Observation | Not required | Noted at next audit |
See `references/nonconformity-classification.md` for detailed guidance.
---
## External Audit Preparation
Prepare for certification body or regulatory audit:
1. Complete all scheduled internal audits
2. Verify all findings closed with effective CAPA
3. Review documentation for currency and accuracy
4. Conduct management review with audit as input
5. Prepare facility and personnel
6. Conduct mock audit (full scope)
7. Brief personnel on audit protocol
8. **Validation:** Mock audit findings addressed before external audit
### Pre-Audit Readiness Checklist
**Documentation:**
- [ ] Quality Manual current
- [ ] Procedures reflect actual practice
- [ ] Records complete and retrievable
- [ ] Previous audit findings closed
**Personnel:**
- [ ] Key personnel available during audit
- [ ] Subject matter experts identified
- [ ] Personnel briefed on audit protocol
- [ ] Escorts assigned
**Facility:**
- [ ] Work areas organized
- [ ] Documents at point of use current
- [ ] Equipment calibration status visible
- [ ] Nonconforming product segregated
### Mock Audit Protocol
1. Use external auditor or qualified internal auditor
2. Cover full scope of upcoming external audit
3. Simulate actual audit conditions (timing, formality)
4. Document findings as for real audit
5. Address all Major and Minor findings before external audit
6. Brief management on readiness status
---
## Reference Documentation
### ISO 13485 Audit Guide
`references/iso13485-audit-guide.md` contains:
- Clause-by-clause audit methodology
- Sample audit questions for each clause
- Evidence collection requirements
- Common nonconformities by clause
- Finding severity classification
### Nonconformity Classification
`references/nonconformity-classification.md` contains:
- Severity classification criteria and decision tree
- Impact vs. occurrence matrix
- CAPA integration requirements
- Finding documentation templates
- Closure requirements by severity
---
## Tools
### Audit Schedule Optimizer
```bash
# Generate optimized audit schedule
python scripts/audit_schedule_optimizer.py --processes processes.json
# Interactive mode
python scripts/audit_schedule_optimizer.py --interactive
# JSON output for integration
python scripts/audit_schedule_optimizer.py --processes processes.json --output json
```
Generates risk-based audit schedule considering:
- Process risk level
- Previous findings
- Days since last audit
- Criticality scores
**Output includes:**
- Prioritized audit schedule
- Quarterly distribution
- Overdue audit alerts
- Resource recommendations
### Sample Process Input
```json
{
"processes": [
{
"name": "Design Control",
"iso_clause": "7.3",
"risk_level": "HIGH",
"last_audit_date": "2024-06-15",
"previous_findings": 2
},
{
"name": "Document Control",
"iso_clause": "4.2",
"risk_level": "MEDIUM",
"last_audit_date": "2024-09-01",
"previous_findings": 0
}
]
}
```
---
## Audit Program Metrics
Track audit program effectiveness:
| Metric | Target | Measurement |
|--------|--------|-------------|
| Schedule compliance | >90% | Audits completed on time |
| Finding closure rate | >95% | Findings closed by due date |
| Repeat findings | <10% | Same finding in consecutive audits |
| CAPA effectiveness | >90% | Verified effective at follow-up |
| Auditor utilization | 4 days/month | Audit days per qualified auditor |
© Alireza Rezvani · MIT · alirezarezvani/claude-skills