@pikaa-ai/pikaa 0.3.22 → 0.3.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (191) hide show
  1. package/assets/brand/orbit-logo-option4-whale.jpg +0 -0
  2. package/assets/brand/orbit-logo.jpg +0 -0
  3. package/assets/brand/orbit-logo.png +0 -0
  4. package/assets/brand/orbit-logo.svg +3 -0
  5. package/dist/cli.js +448 -181
  6. package/dist/index.js +22 -2
  7. package/package.json +1 -2
  8. package/skills/adaptyv/SKILL.md +0 -240
  9. package/skills/aeon/SKILL.md +0 -402
  10. package/skills/analytical-method-validation/SKILL.md +0 -299
  11. package/skills/anndata/SKILL.md +0 -431
  12. package/skills/arbor/SKILL.md +0 -152
  13. package/skills/arboreto/SKILL.md +0 -267
  14. package/skills/astropy/SKILL.md +0 -353
  15. package/skills/autoskill/SKILL.md +0 -233
  16. package/skills/benchling-integration/SKILL.md +0 -229
  17. package/skills/bgpt-paper-search/SKILL.md +0 -75
  18. package/skills/bids/SKILL.md +0 -237
  19. package/skills/biopython/SKILL.md +0 -472
  20. package/skills/bioservices/SKILL.md +0 -399
  21. package/skills/bulk-rnaseq/SKILL.md +0 -198
  22. package/skills/cellxgene-census/SKILL.md +0 -283
  23. package/skills/cirq/SKILL.md +0 -370
  24. package/skills/citation-management/SKILL.md +0 -329
  25. package/skills/clinical-decision-support/SKILL.md +0 -238
  26. package/skills/clinical-decision-support/references/README.md +0 -62
  27. package/skills/clinical-reports/SKILL.md +0 -248
  28. package/skills/clinical-reports/references/README.md +0 -34
  29. package/skills/cobrapy/SKILL.md +0 -496
  30. package/skills/consciousness-council/SKILL.md +0 -151
  31. package/skills/dask/SKILL.md +0 -482
  32. package/skills/database-lookup/SKILL.md +0 -386
  33. package/skills/datamol/SKILL.md +0 -200
  34. package/skills/deepchem/SKILL.md +0 -244
  35. package/skills/deepspot-m/SKILL.md +0 -175
  36. package/skills/deeptools/SKILL.md +0 -412
  37. package/skills/depmap/SKILL.md +0 -301
  38. package/skills/dhdna-profiler/SKILL.md +0 -184
  39. package/skills/diffdock/SKILL.md +0 -488
  40. package/skills/dnanexus-integration/SKILL.md +0 -325
  41. package/skills/docx/SKILL.md +0 -99
  42. package/skills/esm/SKILL.md +0 -334
  43. package/skills/etetoolkit/SKILL.md +0 -327
  44. package/skills/exa-search/SKILL.md +0 -102
  45. package/skills/executing-plans/SKILL.md +0 -14
  46. package/skills/experimental-design/SKILL.md +0 -234
  47. package/skills/exploratory-data-analysis/SKILL.md +0 -280
  48. package/skills/flowio/SKILL.md +0 -310
  49. package/skills/fluidsim/SKILL.md +0 -279
  50. package/skills/frontend-design/SKILL.md +0 -100
  51. package/skills/generate-image/SKILL.md +0 -304
  52. package/skills/geniml/SKILL.md +0 -310
  53. package/skills/genomic-coordinates/SKILL.md +0 -189
  54. package/skills/genomic-intelligence/SKILL.md +0 -243
  55. package/skills/geomaster/README.md +0 -105
  56. package/skills/geomaster/SKILL.md +0 -366
  57. package/skills/geopandas/SKILL.md +0 -250
  58. package/skills/get-available-resources/SKILL.md +0 -260
  59. package/skills/gget/SKILL.md +0 -153
  60. package/skills/ginkgo-cloud-lab/SKILL.md +0 -106
  61. package/skills/glycoengineering/SKILL.md +0 -339
  62. package/skills/gtars/SKILL.md +0 -282
  63. package/skills/guardian-rails/SKILL.md +0 -54
  64. package/skills/histolab/SKILL.md +0 -243
  65. package/skills/hugging-science/SKILL.md +0 -132
  66. package/skills/hypogenic/SKILL.md +0 -290
  67. package/skills/hypothesis-generation/SKILL.md +0 -264
  68. package/skills/imaging-data-commons/SKILL.md +0 -496
  69. package/skills/infographics/SKILL.md +0 -315
  70. package/skills/iso-standards-readiness/SKILL.md +0 -352
  71. package/skills/lab-hardware-cad/SKILL.md +0 -372
  72. package/skills/labarchive-integration/SKILL.md +0 -216
  73. package/skills/lamindb/SKILL.md +0 -408
  74. package/skills/latchbio-integration/SKILL.md +0 -227
  75. package/skills/latex-posters/SKILL.md +0 -369
  76. package/skills/latex-posters/references/README.md +0 -439
  77. package/skills/liteparse/SKILL.md +0 -295
  78. package/skills/literature-review/SKILL.md +0 -263
  79. package/skills/markdown-mermaid-writing/SKILL.md +0 -322
  80. package/skills/market-research-reports/SKILL.md +0 -337
  81. package/skills/markitdown/SKILL.md +0 -264
  82. package/skills/matchms/SKILL.md +0 -276
  83. package/skills/matlab/SKILL.md +0 -274
  84. package/skills/matplotlib/SKILL.md +0 -378
  85. package/skills/medchem/SKILL.md +0 -321
  86. package/skills/modal/SKILL.md +0 -468
  87. package/skills/molecular-dynamics/SKILL.md +0 -458
  88. package/skills/molfeat/SKILL.md +0 -348
  89. package/skills/ncats-arax/SKILL.md +0 -178
  90. package/skills/networkx/SKILL.md +0 -440
  91. package/skills/neurokit2/SKILL.md +0 -323
  92. package/skills/neuropixels-analysis/SKILL.md +0 -412
  93. package/skills/nextflow/SKILL.md +0 -195
  94. package/skills/omero-integration/SKILL.md +0 -222
  95. package/skills/onekgpd/SKILL.md +0 -371
  96. package/skills/ontology-term-resolution/SKILL.md +0 -147
  97. package/skills/open-notebook/SKILL.md +0 -297
  98. package/skills/openpiv/SKILL.md +0 -469
  99. package/skills/opentrons-integration/SKILL.md +0 -322
  100. package/skills/optimize-for-gpu/SKILL.md +0 -176
  101. package/skills/owasp-top10/SKILL.md +0 -48
  102. package/skills/pacsomatic/LICENSE +0 -21
  103. package/skills/pacsomatic/SKILL.md +0 -150
  104. package/skills/paper-lookup/SKILL.md +0 -263
  105. package/skills/paperclip/SKILL.md +0 -413
  106. package/skills/paperzilla/SKILL.md +0 -159
  107. package/skills/parallel-web/SKILL.md +0 -128
  108. package/skills/pathml/SKILL.md +0 -222
  109. package/skills/pathogen-variant-surveillance/SKILL.md +0 -208
  110. package/skills/pathway-enrichment/SKILL.md +0 -194
  111. package/skills/pdf/SKILL.md +0 -322
  112. package/skills/peer-review/SKILL.md +0 -288
  113. package/skills/penetration-testing/SKILL.md +0 -31
  114. package/skills/pennylane/SKILL.md +0 -240
  115. package/skills/phylogenetics/SKILL.md +0 -409
  116. package/skills/pi-agent/SKILL.md +0 -83
  117. package/skills/pkpd-modeling/SKILL.md +0 -381
  118. package/skills/polars/SKILL.md +0 -393
  119. package/skills/polars-bio/SKILL.md +0 -379
  120. package/skills/ponytail/SKILL.md +0 -31
  121. package/skills/ponytail-audit/SKILL.md +0 -18
  122. package/skills/pptx/SKILL.md +0 -246
  123. package/skills/pptx-posters/SKILL.md +0 -258
  124. package/skills/primekg/SKILL.md +0 -99
  125. package/skills/protocolsio-integration/SKILL.md +0 -236
  126. package/skills/pufferlib/SKILL.md +0 -328
  127. package/skills/pydeseq2/SKILL.md +0 -369
  128. package/skills/pydicom/SKILL.md +0 -381
  129. package/skills/pyhealth/SKILL.md +0 -124
  130. package/skills/pylabrobot/SKILL.md +0 -216
  131. package/skills/pymatgen/SKILL.md +0 -404
  132. package/skills/pymc/SKILL.md +0 -310
  133. package/skills/pymoo/SKILL.md +0 -276
  134. package/skills/pyopenms/SKILL.md +0 -179
  135. package/skills/pysam/SKILL.md +0 -330
  136. package/skills/pytdc/SKILL.md +0 -297
  137. package/skills/pytorch-lightning/SKILL.md +0 -191
  138. package/skills/pyzotero/SKILL.md +0 -137
  139. package/skills/qiskit/SKILL.md +0 -259
  140. package/skills/qutip/SKILL.md +0 -317
  141. package/skills/rdkit/SKILL.md +0 -94
  142. package/skills/relsa-severity-assessment/SKILL.md +0 -354
  143. package/skills/research-grants/SKILL.md +0 -296
  144. package/skills/research-grants/references/README.md +0 -287
  145. package/skills/research-lookup/README.md +0 -106
  146. package/skills/research-lookup/SKILL.md +0 -338
  147. package/skills/rowan/SKILL.md +0 -398
  148. package/skills/scanpy/SKILL.md +0 -303
  149. package/skills/scholar-evaluation/SKILL.md +0 -296
  150. package/skills/scientific-brainstorming/SKILL.md +0 -282
  151. package/skills/scientific-critical-thinking/SKILL.md +0 -180
  152. package/skills/scientific-schematics/SKILL.md +0 -370
  153. package/skills/scientific-slides/SKILL.md +0 -379
  154. package/skills/scientific-visualization/SKILL.md +0 -285
  155. package/skills/scientific-writing/SKILL.md +0 -356
  156. package/skills/scikit-bio/SKILL.md +0 -470
  157. package/skills/scikit-learn/SKILL.md +0 -324
  158. package/skills/scikit-survival/SKILL.md +0 -313
  159. package/skills/scvelo/SKILL.md +0 -328
  160. package/skills/scvi-tools/SKILL.md +0 -201
  161. package/skills/seaborn/SKILL.md +0 -254
  162. package/skills/security-auditor/SKILL.md +0 -37
  163. package/skills/shap/SKILL.md +0 -282
  164. package/skills/simpy/SKILL.md +0 -283
  165. package/skills/stable-baselines3/SKILL.md +0 -325
  166. package/skills/statistical-analysis/SKILL.md +0 -446
  167. package/skills/statistical-power/SKILL.md +0 -200
  168. package/skills/statsmodels/SKILL.md +0 -238
  169. package/skills/sympy/SKILL.md +0 -354
  170. package/skills/systematic-debugging/SKILL.md +0 -35
  171. package/skills/tamarind/SKILL.md +0 -285
  172. package/skills/tdd/SKILL.md +0 -26
  173. package/skills/tiledbvcf/SKILL.md +0 -456
  174. package/skills/timesfm-forecasting/SKILL.md +0 -408
  175. package/skills/timesfm-forecasting/examples/global-temperature/README.md +0 -178
  176. package/skills/torch-geometric/SKILL.md +0 -458
  177. package/skills/torchdrug/SKILL.md +0 -241
  178. package/skills/transformers/SKILL.md +0 -195
  179. package/skills/treatment-plans/SKILL.md +0 -174
  180. package/skills/treatment-plans/references/README.md +0 -19
  181. package/skills/umap-learn/SKILL.md +0 -488
  182. package/skills/uncertainty-and-units/SKILL.md +0 -384
  183. package/skills/usfiscaldata/SKILL.md +0 -171
  184. package/skills/vaex/SKILL.md +0 -204
  185. package/skills/venue-templates/SKILL.md +0 -269
  186. package/skills/verification-before-completion/SKILL.md +0 -22
  187. package/skills/waypoint-bio/SKILL.md +0 -273
  188. package/skills/what-if-oracle/SKILL.md +0 -184
  189. package/skills/writing-plans/SKILL.md +0 -15
  190. package/skills/xlsx/SKILL.md +0 -110
  191. package/skills/zarr-python/SKILL.md +0 -241
