Install any skill in seconds. Free to start, no credit card required.
Get Started Free →CAPA system management for medical device QMS, covering root cause analysis, corrective action planning, and effectiveness verification. Use for CAPA investigations, 5-Why and fishbone analysis, and corrective action tracking.
.claude/skills/borghei-capa-officer/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-03 | ✗→✓ | ▲ Improved | 251% | 0% |
| case-04 | ✗→✓ | ▲ Improved | 172% | 0% |
| case-08 | ✗→✓ | ▲ Improved | 146% | 0% |
| case-09 | ✗→✓ | ▲ Improved | 168% | 0% |
| case-10 | ✗→✓ | ▲ Improved | 347% | 0% |
Corrective and Preventive Action (CAPA) management within Quality Management Systems, focusing on systematic root cause analysis, action implementation, and effectiveness verification.
Before starting a CAPA investigation, confirm these inputs. If any is unknown or vague, ASK — do not assume:
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the CAPA record.
Conduct systematic CAPA investigation from initiation through closure:
| Trigger Type | CAPA Required | Criteria | |--------------|---------------|----------| | Customer complaint (safety) | Yes | Any complaint involving patient/user safety | | Customer complaint (quality) | Evaluate | Based on severity and frequency | | Internal audit finding (Major) | Yes | Systematic failure or absence of element | | Internal audit finding (Minor) | Recommended | Isolated lapse or partial implementation | | Nonconformance (recurring) | Yes | Same NC type occurring 3+ times | | Nonconformance (isolated) | Evaluate | Based on severity and risk | | External audit finding | Yes | All Major and Minor findings | | Trend analysis | Evaluate | Based on trend significance |
| CAPA Severity | Required Team Members | |---------------|----------------------| | Critical | CAPA Officer, Process Owner, QA Manager, Subject Matter Expert, Management Rep | | Major | CAPA Officer, Process Owner, Subject Matter Expert | | Minor | CAPA Officer, Process Owner |
Select and apply appropriate RCA methodology based on problem characteristics.
Is the issue safety-critical or involves system reliability?
├── Yes → Use FAULT TREE ANALYSIS
└── No → Is human error the suspected primary cause?
├── Yes → Use HUMAN FACTORS ANALYSIS
└── No → How many potential contributing factors?
├── 1-2 factors (linear causation) → Use 5 WHY ANALYSIS
├── 3-6 factors (complex, systemic) → Use FISHBONE DIAGRAM
└── Unknown/proactive assessment → Use FMEAUse when: Single-cause issues with linear causation, process deviations with clear failure point.
Template:
PROBLEM: [Clear, specific statement]
WHY 1: Why did [problem] occur?
BECAUSE: [First-level cause]
EVIDENCE: [Supporting data]
WHY 2: Why did [first-level cause] occur?
BECAUSE: [Second-level cause]
EVIDENCE: [Supporting data]
WHY 3: Why did [second-level cause] occur?
BECAUSE: [Third-level cause]
EVIDENCE: [Supporting data]
WHY 4: Why did [third-level cause] occur?
BECAUSE: [Fourth-level cause]
EVIDENCE: [Supporting data]
WHY 5: Why did [fourth-level cause] occur?
BECAUSE: [Root cause]
EVIDENCE: [Supporting data]Example - Calibration Overdue:
PROBLEM: pH meter (EQ-042) found 2 months overdue for calibration
WHY 1: Why was calibration overdue?
BECAUSE: Equipment was not on calibration schedule
EVIDENCE: Calibration schedule reviewed, EQ-042 not listed
WHY 2: Why was it not on the schedule?
BECAUSE: Schedule not updated when equipment was purchased
EVIDENCE: Purchase date 2023-06-15, schedule dated 2023-01-01
WHY 3: Why was the schedule not updated?
BECAUSE: No process requires schedule update at equipment purchase
EVIDENCE: SOP-EQ-001 reviewed, no such requirement
WHY 4: Why is there no such requirement?
BECAUSE: Procedure written before equipment tracking was centralized
EVIDENCE: SOP last revised 2019, equipment system implemented 2021
WHY 5: Why has procedure not been updated?
BECAUSE: Periodic review did not assess compatibility with new systems
EVIDENCE: No review against new equipment system documented
ROOT CAUSE: Procedure review process does not assess compatibility
with organizational systems implemented after original procedure creation.| Category | Focus Areas | Typical Causes | |----------|-------------|----------------| | Man (People) | Training, competency, workload | Skill gaps, fatigue, communication | | Machine (Equipment) | Calibration, maintenance, age | Wear, malfunction, inadequate capacity | | Method (Process) | Procedures, work instructions | Unclear steps, missing controls | | Material | Specifications, suppliers, storage | Out-of-spec, degradation, contamination | | Measurement | Calibration, methods, interpretation | Instrument error, wrong method | | Mother Nature | Temperature, humidity, cleanliness | Environmental excursions |
See references/rca-methodologies.md for complete method details and templates.
Before proceeding to action planning, validate root cause:
Develop effective actions addressing identified root causes:
| Type | Purpose | Timeline | Example | |------|---------|----------|---------| | Containment | Stop immediate impact | 24-72 hours | Quarantine affected product | | Correction | Fix the specific occurrence | 1-2 weeks | Rework or replace affected items | | Corrective | Eliminate root cause | 30-90 days | Revise procedure, add controls | | Preventive | Prevent in other areas | 60-120 days | Extend solution to similar processes |
ACTION PLAN TEMPLATE
CAPA Number: [CAPA-XXXX]
Root Cause: [Identified root cause]
ACTION 1: [Specific action description]
- Type: [ ] Containment [ ] Correction [ ] Corrective [ ] Preventive
- Responsible: [Name, Title]
- Due Date: [YYYY-MM-DD]
- Resources: [Required resources]
- Success Criteria: [Measurable outcome]
- Verification Method: [How success will be verified]
ACTION 2: [Specific action description]
...
IMPLEMENTATION TIMELINE:
Week 1: [Milestone]
Week 2: [Milestone]
Week 4: [Milestone]
Week 8: [Milestone]
APPROVAL:
CAPA Owner: _____________ Date: _______
Process Owner: _____________ Date: _______
QA Manager: _____________ Date: _______| Indicator | Target | Red Flag | |-----------|--------|----------| | Action scope | Addresses root cause completely | Treats only symptoms | | Specificity | Measurable deliverables | Vague commitments | | Timeline | Aggressive but achievable | No due dates or unrealistic | | Resources | Identified and allocated | Not specified | | Sustainability | Permanent solution | Temporary fix |
Verify corrective actions achieved intended results:
| CAPA Severity | Wait Period | Verification Window | |---------------|-------------|---------------------| | Critical | 30 days | 30-90 days post-implementation | | Major | 60 days | 60-180 days post-implementation | | Minor | 90 days | 90-365 days post-implementation |
| Method | Use When | Evidence Required | |--------|----------|-------------------| | Data trend analysis | Quantifiable issues | Pre/post comparison, trend charts | | Process audit | Procedure compliance issues | Audit checklist, interview notes | | Record review | Documentation issues | Sample records, compliance rate | | Testing/inspection | Product quality issues | Test results, pass/fail data | | Interview/observation | Training issues | Interview notes, observation records |
Did recurrence occur during verification period?
├── Yes → CAPA INEFFECTIVE (re-investigate root cause)
└── No → Were all effectiveness criteria met?
├── Yes → CAPA EFFECTIVE (proceed to closure)
└── No → Extent of gap?
├── Minor gap → Extend verification or accept with justification
└── Significant gap → CAPA INEFFECTIVE (revise actions)See references/effectiveness-verification-guide.md for detailed procedures.
Monitor CAPA program performance through key indicators.
| Metric | Target | Calculation | |--------|--------|-------------| | CAPA cycle time | <60 days average | (Close Date - Open Date) / Number of CAPAs | | Overdue rate | <10% | Overdue CAPAs / Total Open CAPAs | | First-time effectiveness | >90% | Effective on first verification / Total verified | | Recurrence rate | <5% | Recurred issues / Total closed CAPAs | | Investigation quality | 100% root cause validated | Root causes validated / Total CAPAs |
| Age Bucket | Status | Action Required | |------------|--------|-----------------| | 0-30 days | On track | Monitor progress | | 31-60 days | Monitor | Review for delays | | 61-90 days | Warning | Escalate to management | | >90 days | Critical | Management intervention required |
Monthly CAPA status report includes:
references/rca-methodologies.md contains:
references/effectiveness-verification-guide.md contains:
bash# Generate CAPA status report python scripts/capa_tracker.py --capas capas.json # Interactive mode for manual entry python scripts/capa_tracker.py --interactive # JSON output for integration python scripts/capa_tracker.py --capas capas.json --output json # Generate sample data file python scripts/capa_tracker.py --sample > sample_capas.json
Calculates and reports:
json{ "capas": [ { "capa_number": "CAPA-2024-001", "title": "Calibration overdue for pH meter", "description": "pH meter EQ-042 found 2 months overdue", "source": "AUDIT", "severity": "MAJOR", "status": "VERIFICATION", "open_date": "2024-06-15", "target_date": "2024-08-15", "owner": "J. Smith", "root_cause": "Procedure review gap", "corrective_action": "Updated SOP-EQ-001" } ] }
| Sub-clause | Requirement | Key Activities | |------------|-------------|----------------| | 8.5.2 Corrective Action | Eliminate cause of nonconformity | NC review, cause determination, action evaluation, implementation, effectiveness review | | 8.5.3 Preventive Action | Eliminate potential nonconformity | Trend analysis, cause determination, action evaluation, implementation, effectiveness review |
Required CAPA elements:
| Observation | Root Cause Pattern | |-------------|-------------------| | CAPA not initiated for recurring issue | Trend analysis not performed | | Root cause analysis superficial | Inadequate investigation training | | Effectiveness not verified | No verification procedure | | Actions do not address root cause | Symptom treatment vs. cause elimination |
| Problem | Possible Cause | Resolution | |---------|---------------|------------| | Root cause analysis yields only symptoms | Investigation stopped too early or used wrong RCA method | Apply the RCA Method Selection Decision Tree; ensure at least 5 levels of "why" with evidence at each level | | CAPA effectiveness verification fails repeatedly | Corrective action addresses symptoms, not true root cause | Re-open investigation, consider hybrid RCA approach (e.g., Fishbone + 5-Why), involve additional subject matter experts | | CAPA cycle times consistently exceed 60-day target | Insufficient resources allocated or unclear ownership | Escalate during management review; assign dedicated CAPA coordinator; break complex CAPAs into phased actions | | Overdue CAPA rate exceeds 10% | Lack of automated tracking or reminder system | Implement automated alerts via QMS software; run python scripts/capa_tracker.py --capas capas.json weekly to identify aging items | | Auditors cite "superficial root cause analysis" | Inadequate training on RCA methodologies | Conduct RCA methodology training for investigation teams; use templates from references/rca-methodologies.md; require evidence at each analysis step | | Recurring issues despite closed CAPAs | Preventive actions not extended to similar processes | During action planning, explicitly assess all analogous processes; add preventive actions targeting systemic causes, not just the specific instance | | Stakeholders disagree on CAPA severity classification | No standardized severity criteria applied | Use the CAPA Necessity Determination table and Severity definitions consistently; document classification rationale with objective evidence |
capa_tracker.py metricsIn Scope:
Out of Scope:
fda-consultant-specialist or mdr-745-specialist for submission-related CAPAs)quality-manager-qms-iso13485 for supplier qualification)Important Notes:
capa_tracker.py tool works with JSON input and does not connect to live QMS databases; export data from your eQMS for analysis| Skill | Integration | When to Use | |-------|-------------|-------------| | quality-manager-qms-iso13485 | CAPA findings feed into QMS process improvements and supplier corrective actions | When root cause involves QMS process gaps or supplier nonconformances | | qms-audit-expert | Audit findings are a primary CAPA source; CAPA closure evidence supports audit follow-up | When CAPAs originate from internal or external audit findings | | risk-management-specialist | CAPA outcomes update risk assessments; FMEA results may trigger preventive CAPAs | When root cause analysis reveals previously unassessed risks | | fda-consultant-specialist | FDA 483 observations and warning letters require formal CAPA responses | When CAPA originates from FDA inspection findings | | mdr-745-specialist | EU MDR vigilance reports and FSCA may trigger CAPAs; CAPA data feeds PMS/PSUR | When post-market surveillance identifies safety or performance issues | | quality-documentation-manager | Document control updates resulting from CAPA actions; 21 CFR Part 11 compliance for electronic CAPA records | When corrective actions require SOP revisions or new document creation |
Tracks CAPA status, calculates metrics, identifies overdue items, and generates management review reports.
| Flag | Required | Description | |------|----------|-------------| | --capas <file> | Yes (unless --interactive or --sample) | Path to JSON file containing CAPA records | | --interactive | No | Launch interactive mode for manual CAPA entry | | --output <format> | No | Output format: json for machine-readable, default is human-readable text | | --sample | No | Generate a sample CAPA JSON file to stdout for use as a template |
Calculated Metrics:
Example:
bash# Generate sample data, then analyze python scripts/capa_tracker.py --sample > sample_capas.json python scripts/capa_tracker.py --capas sample_capas.json python scripts/capa_tracker.py --capas sample_capas.json --output json
| Case | Status | Duration (ms) | Turns | Tokens | Tool calls | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Without | With | Δ | Without | With | Δ | Without | With | Δ | Without | With | Δ | ||
case-01 | fail→fail | 17,482 | 15,135 | -13% | 1 | 1 | 0% | 2,780 | 7,312 | +163% | 0 | 0 | — |
case-02 | fail→fail | 17,571 | 17,989 | +2% | 1 | 1 | 0% | 2,999 | 8,083 | +170% | 0 | 0 | — |
case-03 | fail→pass | 12,925 | 12,452 | -4% | 1 | 1 | 0% | 1,977 | 6,936 | +251% | 0 | 0 | — |
case-04 | fail→pass | 14,298 | 8,408 | -41% | 1 | 1 | 0% | 2,278 | 6,205 | +172% | 0 | 0 | — |
case-05 | pass→pass | 7,819 | 7,536 | -4% | 1 | 1 | 0% | 1,262 | 6,164 | +388% | 0 | 0 | — |
case-06 | pass→pass | 12,266 | 10,076 | -18% | 1 | 1 | 0% | 1,820 | 6,512 | +258% | 0 | 0 | — |
case-07 | pass→pass | 12,720 | 9,282 | -27% | 1 | 1 | 0% | 1,998 | 6,397 | +220% | 0 | 0 | — |
case-08 | fail→pass | 16,263 | 8,988 | -45% | 1 | 1 | 0% | 2,537 | 6,236 | +146% | 0 | 0 | — |
case-09 | fail→pass | 17,557 | 13,993 | -20% | 1 | 1 | 0% | 2,705 | 7,242 | +168% | 0 | 0 | — |
case-10 | fail→pass | 8,046 | 3,950 | -51% | 1 | 1 | 0% | 1,285 | 5,741 | +347% | 0 | 0 | — |
case-11 | fail→pass | 13,030 | 6,963 | -47% | 1 | 1 | 0% | 2,199 | 6,181 | +181% | 0 | 0 | — |
case-12 | pass→pass | 12,965 | 5,780 | -55% | 1 | 1 | 0% | 2,050 | 5,900 | +188% | 0 | 0 | — |
case-13 | pass→pass | 3,697 | 4,775 | +29% | 1 | 1 | 0% | 670 | 5,712 | +753% | 0 | 0 | — |
case-14 | pass→pass | 7,029 | 6,431 | -9% | 1 | 1 | 0% | 1,359 | 6,100 | +349% | 0 | 0 | — |
case-15 | fail→pass | 15,166 | 8,974 | -41% | 1 | 1 | 0% | 2,415 | 6,473 | +168% | 0 | 0 | — |
case-16 | pass→pass | 13,030 | 11,422 | -12% | 1 | 1 | 0% | 2,177 | 6,797 | +212% | 0 | 0 | — |
case-17 | fail→pass | 8,652 | 2,284 | -74% | 1 | 1 | 0% | 1,401 | 5,322 | +280% | 0 | 0 | — |
case-18 | fail→pass | 16,272 | 12,620 | -22% | 1 | 1 | 0% | 2,526 | 6,819 | +170% | 0 | 0 | — |
case-19 | fail→pass | 14,411 | 7,463 | -48% | 1 | 1 | 0% | 2,206 | 6,211 | +182% | 0 | 0 | — |
case-20 | fail→pass | 11,822 | 2,405 | -80% | 1 | 1 | 0% | 2,287 | 5,329 | +133% | 0 | 0 | — |
case-21 | pass→pass | 14,415 | 9,962 | -31% | 1 | 1 | 0% | 2,081 | 6,469 | +211% | 0 | 0 | — |
case-22 | fail→fail | 23,764 | 19,936 | -16% | 1 | 1 | 0% | 4,044 | 8,441 | +109% | 0 | 0 | — |
case-23 | fail→fail | 11,056 | 12,698 | +15% | 1 | 1 | 0% | 2,071 | 7,559 | +265% | 0 | 0 | — |
case-24 | fail→fail | 24,679 | 32,449 | +31% | 1 | 1 | 0% | 4,220 | 10,616 | +152% | 0 | 0 | — |
DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 24 cases were attempted. The headline lift of +46 percentage points is the difference between those two pass rates over the 24 comparable cases.
Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.
Other measured skills in the registry, with their headline benchmark lift.