@@ -1,315 +0,0 @@
1
- ---
2
- name: infographics
3
- description: "Create professional infographics using Nano Banana Pro AI with smart iterative refinement. Uses Gemini 3.6 Flash for quality review. Integrates research-lookup and web search for accurate data. Supports 10 infographic types, 8 industry styles, and colorblind-safe palettes."
4
- allowed-tools: Read Write Edit Bash
5
- metadata:
6
- version: "1.6"
7
- openclaw:
8
- primaryEnv: OPENROUTER_API_KEY
9
- envVars:
10
- - name: OPENROUTER_API_KEY
11
- required: false
12
- description: OpenRouter API key for the skill's LLM-powered steps.
13
- ---
14
-
15
- # Infographics
16
-
17
- ## Overview
18
-
19
- Infographics are visual representations of information, data, or knowledge designed to present complex content quickly and clearly. **This skill uses Nano Banana Pro AI for infographic generation with Gemini 3.6 Flash quality review and Perplexity Sonar for research.**
20
-
21
- **How it works:**
22
- - (Optional) **Research phase**: Gather accurate facts and statistics using Perplexity Sonar
23
- - Describe your infographic in natural language
24
- - Nano Banana Pro generates publication-quality infographics automatically
25
- - **Gemini 3.6 Flash reviews quality** against document-type thresholds
26
- - **Smart iteration**: Only regenerates if quality is below threshold
27
- - Professional-ready output in minutes
28
- - No design skills required
29
-
30
- **Quality Thresholds by Document Type:**
31
- | Document Type | Threshold | Description |
32
- |---------------|-----------|-------------|
33
- | marketing | 8.5/10 | Marketing materials - must be compelling |
34
- | report | 8.0/10 | Business reports - professional quality |
35
- | presentation | 7.5/10 | Slides, talks - clear and engaging |
36
- | social | 7.0/10 | Social media content |
37
- | internal | 7.0/10 | Internal use |
38
- | draft | 6.5/10 | Working drafts |
39
- | default | 7.5/10 | General purpose |
40
-
41
- **Simply describe what you want, and Nano Banana Pro creates it.**
42
-
43
- ## Quick Start
44
-
45
- Generate any infographic by simply describing it:
46
-
47
- ```bash
48
- # Generate a list infographic (default threshold 7.5/10)
49
- python skills/infographics/scripts/generate_infographic.py \
50
- "5 benefits of regular exercise" \
51
- -o figures/exercise_benefits.png --type list
52
-
53
- # Generate for marketing (highest threshold: 8.5/10)
54
- python skills/infographics/scripts/generate_infographic.py \
55
- "Product features comparison" \
56
- -o figures/product_comparison.png --type comparison --doc-type marketing
57
-
58
- # Generate with corporate style
59
- python skills/infographics/scripts/generate_infographic.py \
60
- "Company milestones 2010-2025" \
61
- -o figures/timeline.png --type timeline --style corporate
62
-
63
- # Generate with colorblind-safe palette
64
- python skills/infographics/scripts/generate_infographic.py \
65
- "Heart disease statistics worldwide" \
66
- -o figures/health_stats.png --type statistical --palette wong
67
-
68
- # Generate WITH RESEARCH for accurate, up-to-date data
69
- python skills/infographics/scripts/generate_infographic.py \
70
- "Global AI market size and growth projections" \
71
- -o figures/ai_market.png --type statistical --research
72
- ```
73
-
74
- **What happens behind the scenes:**
75
- 1. **(Optional) Research**: Perplexity Sonar gathers accurate facts, statistics, and data
76
- 2. **Generation 1**: Nano Banana Pro creates initial infographic following design best practices
77
- 3. **Review 1**: **Gemini 3.6 Flash** evaluates quality against document-type threshold
78
- 4. **Decision**: If quality >= threshold → **DONE** (no more iterations needed!)
79
- 5. **If below threshold**: Improved prompt based on critique, regenerate
80
- 6. **Repeat**: Until quality meets threshold OR max iterations reached
81
-
82
- **Smart Iteration Benefits:**
83
- - ✅ Saves API calls if first generation is good enough
84
- - ✅ Higher quality standards for marketing materials
85
- - ✅ Faster turnaround for drafts/internal use
86
- - ✅ Appropriate quality for each use case
87
-
88
- **Output**: Versioned images plus a detailed review log with quality scores, critiques, and early-stop information.
89
-
90
- ## When to Use This Skill
91
-
92
- Use the **infographics** skill when:
93
- - Presenting data or statistics in a visual format
94
- - Creating timeline visualizations for project milestones or history
95
- - Explaining processes, workflows, or step-by-step guides
96
- - Comparing options, products, or concepts side-by-side
97
- - Summarizing key points in an engaging visual format
98
- - Creating geographic or map-based data visualizations
99
- - Building hierarchical or organizational charts
100
- - Designing social media content or marketing materials
101
-
102
- **Use scientific-schematics instead for:**
103
- - Technical flowcharts and circuit diagrams
104
- - Biological pathways and molecular diagrams
105
- - Neural network architecture diagrams
106
- - CONSORT/PRISMA methodology diagrams
107
-
108
- ---
109
-
110
- ## Research Integration
111
-
112
- ### Automatic Data Gathering (`--research`)
113
-
114
- When creating infographics that require accurate, up-to-date data, use the `--research` flag to automatically gather facts and statistics using **Perplexity Sonar Pro**.
115
-
116
- ```bash
117
- # Research and generate statistical infographic
118
- python skills/infographics/scripts/generate_infographic.py \
119
- "Global renewable energy adoption rates by country" \
120
- -o figures/renewable_energy.png --type statistical --research
121
-
122
- # Research for timeline infographic
123
- python skills/infographics/scripts/generate_infographic.py \
124
- "History of artificial intelligence breakthroughs" \
125
- -o figures/ai_history.png --type timeline --research
126
-
127
- # Research for comparison infographic
128
- python skills/infographics/scripts/generate_infographic.py \
129
- "Electric vehicles vs hydrogen vehicles comparison" \
130
- -o figures/ev_hydrogen.png --type comparison --research
131
- ```
132
-
133
- ### What Research Provides
134
-
135
- The research phase automatically:
136
-
137
- 1. **Gathers Key Facts**: 5-8 relevant facts and statistics about the topic
138
- 2. **Provides Context**: Background information for accurate representation
139
- 3. **Finds Data Points**: Specific numbers, percentages, and dates
140
- 4. **Cites Sources**: Mentions major studies or sources
141
- 5. **Prioritizes Recency**: Focuses on 2023-2026 information
142
-
143
- ### When to Use Research
144
-
145
- **Enable research (`--research`) for:**
146
- - Statistical infographics requiring accurate numbers
147
- - Market data, industry statistics, or trends
148
- - Scientific or medical information
149
- - Current events or recent developments
150
- - Any topic where accuracy is critical
151
-
152
- **Skip research for:**
153
- - Simple conceptual infographics
154
- - Internal process documentation
155
- - Topics where you provide all the data in the prompt
156
- - Speed-critical generation
157
-
158
- ### Research Output
159
-
160
- When research is enabled, additional files are created:
161
- - `{name}_research.json` - Raw research data and sources
162
- - Research content is automatically incorporated into the infographic prompt
163
-
164
- ---
165
-
166
- ## Infographic Types
167
-
168
- Ten types are supported via `--type`: `statistical`, `timeline`, `process`, `comparison`,
169
- `list`, `geographic`, `hierarchical`, `anatomical`, `resume`, and `social`. What each is
170
- for, the data shape it expects, and worked prompts are in
171
- [references/infographic_type_catalog.md](references/infographic_type_catalog.md) and
172
- [references/infographic_types.md](references/infographic_types.md).
173
-
174
- ## Style Presets
175
-
176
- ### Industry Styles (`--style`)
177
-
178
- | Style | Colors | Best For |
179
- |-------|--------|----------|
180
- | `corporate` | Navy, steel blue, gold | Business reports, finance |
181
- | `healthcare` | Medical blue, cyan, light cyan | Medical, wellness |
182
- | `technology` | Tech blue, slate, violet | Software, data, AI |
183
- | `nature` | Forest green, mint, earth brown | Environmental, organic |
184
- | `education` | Academic blue, light blue, coral | Learning, academic |
185
- | `marketing` | Coral, teal, yellow | Social media, campaigns |
186
- | `finance` | Navy, gold, green/red | Investment, banking |
187
- | `nonprofit` | Warm orange, sage, sand | Social causes, charities |
188
-
189
- ```bash
190
- # Corporate style
191
- python skills/infographics/scripts/generate_infographic.py \
192
- "Q4 Results" -o q4.png --type statistical --style corporate
193
-
194
- # Healthcare style
195
- python skills/infographics/scripts/generate_infographic.py \
196
- "Patient Journey" -o journey.png --type process --style healthcare
197
- ```
198
-
199
- ---
200
-
201
- ## Colorblind-Safe Palettes
202
-
203
- ### Available Palettes (`--palette`)
204
-
205
- | Palette | Colors | Description |
206
- |---------|--------|-------------|
207
- | `wong` | Orange, sky blue, green, blue, vermillion | Most widely recommended |
208
- | `ibm` | Ultramarine, indigo, magenta, orange, gold | IBM's accessible palette |
209
- | `tol` | 12-color extended palette | For many categories |
210
-
211
- ```bash
212
- # Wong's colorblind-safe palette
213
- python skills/infographics/scripts/generate_infographic.py \
214
- "Survey results by category" -o survey.png --type statistical --palette wong
215
- ```
216
-
217
- ---
218
-
219
- ## Smart Iterative Refinement and CLI
220
-
221
- The generate-review-refine loop, every command-line option, and configuration are in
222
- [references/iterative_refinement.md](references/iterative_refinement.md).
223
-
224
- ## Prompt Engineering Tips
225
-
226
- ### Be Specific About Content
227
-
228
- ✓ **Good prompts** (specific, detailed):
229
- ```
230
- "5 benefits of meditation: reduces stress, improves focus,
231
- better sleep, lower blood pressure, emotional balance"
232
- ```
233
-
234
- ✗ **Avoid vague prompts**:
235
- ```
236
- "meditation infographic"
237
- ```
238
-
239
- ### Include Data Points
240
-
241
- ✓ **Good**:
242
- ```
243
- "Market growth from $10B (2020) to $45B (2025), CAGR 35%"
244
- ```
245
-
246
- ✗ **Vague**:
247
- ```
248
- "market is growing"
249
- ```
250
-
251
- ### Specify Visual Elements
252
-
253
- ✓ **Good**:
254
- ```
255
- "Timeline showing 5 milestones with icons for each event"
256
- ```
257
-
258
- ---
259
-
260
- ## Reference Files
261
-
262
- For detailed guidance, load these reference files:
263
-
264
- - **`references/infographic_types.md`**: Extended templates for all 10+ types
265
- - **`references/design_principles.md`**: Visual hierarchy, layout, typography
266
- - **`references/color_palettes.md`**: Full palette specifications
267
-
268
- ---
269
-
270
- ## Troubleshooting
271
-
272
- ### Common Issues
273
-
274
- **Problem**: Text in infographic is unreadable
275
- - **Solution**: Reduce text content; use --type to specify layout type
276
-
277
- **Problem**: Colors clash or are inaccessible
278
- - **Solution**: Use `--palette wong` for colorblind-safe colors
279
-
280
- **Problem**: Quality score too low
281
- - **Solution**: Increase iterations with `--iterations 3`; use more specific prompt
282
-
283
- **Problem**: Wrong infographic type generated
284
- - **Solution**: Always specify `--type` flag for consistent results
285
-
286
- ---
287
-
288
- ## Integration with Other Skills
289
-
290
- This skill works synergistically with:
291
-
292
- - **scientific-schematics**: For technical diagrams and flowcharts
293
- - **market-research-reports**: Infographics for business reports
294
- - **scientific-slides**: Infographic elements for presentations
295
- - **generate-image**: For non-infographic visual content
296
-
297
- ---
298
-
299
- ## Quick Reference Checklist
300
-
301
- Before generating:
302
- - [ ] Clear, specific content description
303
- - [ ] Infographic type selected (`--type`)
304
- - [ ] Style appropriate for audience (`--style`)
305
- - [ ] Output path specified (`-o`)
306
- - [ ] API key configured
307
-
308
- After generating:
309
- - [ ] Review the generated image
310
- - [ ] Check the review log for scores
311
- - [ ] Regenerate with more specific prompt if needed
312
-
313
- ---
314
-
315
- Use this skill to create professional, accessible, and visually compelling infographics using the power of Nano Banana Pro AI with intelligent quality review.
@@ -1,352 +0,0 @@
1
- ---
2
- name: iso-standards-readiness
3
- description: Prepares and structurally reviews readiness evidence for ISO management-system and laboratory-competence standards - ISO 13485 medical device QMS, ISO 14971 device risk management, ISO/IEC 17025 testing and calibration laboratories, and ISO 15189 medical laboratories. Use when organizing declared scope, controlled documents, risk-management files, scope of accreditation, traceability, CAPA, external-provider controls, or bounded local evidence manifests, and when separating ISO certification from laboratory accreditation, FDA QMSR inspection, CLIA certification, MDSAP, and EU MDR/IVDR evidence boundaries. Not for legal applicability, compliance, certification, or accreditation decisions; contains no clause text.
4
- license: MIT
5
- compatibility: Python 3.11+; bundled CLIs use only the standard library and bounded local JSON/Markdown files, with no network access or credentials.
6
- allowed-tools: Read Write Bash Glob
7
- metadata:
8
- version: "1.0"
9
- skill-author: K-Dense Inc.
10
- supersedes: iso-13485-certification
11
- last-reviewed: "2026-07-26"
12
- ---
13
-
14
- # ISO Standards Readiness Evidence Preparation
15
-
16
- ## Purpose
17
-
18
- Use this skill to organize declared scope, controlled documents, implementation
19
- records, traceability, and readiness evidence for substantive human review against a
20
- named standard. It summarizes process workflows and provides deterministic local
21
- checks. It contains no clause text and performs no audit.
22
-
23
- This is a router. `SKILL.md` holds the boundary, the lane discipline, the shared
24
- workflow, and the CLI contract. Per-standard depth lives in `references/`.
25
-
26
- ## Non-negotiable boundary
27
-
28
- This skill cannot:
29
-
30
- - certify or accredit anything, issue or validate a certificate, accreditation
31
- schedule, or licence, or promise an audit, assessment, or inspection result;
32
- - determine legal/regulatory applicability, device classification, reportability,
33
- conformity route, product authorization, market access, licensure, personnel
34
- qualification, or compliance;
35
- - replace authorized management, the management representative, laboratory director,
36
- quality manager, authorized signatory, RA/QA, legal counsel, regulatory/competent
37
- authorities, a notified body, an MDSAP Auditing Organization, an accreditation body,
38
- an assessor, or a certification body;
39
- - validate a method, compute or approve measurement uncertainty, establish
40
- metrological traceability, set risk-acceptability criteria, or judge whether a risk,
41
- decision rule, or reference interval is fit for purpose; or
42
- - infer implementation, competence, conformity, compliance, or readiness from a
43
- template, checklist, filename, keyword, document count, percentage, or script
44
- result.
45
-
46
- Always label outputs **draft evidence-preparation material for authorized human
47
- review**. Preserve unresolved decisions as blockers rather than resolving them.
48
-
49
- ## ISO and IEC copyright
50
-
51
- ISO and IEC standards are copyrighted. Obtain each standard from
52
- [ISO](https://www.iso.org/standards.html), IEC, an ISO national member, or another
53
- authorized source. Do not retrieve, paste, reproduce, or generate clause text.
54
- Summarize the organization's own process and cite the controlled authorized copy. See
55
- [ISO copyright](https://www.iso.org/copyright.html). Accreditation-body, CAP, and
56
- scheme checklists that quote requirements are separately licensed — keep them out of
57
- shared repositories and prompts too.
58
-
59
- ## Standards covered
60
-
61
- Read the reference file for the standard in play **before** preparing evidence. Each
62
- one carries its own current edition, lane, domain vocabulary, and failure modes.
63
-
64
- | Standard | Profile key | Lane | Reference |
65
- | --- | --- | --- | --- |
66
- | ISO 13485 medical device QMS | `iso-13485` | Certification | `references/iso-13485.md` |
67
- | ISO 14971 device risk management | `iso-14971` | No lane of its own | `references/iso-14971.md` |
68
- | ISO/IEC 17025 testing and calibration laboratories | `iso-17025` | Accreditation | `references/iso-17025.md` |
69
- | ISO 15189 medical laboratories | `iso-15189` | Accreditation | `references/iso-15189.md` |
70
-
71
- A standard absent from this table is out of scope for the bundled checks. Do not
72
- repurpose a profile for a standard it does not name — a domain vocabulary borrowed from
73
- a different standard produces a report that looks complete and means nothing.
74
-
75
- ## Current baseline (read the ledger before any time-sensitive statement)
76
-
77
- - **ISO 13485:2016** Edition 3, confirmed after its 2025 systematic review.
78
- **EN ISO 13485:2016/A11:2021** is a European amendment, not an ISO international
79
- "Amendment 1:2021."
80
- - **ISO 14971:2019** Edition 3, confirmed in 2025, with **ISO/TR 24971:2020** as its
81
- informative guidance companion. There is no ISO 14971 certificate.
82
- - **ISO/IEC 17025:2017** Edition 3 remains current; no successor edition identified.
83
- - **ISO 15189:2022** Edition 4 replaced the 2012 edition, absorbed the POCT
84
- requirements formerly in ISO 22870, and its accreditation transition closed in
85
- **December 2025** — implemented, not upcoming.
86
- - **FDA QMSR** effective and enforced since **2026-02-02**; Part 820 is titled
87
- *Quality Management System Regulation*; QSIT is retired in favour of Compliance
88
- Program **7382.850**.
89
- - **MDSAP** current Audit Approach is **MDSAP AU P0002.010**, version date
90
- **2026-02-02**.
91
- - **Accreditation recognition:** Global Accreditation Cooperation Incorporated
92
- commenced full operations **2026-01-01**, replacing ILAC and IAF, with its own MRA;
93
- former IAF MLA / ILAC MRA outputs stay recognized during the transition.
94
- - **EU:** use current consolidated MDR/IVDR texts, current OJEU harmonised-standard
95
- decisions, current MDCG guidance, and the product-specific conformity route.
96
-
97
- Read `references/source-ledger.md` before making any time-sensitive statement. It
98
- records provenance limitations, including which entries still need confirmation against
99
- the ISO catalogue.
100
-
101
- ## Keep the assurance lanes separate
102
-
103
- Lane confusion, not missing documents, causes most substantive errors here.
104
- Certification, accreditation, regulator inspection, mandatory licensure, regulatory
105
- audit programmes, and product conformity assessment are decided by different bodies
106
- against different bases, and none substitutes for another. Two rules that are violated
107
- constantly:
108
-
109
- - Organizations are **certified**; laboratories are **accredited**. "ISO 17025
110
- certified" and "ISO 15189 certified" are category errors.
111
- - A certificate never displaces a regulator. ISO 13485 certification does not exempt
112
- anyone from FDA inspection, and ISO 15189 accreditation does not satisfy CLIA.
113
-
114
- Read `references/assurance-lanes.md` for the full lane table, scope-statement limits,
115
- and the titling rule.
116
-
117
- ## Core workflow
118
-
119
- ### Step 1: Declare the standard, purpose, and authorized owners
120
-
121
- Name the standard(s), the lane(s) the work supports, and the owners: management
122
- representative or laboratory director, quality owner, legal/applicability owner,
123
- process or technical owners, approvers, and escalation route. A lane is a declared
124
- input, never an inference.
125
-
126
- ```bash
127
- PYTHONDONTWRITEBYTECODE=1 python3 scripts/validate_scope_intake.py \
128
- assets/templates/scope-intake-template.json --standard iso-13485
129
- ```
130
-
131
- Use the matching template and profile:
132
-
133
- | Profile | Template |
134
- | --- | --- |
135
- | `iso-13485`, `iso-14971` | `assets/templates/scope-intake-template.json` |
136
- | `iso-17025` | `assets/templates/laboratory-scope-intake-template.json` |
137
- | `iso-15189` | `assets/templates/medical-laboratory-scope-intake-template.json` |
138
-
139
- `--standard` defaults to `iso-13485`. Every distributed template intentionally fails
140
- closed; copy it outside the skill and complete it with controlled organizational
141
- evidence. Undetermined applicability raises `HUMAN_DECISION_REQUIRED` — leave it as a
142
- blocker.
143
-
144
- ### Step 2: Freeze source/version evidence
145
-
146
- For every standard, regulation, guidance, scheme document, audit model, and product
147
- source, record publisher, official title, edition/version/date, authorized location,
148
- access and currency-review dates, scope/applicability owner, impact assessment, status,
149
- evidence, and approval.
150
-
151
- Do not use search snippets as controlled requirements. Do not silently update an
152
- incorporated edition when a publisher releases a new one — FDA incorporated a specific
153
- ISO 13485 edition, and a later ISO or EN publication does not change it.
154
-
155
- ### Step 3: Inventory controlled documents and records
156
-
157
- Do not count named procedures or scan keywords. Build an explicit register linking
158
- documents, records, source versions, owners, approvals, effective dates, retention
159
- bases, training, and change records.
160
-
161
- ```bash
162
- PYTHONDONTWRITEBYTECODE=1 python3 scripts/audit_document_records.py \
163
- assets/templates/document-register-template.json
164
- ```
165
-
166
- This check is standard-agnostic. Read `references/evidence-architecture.md` for the
167
- evidence architecture.
168
-
169
- ### Step 4: Review process implementation
170
-
171
- Assess controlled procedures **and sampled records** across the domains your profile
172
- declares — the per-standard reference file lists them. Each item needs owner, status,
173
- evidence IDs, source/version, approval, and open-gap links.
174
-
175
- A procedure describing an activity is not evidence the activity happened. Sample
176
- records in every domain you report on, and state what you sampled and what you did not.
177
-
178
- ### Step 5: Run the focused checks that apply to the lane
179
-
180
- Device lanes (`iso-13485`, `iso-14971`) — risk/design/production/post-market chain:
181
-
182
- ```bash
183
- PYTHONDONTWRITEBYTECODE=1 python3 scripts/check_traceability.py \
184
- assets/templates/traceability-matrix-template.json
185
- ```
186
-
187
- All standards — corrective action and effectiveness:
188
-
189
- ```bash
190
- PYTHONDONTWRITEBYTECODE=1 python3 scripts/check_capa.py \
191
- assets/templates/capa-record-template.json
192
- ```
193
-
194
- All standards — suppliers and externally provided products and services, including
195
- calibration providers, reference-material suppliers, and referral or subcontracted
196
- laboratories:
197
-
198
- ```bash
199
- PYTHONDONTWRITEBYTECODE=1 python3 scripts/check_supplier_controls.py \
200
- assets/templates/supplier-controls-template.json
201
- ```
202
-
203
- Pending or ineffective CAPA effectiveness evidence blocks closure. Critical supplier
204
- controls stay blocked until risk-based controls and approvals are evidenced.
205
-
206
- Note that `check_traceability.py` concerns design and risk traceability, **not**
207
- metrological traceability — the words collide and it is the wrong tool for laboratory
208
- work.
209
-
210
- ### Step 6: Address lane-specific regulator evidence separately
211
-
212
- For the US device lane only:
213
-
214
- ```bash
215
- PYTHONDONTWRITEBYTECODE=1 python3 scripts/check_qmsr_transition.py \
216
- assets/templates/qmsr-transition-template.json
217
- ```
218
-
219
- Review current Part 820/FDA source basis, supplemental provisions, obsolete QSR/QSIT
220
- references, pre-effective-date records, inspection-accessible management/quality/
221
- supplier-audit records, current inspection-process training, complaint and servicing
222
- records, labeling/packaging controls, supplier/software/change evidence, and prohibited
223
- certificate-equivalence claims. Do not build an old-820-to-ISO clause map as the
224
- current control framework.
225
-
226
- Laboratory lanes have no equivalent bundled check. CLIA, licensure, and national
227
- inspection evidence stays with the authorized compliance owner; see
228
- `references/iso-15189.md`.
229
-
230
- ### Step 7: Assemble a bounded readiness manifest
231
-
232
- Copy the evidence template outside the skill. Use relative paths to local `.json`,
233
- `.md`, or `.markdown` evidence only, and one declared lane purpose per manifest.
234
-
235
- ```bash
236
- PYTHONDONTWRITEBYTECODE=1 python3 scripts/validate_evidence_manifest.py \
237
- /path/to/evidence-manifest.json \
238
- --standard iso-17025 \
239
- --base-dir /path/to/controlled-export \
240
- --verify-files \
241
- --output /path/to/manifest-report.json
242
- ```
243
-
244
- Then generate a domain-level gap view against the same profile:
245
-
246
- ```bash
247
- PYTHONDONTWRITEBYTECODE=1 python3 scripts/gap_analyzer.py \
248
- /path/to/evidence-manifest.json \
249
- --standard iso-17025 \
250
- --base-dir /path/to/controlled-export \
251
- --verify-files \
252
- --output /path/to/gap-report.json
253
- ```
254
-
255
- The analyzer uses explicit manifest labels. It does not infer evidence from filenames,
256
- keywords, or proprietary standard text, and does not calculate a compliance score. A
257
- domain absent from `expected_domains` is reported `not-assessed`, which is **not** a
258
- not-applicable determination.
259
-
260
- Read `references/gap-analysis-checklist.md` for the fail-closed review questions.
261
-
262
- ### Step 8: Human review and controlled handoff
263
-
264
- Present:
265
-
266
- - declared standard, scope, assurance lane(s), and unresolved applicability decisions;
267
- - the exact source/version baseline;
268
- - evidence sampled and the limitations of that sample;
269
- - structural findings grouped by process and risk;
270
- - actions, change, and CAPA owners with dates;
271
- - approval state; and
272
- - the authorized party responsible for the next decision.
273
-
274
- Never title the result "certificate," "accreditation," "compliance report," "audit
275
- pass," "deemed status," or "ready for inspection." A suitable title is **Draft evidence
276
- review for authorized human assessment**, naming the lane it was prepared for.
277
-
278
- ## CLI behavior and safety
279
-
280
- All bundled CLIs:
281
-
282
- - use the Python standard library only;
283
- - perform no network requests;
284
- - accept bounded local JSON; optional evidence verification accepts only bounded local
285
- JSON/Markdown;
286
- - reject symbolic-link inputs, duplicate JSON keys, non-finite numbers, excessive
287
- size/nesting/items, and unsafe evidence paths;
288
- - refuse an unlisted `--standard` value rather than falling back to a default;
289
- - use no dynamic evaluation, executable deserialization, pickle, or shell execution;
290
- - refuse to overwrite reports unless `--force` is explicit; and
291
- - produce deterministic sorted JSON.
292
-
293
- Treat the manifest itself as a controlled organizational record. An optional SHA-256
294
- comparison detects a local file mismatch only; it does not establish provenance,
295
- authenticity, adequacy, or trust in a user-supplied manifest. Values in JSON
296
- `local_path` and `evidence.location` fields refer to the user's controlled export, not
297
- to bundled skill resources; unresolved placeholders must never be opened.
298
-
299
- Exit codes:
300
-
301
- - `0`: no structural finding for the supplied fields; **not a compliance, conformity,
302
- competence, or accreditation result**;
303
- - `1`: structural/evidence gaps found;
304
- - `2`: invalid or unsafe input/output, including an unlisted standard.
305
-
306
- Run `python3 scripts/<name>.py --help` for each interface.
307
-
308
- ## Templates
309
-
310
- Scope intake, per profile:
311
-
312
- - `assets/templates/scope-intake-template.json` — device lifecycle
313
- - `assets/templates/laboratory-scope-intake-template.json` — testing/calibration
314
- - `assets/templates/medical-laboratory-scope-intake-template.json` — examinations
315
-
316
- Shared registers and records:
317
-
318
- - `assets/templates/document-register-template.json`
319
- - `assets/templates/capa-record-template.json`
320
- - `assets/templates/traceability-matrix-template.json`
321
- - `assets/templates/supplier-controls-template.json`
322
- - `assets/templates/evidence-manifest-template.json`
323
- - `assets/templates/qmsr-transition-template.json` — US device lane only
324
-
325
- Management-system documentation:
326
-
327
- - `assets/templates/quality-manual-template.md`
328
- - `assets/templates/procedures/CAPA-procedure-template.md`
329
- - `assets/templates/procedures/document-control-procedure-template.md`
330
-
331
- Every template is deliberately `draft`/`pending`, uses placeholders, and includes
332
- owner/status/evidence/approval fields. Copy and control it; never edit a distributed
333
- template into a purported approved record.
334
-
335
- ## References
336
-
337
- Shared:
338
-
339
- - `references/assurance-lanes.md` — what each lane decides, and the titling rule
340
- - `references/source-ledger.md` — dated authoritative source baseline and provenance
341
- limitations
342
- - `references/evidence-architecture.md` — documentation and record architecture
343
- - `references/gap-analysis-checklist.md` — fail-closed evidence review questions
344
- - `references/quality-manual-guide.md` — controlled manual development
345
-
346
- Per standard:
347
-
348
- - `references/iso-13485.md` — device QMS process/evidence framework, QMSR, MDSAP, EU
349
- - `references/iso-14971.md` — risk-management chain and the missing-link failure modes
350
- - `references/iso-17025.md` — laboratory competence, traceability, uncertainty, and
351
- decision rules
352
- - `references/iso-15189.md` — medical laboratories, POCT, reporting, and the CLIA lane