pi-skill-search 0.1.0

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 (299) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/LICENSE +21 -0
  3. package/README.md +97 -0
  4. package/index.ts +163 -0
  5. package/package.json +48 -0
  6. package/skills/adaptyv/SKILL.md +92 -0
  7. package/skills/add-community-extension/SKILL.md +85 -0
  8. package/skills/aeon/SKILL.md +111 -0
  9. package/skills/ai-slop-cleaner/SKILL.md +118 -0
  10. package/skills/anndata/SKILL.md +83 -0
  11. package/skills/arboreto/SKILL.md +107 -0
  12. package/skills/ask/SKILL.md +55 -0
  13. package/skills/astropy/SKILL.md +30 -0
  14. package/skills/async-worker-recovery/SKILL.md +44 -0
  15. package/skills/autopilot/SKILL.md +63 -0
  16. package/skills/autoresearch/SKILL.md +64 -0
  17. package/skills/autoskill/SKILL.md +116 -0
  18. package/skills/babysit/SKILL.md +43 -0
  19. package/skills/benchling-integration/SKILL.md +106 -0
  20. package/skills/bgpt-paper-search/SKILL.md +67 -0
  21. package/skills/biopython/SKILL.md +29 -0
  22. package/skills/bioservices/SKILL.md +96 -0
  23. package/skills/brainstorming/SKILL.md +104 -0
  24. package/skills/cancel/SKILL.md +85 -0
  25. package/skills/ccg/SKILL.md +87 -0
  26. package/skills/celery-pipeline/SKILL.md +30 -0
  27. package/skills/cellxgene-census/SKILL.md +104 -0
  28. package/skills/child-pi-spawning/SKILL.md +85 -0
  29. package/skills/cirq/SKILL.md +113 -0
  30. package/skills/citation-management/SKILL.md +91 -0
  31. package/skills/clinical-decision-support/SKILL.md +117 -0
  32. package/skills/clinical-reports/SKILL.md +118 -0
  33. package/skills/clinical-trial/SKILL.md +28 -0
  34. package/skills/cobrapy/SKILL.md +116 -0
  35. package/skills/configure-notifications/SKILL.md +85 -0
  36. package/skills/consciousness-council/SKILL.md +120 -0
  37. package/skills/context-artifact-hygiene/SKILL.md +85 -0
  38. package/skills/context-mode-ops/SKILL.md +87 -0
  39. package/skills/dask/SKILL.md +85 -0
  40. package/skills/database-lookup/SKILL.md +118 -0
  41. package/skills/datamol/SKILL.md +108 -0
  42. package/skills/debug/SKILL.md +32 -0
  43. package/skills/deep-dive/SKILL.md +114 -0
  44. package/skills/deep-interview/SKILL.md +90 -0
  45. package/skills/deepchem/SKILL.md +117 -0
  46. package/skills/deepinit/SKILL.md +100 -0
  47. package/skills/deeptools/SKILL.md +118 -0
  48. package/skills/delegation-patterns/SKILL.md +56 -0
  49. package/skills/depmap/SKILL.md +94 -0
  50. package/skills/dhdna-profiler/SKILL.md +86 -0
  51. package/skills/diffdock/SKILL.md +101 -0
  52. package/skills/dispatching-parallel-agents/SKILL.md +119 -0
  53. package/skills/dnanexus-integration/SKILL.md +118 -0
  54. package/skills/do/SKILL.md +48 -0
  55. package/skills/docker-sandbox/SKILL.md +29 -0
  56. package/skills/docx/SKILL.md +119 -0
  57. package/skills/esm/SKILL.md +116 -0
  58. package/skills/etetoolkit/SKILL.md +103 -0
  59. package/skills/event-log-tracing/SKILL.md +85 -0
  60. package/skills/exa-search/SKILL.md +72 -0
  61. package/skills/executing-plans/SKILL.md +69 -0
  62. package/skills/exploratory-data-analysis/SKILL.md +118 -0
  63. package/skills/external-context/SKILL.md +80 -0
  64. package/skills/fastapi/SKILL.md +30 -0
  65. package/skills/finishing-a-development-branch/SKILL.md +106 -0
  66. package/skills/flowio/SKILL.md +114 -0
  67. package/skills/fluidsim/SKILL.md +108 -0
  68. package/skills/generate-image/SKILL.md +108 -0
  69. package/skills/geniml/SKILL.md +117 -0
  70. package/skills/geomaster/SKILL.md +109 -0
  71. package/skills/geopandas/SKILL.md +114 -0
  72. package/skills/get-available-resources/SKILL.md +100 -0
  73. package/skills/gget/SKILL.md +111 -0
  74. package/skills/ginkgo-cloud-lab/SKILL.md +52 -0
  75. package/skills/git-master/SKILL.md +85 -0
  76. package/skills/glycoengineering/SKILL.md +104 -0
  77. package/skills/gtars/SKILL.md +104 -0
  78. package/skills/hackernews-frontpage/SKILL.md +46 -0
  79. package/skills/histolab/SKILL.md +98 -0
  80. package/skills/how-it-works/SKILL.md +25 -0
  81. package/skills/hud/SKILL.md +86 -0
  82. package/skills/hugging-science/SKILL.md +93 -0
  83. package/skills/huggingface/SKILL.md +30 -0
  84. package/skills/hypogenic/SKILL.md +107 -0
  85. package/skills/hypothesis-generation/SKILL.md +118 -0
  86. package/skills/imaging-data-commons/SKILL.md +119 -0
  87. package/skills/infographics/SKILL.md +102 -0
  88. package/skills/iso-13485-certification/SKILL.md +114 -0
  89. package/skills/knowledge-agent/SKILL.md +83 -0
  90. package/skills/labarchive-integration/SKILL.md +98 -0
  91. package/skills/lamindb/SKILL.md +119 -0
  92. package/skills/landsat/SKILL.md +29 -0
  93. package/skills/latchbio-integration/SKILL.md +118 -0
  94. package/skills/latex-posters/SKILL.md +112 -0
  95. package/skills/learn-codebase/SKILL.md +24 -0
  96. package/skills/learner/SKILL.md +118 -0
  97. package/skills/literature-review/SKILL.md +118 -0
  98. package/skills/live-agent-lifecycle/SKILL.md +85 -0
  99. package/skills/mailbox-interactive/SKILL.md +85 -0
  100. package/skills/make-plan/SKILL.md +59 -0
  101. package/skills/markdown-mermaid-writing/SKILL.md +118 -0
  102. package/skills/market-research-reports/SKILL.md +119 -0
  103. package/skills/markitdown/SKILL.md +111 -0
  104. package/skills/markitdown-docs/SKILL.md +28 -0
  105. package/skills/matchms/SKILL.md +91 -0
  106. package/skills/matlab/SKILL.md +118 -0
  107. package/skills/matplotlib/SKILL.md +30 -0
  108. package/skills/mcp-setup/SKILL.md +84 -0
  109. package/skills/medchem/SKILL.md +109 -0
  110. package/skills/mem-search/SKILL.md +96 -0
  111. package/skills/modal/SKILL.md +104 -0
  112. package/skills/model-routing-context/SKILL.md +85 -0
  113. package/skills/molecular-dynamics/SKILL.md +116 -0
  114. package/skills/molfeat/SKILL.md +110 -0
  115. package/skills/multi-perspective-review/SKILL.md +85 -0
  116. package/skills/networkx/SKILL.md +111 -0
  117. package/skills/neurokit2/SKILL.md +114 -0
  118. package/skills/neuropixels-analysis/SKILL.md +112 -0
  119. package/skills/nilearn/SKILL.md +29 -0
  120. package/skills/observability-reliability/SKILL.md +43 -0
  121. package/skills/omc-doctor/SKILL.md +86 -0
  122. package/skills/omc-reference/SKILL.md +119 -0
  123. package/skills/omc-setup/SKILL.md +82 -0
  124. package/skills/omc-teams/SKILL.md +81 -0
  125. package/skills/omero-integration/SKILL.md +111 -0
  126. package/skills/open-notebook/SKILL.md +100 -0
  127. package/skills/openephys/SKILL.md +28 -0
  128. package/skills/opentrons-integration/SKILL.md +110 -0
  129. package/skills/optimize-for-gpu/SKILL.md +119 -0
  130. package/skills/orchestration/SKILL.md +85 -0
  131. package/skills/ownership-session-security/SKILL.md +43 -0
  132. package/skills/paper-lookup/SKILL.md +119 -0
  133. package/skills/paperzilla/SKILL.md +114 -0
  134. package/skills/parallel-web/SKILL.md +64 -0
  135. package/skills/pathfinder/SKILL.md +114 -0
  136. package/skills/pathml/SKILL.md +98 -0
  137. package/skills/pdf/SKILL.md +113 -0
  138. package/skills/peer-review/SKILL.md +119 -0
  139. package/skills/pennylane/SKILL.md +119 -0
  140. package/skills/phylogenetics/SKILL.md +102 -0
  141. package/skills/pi-extension-lifecycle/SKILL.md +41 -0
  142. package/skills/plan/SKILL.md +66 -0
  143. package/skills/polars/SKILL.md +114 -0
  144. package/skills/polars-bio/SKILL.md +84 -0
  145. package/skills/pptx/SKILL.md +118 -0
  146. package/skills/pptx-posters/SKILL.md +112 -0
  147. package/skills/primekg/SKILL.md +97 -0
  148. package/skills/project-session-manager/SKILL.md +85 -0
  149. package/skills/protocolsio-integration/SKILL.md +119 -0
  150. package/skills/pubmed-search/SKILL.md +29 -0
  151. package/skills/pufferlib/SKILL.md +103 -0
  152. package/skills/pydeseq2/SKILL.md +106 -0
  153. package/skills/pydicom/SKILL.md +115 -0
  154. package/skills/pyhealth/SKILL.md +117 -0
  155. package/skills/pylabrobot/SKILL.md +100 -0
  156. package/skills/pymatgen/SKILL.md +28 -0
  157. package/skills/pymc/SKILL.md +108 -0
  158. package/skills/pymoo/SKILL.md +90 -0
  159. package/skills/pyopenms/SKILL.md +119 -0
  160. package/skills/pysam/SKILL.md +118 -0
  161. package/skills/pyspark/SKILL.md +30 -0
  162. package/skills/pytdc/SKILL.md +102 -0
  163. package/skills/pytorch/SKILL.md +31 -0
  164. package/skills/pytorch-lightning/SKILL.md +119 -0
  165. package/skills/pyzotero/SKILL.md +104 -0
  166. package/skills/qiskit/SKILL.md +119 -0
  167. package/skills/qutip/SKILL.md +111 -0
  168. package/skills/ralph/SKILL.md +23 -0
  169. package/skills/ralplan/SKILL.md +105 -0
  170. package/skills/rdflib/SKILL.md +29 -0
  171. package/skills/rdkit/SKILL.md +30 -0
  172. package/skills/read-only-explorer/SKILL.md +85 -0
  173. package/skills/receiving-code-review/SKILL.md +103 -0
  174. package/skills/release/SKILL.md +117 -0
  175. package/skills/remember/SKILL.md +39 -0
  176. package/skills/requesting-code-review/SKILL.md +85 -0
  177. package/skills/requirements-to-task-packet/SKILL.md +65 -0
  178. package/skills/research-grants/SKILL.md +118 -0
  179. package/skills/research-lookup/SKILL.md +117 -0
  180. package/skills/research-reproducibility/SKILL.md +28 -0
  181. package/skills/resource-discovery-config/SKILL.md +43 -0
  182. package/skills/rowan/SKILL.md +100 -0
  183. package/skills/runtime-state-reader/SKILL.md +46 -0
  184. package/skills/safe-bash/SKILL.md +85 -0
  185. package/skills/scanpy/SKILL.md +32 -0
  186. package/skills/scholar-evaluation/SKILL.md +115 -0
  187. package/skills/scientific-brainstorming/SKILL.md +118 -0
  188. package/skills/scientific-critical-thinking/SKILL.md +119 -0
  189. package/skills/scientific-schematics/SKILL.md +116 -0
  190. package/skills/scientific-slides/SKILL.md +117 -0
  191. package/skills/scientific-visualization/SKILL.md +109 -0
  192. package/skills/scientific-writing/SKILL.md +119 -0
  193. package/skills/scikit-bio/SKILL.md +92 -0
  194. package/skills/scikit-learn/SKILL.md +99 -0
  195. package/skills/scikit-survival/SKILL.md +110 -0
  196. package/skills/sciomc/SKILL.md +86 -0
  197. package/skills/scvelo/SKILL.md +106 -0
  198. package/skills/scvi-tools/SKILL.md +114 -0
  199. package/skills/seaborn/SKILL.md +97 -0
  200. package/skills/secure-agent-orchestration-review/SKILL.md +47 -0
  201. package/skills/self-improve/SKILL.md +119 -0
  202. package/skills/semantic-compression/SKILL.md +62 -0
  203. package/skills/setup/SKILL.md +42 -0
  204. package/skills/shap/SKILL.md +103 -0
  205. package/skills/simpy/SKILL.md +116 -0
  206. package/skills/skill/SKILL.md +117 -0
  207. package/skills/skill-search/SKILL.md +67 -0
  208. package/skills/skillify/SKILL.md +46 -0
  209. package/skills/smart-explore/SKILL.md +94 -0
  210. package/skills/sqlite-pandas/SKILL.md +30 -0
  211. package/skills/stable-baselines3/SKILL.md +86 -0
  212. package/skills/state-mutation-locking/SKILL.md +44 -0
  213. package/skills/statistical-analysis/SKILL.md +108 -0
  214. package/skills/statsmodels/SKILL.md +29 -0
  215. package/skills/subagent-driven-development/SKILL.md +89 -0
  216. package/skills/sympy/SKILL.md +115 -0
  217. package/skills/system-prompts/SKILL.md +116 -0
  218. package/skills/systematic-debugging/SKILL.md +119 -0
  219. package/skills/team/SKILL.md +85 -0
  220. package/skills/test-driven-development/SKILL.md +84 -0
  221. package/skills/tiledbvcf/SKILL.md +119 -0
  222. package/skills/timeline-report/SKILL.md +85 -0
  223. package/skills/timesfm-forecasting/SKILL.md +112 -0
  224. package/skills/torch-geometric/SKILL.md +118 -0
  225. package/skills/torchdrug/SKILL.md +118 -0
  226. package/skills/trace/SKILL.md +118 -0
  227. package/skills/transformers/SKILL.md +110 -0
  228. package/skills/treatment-plans/SKILL.md +119 -0
  229. package/skills/ui-render-performance/SKILL.md +41 -0
  230. package/skills/ultragoal/SKILL.md +63 -0
  231. package/skills/ultraqa/SKILL.md +85 -0
  232. package/skills/ultrawork/SKILL.md +20 -0
  233. package/skills/umap-learn/SKILL.md +119 -0
  234. package/skills/usfiscaldata/SKILL.md +118 -0
  235. package/skills/using-git-worktrees/SKILL.md +112 -0
  236. package/skills/using-superpowers/SKILL.md +85 -0
  237. package/skills/using-vetc/SKILL.md +92 -0
  238. package/skills/vaex/SKILL.md +111 -0
  239. package/skills/venue-templates/SKILL.md +113 -0
  240. package/skills/verification-before-completion/SKILL.md +88 -0
  241. package/skills/verification-before-done/SKILL.md +68 -0
  242. package/skills/verify/SKILL.md +33 -0
  243. package/skills/version-bump/SKILL.md +54 -0
  244. package/skills/vetc-analyze-ba/SKILL.md +117 -0
  245. package/skills/vetc-analyze-codebase/SKILL.md +118 -0
  246. package/skills/vetc-api-design/SKILL.md +103 -0
  247. package/skills/vetc-brainstorming/SKILL.md +116 -0
  248. package/skills/vetc-change-proposal/SKILL.md +111 -0
  249. package/skills/vetc-cicd/SKILL.md +113 -0
  250. package/skills/vetc-continuous-learning/SKILL.md +115 -0
  251. package/skills/vetc-deep-interview/SKILL.md +103 -0
  252. package/skills/vetc-docgen/SKILL.md +108 -0
  253. package/skills/vetc-frontend-patterns/SKILL.md +99 -0
  254. package/skills/vetc-iterative-retrieval/SKILL.md +110 -0
  255. package/skills/vetc-java-patterns/SKILL.md +113 -0
  256. package/skills/vetc-meta-skill-creator/SKILL.md +99 -0
  257. package/skills/vetc-oracle-patterns/SKILL.md +109 -0
  258. package/skills/vetc-performance-testing/SKILL.md +104 -0
  259. package/skills/vetc-pr-response/SKILL.md +106 -0
  260. package/skills/vetc-ralph/SKILL.md +108 -0
  261. package/skills/vetc-ralplan/SKILL.md +116 -0
  262. package/skills/vetc-receiving-review/SKILL.md +106 -0
  263. package/skills/vetc-reconcile-patterns/SKILL.md +117 -0
  264. package/skills/vetc-refactoring/SKILL.md +96 -0
  265. package/skills/vetc-runbook/SKILL.md +118 -0
  266. package/skills/vetc-sast/SKILL.md +118 -0
  267. package/skills/vetc-sdlc/SKILL.md +97 -0
  268. package/skills/vetc-security/SKILL.md +117 -0
  269. package/skills/vetc-spec-driven/SKILL.md +111 -0
  270. package/skills/vetc-spec-quality/SKILL.md +117 -0
  271. package/skills/vetc-systematic-debugging/SKILL.md +74 -0
  272. package/skills/vetc-tdd/SKILL.md +96 -0
  273. package/skills/vetc-thinking-pm/SKILL.md +110 -0
  274. package/skills/vetc-ui-visual-qa/SKILL.md +117 -0
  275. package/skills/vetc-verify/SKILL.md +101 -0
  276. package/skills/visual-verdict/SKILL.md +59 -0
  277. package/skills/what-if-oracle/SKILL.md +87 -0
  278. package/skills/widget-rendering/SKILL.md +85 -0
  279. package/skills/wiki/SKILL.md +69 -0
  280. package/skills/workspace-isolation/SKILL.md +85 -0
  281. package/skills/worktree-isolation/SKILL.md +85 -0
  282. package/skills/wowerpoint/SKILL.md +101 -0
  283. package/skills/writer-memory/SKILL.md +82 -0
  284. package/skills/writing-plans/SKILL.md +115 -0
  285. package/skills/writing-skills/SKILL.md +115 -0
  286. package/skills/xgboost/SKILL.md +29 -0
  287. package/skills/xgboost-ts/SKILL.md +28 -0
  288. package/skills/xlsx/SKILL.md +111 -0
  289. package/skills/zarr-python/SKILL.md +101 -0
  290. package/src/categories.ts +383 -0
  291. package/src/format.ts +104 -0
  292. package/src/indexer.ts +101 -0
  293. package/src/proactive.ts +51 -0
  294. package/src/scanner.ts +85 -0
  295. package/src/search.ts +89 -0
  296. package/src/strip.ts +29 -0
  297. package/src/synonyms.ts +83 -0
  298. package/src/text.ts +118 -0
  299. package/src/types.ts +64 -0
@@ -0,0 +1,87 @@
1
+ ---
2
+ name: ccg
3
+ description: Claude-Codex-Gemini tri-model orchestration via /ask codex + /ask gemini, then Claude synthesizes results
4
+ ---
5
+
6
+
7
+ # CCG - Claude-Codex-Gemini Tri-Model Orchestration
8
+
9
+ CCG routes through the canonical `/ask` skill (`/ask codex` + `/ask gemini`), then Claude synthesizes both outputs into one answer.
10
+
11
+ Use this when you want parallel external perspectives without launching tmux team workers.
12
+
13
+ ## When to Use
14
+
15
+ - Backend/analysis + frontend/UI work in one request
16
+ - Code review from multiple perspectives (architecture + design/UX)
17
+ - Cross-validation where Codex and Gemini may disagree
18
+ - Fast advisor-style parallel input without team runtime orchestration
19
+
20
+ ## Requirements
21
+
22
+ - **Codex CLI**: `npm install -g @openai/codex` (or `@openai/codex`)
23
+ - **Gemini CLI**: `npm install -g @google/gemini-cli`
24
+ - `omc ask` command available
25
+ - If either CLI is unavailable, continue with whichever provider is available and note the limitation
26
+
27
+ ## How It Works
28
+
29
+ ```text
30
+ 1. Claude decomposes the request into two advisor prompts:
31
+ - Codex prompt (analysis/architecture/backend)
32
+ - Gemini prompt (UX/design/docs/alternatives)
33
+
34
+ 2. Claude runs via CLI (skill nesting not supported):
35
+ - `omc ask codex "<codex prompt>"`
36
+ - `omc ask gemini "<gemini prompt>"`
37
+
38
+ 3. Artifacts are written under `.omc/artifacts/ask/`
39
+
40
+ 4. Claude synthesizes both outputs into one final response
41
+ ```
42
+
43
+ ## Execution Protocol
44
+
45
+ When invoked, Claude MUST follow this workflow:
46
+
47
+ ### 1. Decompose Request
48
+ Split the user request into:
49
+
50
+ - **Codex prompt:** architecture, correctness, backend, risks, test strategy
51
+ - **Gemini prompt:** UX/content clarity, alternatives, edge-case usability, docs polish
52
+ - **Synthesis plan:** how to reconcile conflicts
53
+
54
+ ### 2. Invoke advisors via CLI
55
+
56
+ > **Note:** Skill nesting (invoking a skill from within an active skill) is not supported in Claude Code. Always use the direct CLI path via Bash tool.
57
+
58
+ Run both advisors:
59
+
60
+ ```bash
61
+ omc ask codex "<codex prompt>"
62
+ omc ask gemini "<gemini prompt>"
63
+ ```
64
+
65
+ ### 3. Collect artifacts
66
+
67
+ Read latest ask artifacts from:
68
+
69
+ ```text
70
+ .omc/artifacts/ask/codex-*.md
71
+ .omc/artifacts/ask/gemini-*.md
72
+ ```
73
+
74
+ ### 4. Synthesize
75
+
76
+ Return one unified answer with:
77
+
78
+ - Agreed recommendations
79
+ - Conflicting recommendations (explicitly called out)
80
+ - Chosen final direction + rationale
81
+ - Action checklist
82
+
83
+ ## Fallbacks
84
+
85
+ If one provider is unavailable:
86
+
87
+
@@ -0,0 +1,30 @@
1
+ ---
2
+ name: celery-pipeline
3
+ description: Distributed task queue, data pipeline orchestration, and workflow automation. Use when setting up asynchronous task processing, job scheduling, or distributed computing with Celery, Redis, or RabbitMQ. Trigger on imports of celery, or mentions of task queue, background job, pipeline, distributed computing, workflow automat.
4
+ ---
5
+ # celery-pipeline
6
+
7
+ Use this skill for distributed task processing and pipeline orchestration.
8
+
9
+ ## Core patterns
10
+
11
+ - **Task**: `@app.task(bind=True)` → `self.request.id` for tracking.
12
+ - **Chain**: `chain(task1.s(), task2.s(), task3.s())()` for sequential pipeline.
13
+ - **Group**: `group(process.s(item) for item in items)()` for parallel execution.
14
+ - **Chord**: `chord(group(tasks), callback.s())()` for map-reduce pattern.
15
+ - **Monitoring**: `flower --broker=redis://localhost` for web dashboard.
16
+
17
+ ## Rules
18
+
19
+ - Always set `time_limit` and `soft_time_limit` on tasks.
20
+ - Use `acks_late=True` for idempotent tasks to prevent message loss.
21
+ - Store results in backend (`result_backend='redis://'`) only when needed.
22
+ - Use `task.retry()` for transient failures, not permanent ones.
23
+
24
+ ## Anti-patterns
25
+
26
+ - Don't pass large objects as arguments — use storage references (S3 path, DB ID).
27
+ - Don't create circular task dependencies — detect and break cycles.
28
+ - Don't ignore `WorkerLostError` — it means OOM or segfault, not normal failure.
29
+
30
+
@@ -0,0 +1,104 @@
1
+ ---
2
+ name: cellxgene-census
3
+ description: Query the CELLxGENE Census (61M+ cells) programmatically. Use when you need expression data across tissues, diseases, or cell types from the largest curated single-cell atlas. Best for population-scale queries, reference atlas comparisons. For analyzing your own data use scanpy or scvi-tools.
4
+ ---
5
+
6
+ # CZ CELLxGENE Census
7
+
8
+ ## Overview
9
+
10
+ The CZ CELLxGENE Census provides programmatic access to a comprehensive, versioned collection of standardized single-cell genomics data from CZ CELLxGENE Discover. This skill enables efficient querying and analysis of millions of cells across thousands of datasets.
11
+
12
+ The Census includes:
13
+ - **61+ million cells** from human and mouse
14
+ - **Standardized metadata** (cell types, tissues, diseases, donors)
15
+ - **Raw gene expression** matrices
16
+ - **Pre-calculated embeddings** and statistics
17
+ - **Integration with PyTorch, scanpy, and other analysis tools**
18
+
19
+ ## When to Use This Skill
20
+
21
+ This skill should be used when:
22
+ - Querying single-cell expression data by cell type, tissue, or disease
23
+ - Exploring available single-cell datasets and metadata
24
+ - Training machine learning models on single-cell data
25
+ - Performing large-scale cross-dataset analyses
26
+ - Integrating Census data with scanpy or other analysis frameworks
27
+ - Computing statistics across millions of cells
28
+ - Accessing pre-calculated embeddings or model predictions
29
+
30
+ ## Core Workflow Patterns
31
+
32
+ ### 1. Opening the Census
33
+
34
+ Always use the context manager to ensure proper resource cleanup:
35
+
36
+ ```python
37
+ import cellxgene_census
38
+
39
+ # Open latest stable version
40
+ with cellxgene_census.open_soma() as census:
41
+ # Work with census data
42
+
43
+ # Open specific version for reproducibility
44
+ with cellxgene_census.open_soma(census_version="2023-07-25") as census:
45
+ # Work with census data
46
+ ```
47
+
48
+ **Key points:**
49
+ - Use context manager (`with` statement) for automatic cleanup
50
+ - Specify `census_version` for reproducible analyses
51
+ - Default opens latest "stable" release
52
+
53
+ # Get summary statistics
54
+ summary = census["census_info"]["summary"].read().concat().to_pandas()
55
+ print(f"Total cells: {summary['total_cell_count'][0]}")
56
+
57
+ # Get all datasets
58
+ datasets = census["census_info"]["datasets"].read().concat().to_pandas()
59
+
60
+ # Filter datasets by criteria
61
+ covid_datasets = datasets[datasets["disease"].str.contains("COVID", na=False)]
62
+ ```
63
+
64
+ **Query cell metadata to understand available data:**
65
+ ```python
66
+ # Get unique cell types in a tissue
67
+ cell_metadata = cellxgene_census.get_obs(
68
+ census,
69
+ "homo_sapiens",
70
+ value_filter="tissue_general == 'brain' and is_primary_data == True",
71
+ column_names=["cell_type"]
72
+ )
73
+ unique_cell_types = cell_metadata["cell_type"].unique()
74
+ print(f"Found {len(unique_cell_types)} cell types in brain")
75
+
76
+ # Count cells by tissue
77
+ tissue_counts = cell_metadata.groupby("tissue_general").size()
78
+ ```
79
+
80
+ **Important:** Always filter for `is_primary_data == True` to avoid counting duplicate cells unless specifically analyzing duplicates.
81
+
82
+ ### 3. Querying Expression Data (Small to Medium Scale)
83
+
84
+ For queries returning < 100k cells that fit in memory, use `get_anndata()`:
85
+
86
+ ```python
87
+ # Basic query with cell type and tissue filters
88
+ adata = cellxgene_census.get_anndata(
89
+ census=census,
90
+ organism="Homo sapiens", # or "Mus musculus"
91
+ obs_value_filter="cell_type == 'B cell' and tissue_general == 'lung' and is_primary_data == True",
92
+ obs_column_names=["assay", "disease", "sex", "donor_id"],
93
+ )
94
+
95
+ # Query specific genes with multiple filters
96
+ adata = cellxgene_census.get_anndata(
97
+ census=census,
98
+ organism="Homo sapiens",
99
+ var_value_filter="feature_name in ['CD4', 'CD8A', 'CD19', 'FOXP3']",
100
+ obs_value_filter="cell_type == 'T cell' and disease == 'COVID-19' and is_primary_data == True",
101
+ obs_column_names=["cell_type", "tissue_general", "donor_id"],
102
+ )
103
+
104
+
@@ -0,0 +1,85 @@
1
+ ---
2
+ name: child-pi-spawning
3
+ description: Child Pi worker spawning, lifecycle callbacks, and failure modes. Use when debugging worker crashes, scaffold mode behavior, or spawn-time failures.
4
+ ---
5
+
6
+
7
+ # child-pi-spawning
8
+
9
+ Child Pi workers are subprocesses spawned by `task-runner.ts` via `runChildPi()` in `child-pi.ts`. Understanding the spawn flow, lifecycle events, and failure modes is essential for debugging worker crashes and "worker blinks" issues.
10
+
11
+ ## Spawn Flow
12
+
13
+ ```
14
+ task-runner.ts (runTeamTask)
15
+ → runChildPi({ cwd, task, agent, model, skillPaths, signal, onLifecycleEvent })
16
+ → child-pi.ts (runChildPi main function)
17
+ → buildPiWorkerArgs() → getPiSpawnCommand() → spawn(command, args, options)
18
+ → ChildProcess spawned
19
+ → activeChildProcesses.set(pid, child)
20
+ → input.onLifecycleEvent({ type: "spawned", pid, ts })
21
+ → stdout.on("data") → ChildPiLineObserver
22
+ → stderr.on("data")
23
+ → child.on("error") → onLifecycleEvent("spawn_error")
24
+ → child.on("exit") → onLifecycleEvent("exit")
25
+ → child.on("close") → onLifecycleEvent("close"), settle(result)
26
+ ```
27
+
28
+ ### Key components
29
+
30
+ - **ChildPiLineObserver**: Parses JSON events and stdout lines from child Pi's output stream
31
+ - **Response timeout**: 5-minute timer resets on every stdout/stderr chunk; on timeout → SIGTERM
32
+ - **Final drain**: After last assistant event, waits `finalDrainMs` (default 2s) then SIGTERM
33
+ - **Hard kill**: After `hardKillMs` (default 2s) from SIGTERM, SIGKILL
34
+ - **Active process tracking**: `activeChildProcesses` Map for global cleanup
35
+
36
+ ## Lifecycle Events
37
+
38
+ `ChildPiLifecycleEvent` interface — emitted via `onLifecycleEvent` callback:
39
+
40
+ ```typescript
41
+ interface ChildPiLifecycleEvent {
42
+ type: "spawned" | "spawn_error" | "response_timeout" | "final_drain" | "hard_kill" | "exit" | "close";
43
+ pid?: number;
44
+ exitCode?: number | null;
45
+ error?: string;
46
+ ts: string;
47
+ }
48
+ ```
49
+
50
+ ### Event sequence for normal completion:
51
+
52
+ ```
53
+ 1. spawned pid=12345 ← child.pid assigned
54
+ 2. [stdout events: message, tool_execution_start, tool_execution_end, message_end...]
55
+ 3. final_drain pid=12345 ← last assistant event received, SIGTERM sent
56
+ 4. exit exitCode=0 ← process exited
57
+ 5. close exitCode=0 ← stdio fully closed
58
+ ```
59
+
60
+ ### Event sequence for crash:
61
+
62
+ ```
63
+ 1. spawned pid=12345
64
+ 2. spawn_error error="..." ← OR →
65
+ 3. exit exitCode=1
66
+ 4. close exitCode=1
67
+ ```
68
+
69
+ ### Event sequence for timeout:
70
+
71
+ ```
72
+ 1. spawned pid=12345
73
+ 2. [no stdout for 5 min]
74
+ 3. response_timeout error="No output for 300000ms"
75
+ 4. final_drain pid=12345
76
+ 5. hard_kill pid=12345 ← SIGKILL after hardKillMs
77
+ 6. exit exitCode=null
78
+ 7. close exitCode=null
79
+ ```
80
+
81
+ ## onLifecycleEvent Callback Pattern
82
+
83
+ The callback bridges child-pi events → events.jsonl:
84
+
85
+ ```typescript
@@ -0,0 +1,113 @@
1
+ ---
2
+ name: cirq
3
+ description: Google quantum computing framework. Use when targeting Google Quantum AI hardware, designing noise-aware circuits, or running quantum characterization experiments. Best for Google hardware, noise modeling, and low-level circuit design. For IBM hardware use qiskit; for quantum ML with autodiff use pennylane; for physics simulations use qutip.
4
+ ---
5
+
6
+ # Cirq - Quantum Computing with Python
7
+
8
+ Cirq is Google Quantum AI's open-source framework for designing, simulating, and running quantum circuits on quantum computers and simulators.
9
+
10
+ # Google Quantum Engine
11
+ uv pip install cirq-google
12
+
13
+ # IonQ
14
+ uv pip install cirq-ionq
15
+
16
+ # AQT (Alpine Quantum Technologies)
17
+ uv pip install cirq-aqt
18
+
19
+ # Pasqal
20
+ uv pip install cirq-pasqal
21
+
22
+ # Azure Quantum
23
+ uv pip install azure-quantum cirq
24
+ ```
25
+
26
+ ## Quick Start
27
+
28
+ ### Basic Circuit
29
+
30
+ ```python
31
+ import cirq
32
+ import numpy as np
33
+
34
+ # Create qubits
35
+ q0, q1 = cirq.LineQubit.range(2)
36
+
37
+ # Build circuit
38
+ circuit = cirq.Circuit(
39
+ cirq.H(q0), # Hadamard on q0
40
+ cirq.CNOT(q0, q1), # CNOT with q0 control, q1 target
41
+ cirq.measure(q0, q1, key='result')
42
+ )
43
+
44
+ print(circuit)
45
+
46
+ # Simulate
47
+ simulator = cirq.Simulator()
48
+ result = simulator.run(circuit, repetitions=1000)
49
+
50
+ # Display results
51
+ print(result.histogram(key='result'))
52
+ ```
53
+
54
+ ### Parameterized Circuit
55
+
56
+ ```python
57
+ import sympy
58
+
59
+ # Define symbolic parameter
60
+ theta = sympy.Symbol('theta')
61
+
62
+ # Create parameterized circuit
63
+ circuit = cirq.Circuit(
64
+ cirq.ry(theta)(q0),
65
+ cirq.measure(q0, key='m')
66
+ )
67
+
68
+ # Sweep over parameter values
69
+ sweep = cirq.Linspace('theta', start=0, stop=2*np.pi, length=20)
70
+ results = simulator.run_sweep(circuit, params=sweep, repetitions=1000)
71
+
72
+ # Process results
73
+ for params, result in zip(sweep, results):
74
+ theta_val = params['theta']
75
+ counts = result.histogram(key='m')
76
+ print(f"θ={theta_val:.2f}: {counts}")
77
+
78
+ ## Core Capabilities
79
+
80
+ ### Circuit Building
81
+ For comprehensive information about building quantum circuits, including qubits, gates, operations, custom gates, and circuit patterns, see:
82
+ - **(see docs) - Complete guide to circuit construction
83
+
84
+ Common topics:
85
+ - Qubit types (GridQubit, LineQubit, NamedQubit)
86
+ - Single and two-qubit gates
87
+ - Parameterized gates and operations
88
+ - Custom gate decomposition
89
+ - Circuit organization with moments
90
+ - Standard circuit patterns (Bell states, GHZ, QFT)
91
+ - Import/export (OpenQASM, JSON)
92
+ - Working with qudits and observables
93
+
94
+ ### Simulation
95
+ For detailed information about simulating quantum circuits, including exact simulation, noisy simulation, parameter sweeps, and the Quantum Virtual Machine, see:
96
+ - **(see docs) - Complete guide to quantum simulation
97
+
98
+ Common topics:
99
+ - Exact simulation (state vector, density matrix)
100
+ - Sampling and measurements
101
+ - Parameter sweeps (single and multiple parameters)
102
+ - Noisy simulation
103
+ - State histograms and visualization
104
+ - Quantum Virtual Machine (QVM)
105
+ - Expectation values and observables
106
+ - Performance optimization
107
+
108
+ ### Hardware Integration
109
+ For information about running circuits on real quantum hardware from various providers, see:
110
+ - **(see docs) - Complete guide to hardware integration
111
+
112
+ Supported providers:
113
+
@@ -0,0 +1,91 @@
1
+ ---
2
+ name: citation-management
3
+ description: Comprehensive citation management for academic research. Search Google Scholar and PubMed for papers, extract accurate metadata, validate citations, and generate properly formatted BibTeX entries. This skill should be used when you need to find papers, verify citation information, convert DOIs to BibTeX, or ensure reference accuracy in scientific writing.
4
+ ---
5
+
6
+ # Citation Management
7
+
8
+ ## Overview
9
+
10
+ Manage citations systematically throughout the research and writing process. This skill provides tools and strategies for searching academic databases (Google Scholar, PubMed), extracting accurate metadata from multiple sources (CrossRef, PubMed, arXiv), validating citation information, and generating properly formatted BibTeX entries.
11
+
12
+ Critical for maintaining citation accuracy, avoiding reference errors, and ensuring reproducible research. Integrates seamlessly with the literature-review skill for comprehensive research workflows.
13
+
14
+ ## When to Use This Skill
15
+
16
+ Use this skill when:
17
+ - Searching for specific papers on Google Scholar or PubMed
18
+ - Converting DOIs, PMIDs, or arXiv IDs to properly formatted BibTeX
19
+ - Extracting complete metadata for citations (authors, title, journal, year, etc.)
20
+ - Validating existing citations for accuracy
21
+ - Cleaning and formatting BibTeX files
22
+ - Finding highly cited papers in a specific field
23
+ - Verifying that citation information matches the actual publication
24
+ - Building a bibliography for a manuscript or thesis
25
+ - Checking for duplicate citations
26
+ - Ensuring consistent citation formatting
27
+
28
+ ## Visual Enhancement with Scientific Schematics
29
+
30
+ **When creating documents with this skill, always consider adding scientific diagrams and schematics to enhance visual communication.**
31
+
32
+ If your document does not already contain schematics or diagrams:
33
+ - Use the **scientific-schematics** skill to generate AI-powered publication-quality diagrams
34
+ - Simply describe your desired diagram in natural language
35
+ - Nano Banana Pro will automatically generate, review, and refine the schematic
36
+
37
+ **For new documents:** Scientific schematics should be generated by default to visually represent key concepts, workflows, architectures, or relationships described in the text.
38
+
39
+ **How to generate schematics:**
40
+ ```bash
41
+ python scripts/generate_schematic.py "your diagram description" -o figures/output.png
42
+ ```
43
+
44
+ ## Core Workflow
45
+
46
+ Citation management follows a systematic process:
47
+
48
+ ### Phase 1: Paper Discovery and Search
49
+
50
+ **Goal**: Find relevant papers using academic search engines.
51
+
52
+ #### Google Scholar Search
53
+
54
+ Google Scholar provides the most comprehensive coverage across disciplines.
55
+
56
+ **Basic Search**:
57
+ ```bash
58
+ # Search for papers on a topic
59
+ python scripts/search_google_scholar.py "CRISPR gene editing" \
60
+ --limit 50 \
61
+ --output results.json
62
+
63
+ # Search with year filter
64
+ python scripts/search_google_scholar.py "machine learning protein folding" \
65
+ --year-start 2020 \
66
+ --year-end 2024 \
67
+ --limit 100 \
68
+ --output ml_proteins.json
69
+ ```
70
+
71
+ **Advanced Search Strategies** (see `(see docs)`):
72
+ - Use quotation marks for exact phrases: `"deep learning"`
73
+ - Search by author: `author:LeCun`
74
+ - Search in title: `intitle:"neural networks"`
75
+ - Exclude terms: `machine learning -survey`
76
+ - Find highly cited papers using sort options
77
+ - Filter by date ranges to get recent work
78
+
79
+ # Search PubMed
80
+ python scripts/search_pubmed.py "Alzheimer's disease treatment" \
81
+ --limit 100 \
82
+ --output alzheimers.json
83
+
84
+ # Search with MeSH terms and filters
85
+ python scripts/search_pubmed.py \
86
+ --query '"Alzheimer Disease"[MeSH] AND "Drug Therapy"[MeSH]' \
87
+ --date-start 2020 \
88
+ --date-end 2024 \
89
+ --publication-types "Clinical Trial,Review" \
90
+
91
+
@@ -0,0 +1,117 @@
1
+ ---
2
+ name: clinical-decision-support
3
+ description: Generate professional clinical decision support (CDS) documents for pharmaceutical and clinical research settings, including patient cohort analyses (biomarker-stratified with outcomes) and treatment recommendation reports (evidence-based guidelines with decision algorithms). Supports GRADE evidence grading, statistical analysis (hazard ratios, survival curves, waterfall plots), biomarker integration, and regulatory compliance. Outputs publication-ready LaTeX/PDF format optimized for drug development, clinical research, and evidence synthesis.
4
+ ---
5
+
6
+ # Clinical Decision Support Documents
7
+
8
+ ## Description
9
+
10
+ Generate professional clinical decision support (CDS) documents for pharmaceutical companies, clinical researchers, and medical decision-makers. This skill specializes in analytical, evidence-based documents that inform treatment strategies and drug development:
11
+
12
+ 1. **Patient Cohort Analysis** - Biomarker-stratified group analyses with statistical outcome comparisons
13
+ 2. **Treatment Recommendation Reports** - Evidence-based clinical guidelines with GRADE grading and decision algorithms
14
+
15
+ All documents are generated as publication-ready LaTeX/PDF files optimized for pharmaceutical research, regulatory submissions, and clinical guideline development.
16
+
17
+ **Note:** For individual patient treatment plans at the bedside, use the `treatment-plans` skill instead. This skill focuses on group-level analyses and evidence synthesis for pharmaceutical/research settings.
18
+
19
+ **Writing Style:** For publication-ready documents targeting medical journals, consult the **venue-templates** skill's `medical_journal_styles.md` for guidance on structured abstracts, evidence language, and CONSORT/STROBE compliance.
20
+
21
+ ## Capabilities
22
+
23
+ ### Document Types
24
+
25
+ **Patient Cohort Analysis**
26
+ - Biomarker-based patient stratification (molecular subtypes, gene expression, IHC)
27
+ - Molecular subtype classification (e.g., GBM mesenchymal-immune-active vs proneural, breast cancer subtypes)
28
+ - Outcome metrics with statistical analysis (OS, PFS, ORR, DOR, DCR)
29
+ - Statistical comparisons between subgroups (hazard ratios, p-values, 95% CI)
30
+ - Survival analysis with Kaplan-Meier curves and log-rank tests
31
+ - Efficacy tables and waterfall plots
32
+ - Comparative effectiveness analyses
33
+ - Pharmaceutical cohort reporting (trial subgroups, real-world evidence)
34
+
35
+ **Treatment Recommendation Reports**
36
+ - Evidence-based treatment guidelines for specific disease states
37
+ - Strength of recommendation grading (GRADE system: 1A, 1B, 2A, 2B, 2C)
38
+
39
+ ### Clinical Features
40
+
41
+ - **Biomarker Integration**: Genomic alterations (mutations, CNV, fusions), gene expression signatures, IHC markers, PD-L1 scoring
42
+ - **Statistical Analysis**: Hazard ratios, p-values, confidence intervals, survival curves, Cox regression, log-rank tests
43
+ - **Evidence Grading**: GRADE system (1A/1B/2A/2B/2C), Oxford CEBM levels, quality of evidence assessment
44
+ - **Clinical Terminology**: SNOMED-CT, LOINC, proper medical nomenclature, trial nomenclature
45
+ - **Regulatory Compliance**: HIPAA de-identification, confidentiality headers, ICH-GCP alignment
46
+ - **Professional Formatting**: Compact 0.5in margins, color-coded recommendations, publication-ready, suitable for regulatory submissions
47
+
48
+ ## Pharmaceutical and Research Use Cases
49
+
50
+ This skill is specifically designed for pharmaceutical and clinical research applications:
51
+
52
+ **Drug Development**
53
+ - **Phase 2/3 Trial Analyses**: Biomarker-stratified efficacy and safety analyses
54
+ - **Subgroup Analyses**: Forest plots showing treatment effects across patient subgroups
55
+ - **Companion Diagnostic Development**: Linking biomarkers to drug response
56
+ - **Regulatory Submissions**: IND/NDA documentation with evidence summaries
57
+
58
+ **Medical Affairs**
59
+ - **KOL Education Materials**: Evidence-based treatment algorithms for thought leaders
60
+ - **Medical Strategy Documents**: Competitive landscape and positioning strategies
61
+ - **Advisory Board Materials**: Cohort analyses and treatment recommendation frameworks
62
+ - **Publication Planning**: Manuscript-ready analyses for peer-reviewed journals
63
+
64
+ ## When to Use
65
+
66
+ Use this skill when you need to:
67
+
68
+ - **Analyze patient cohorts** stratified by biomarkers, molecular subtypes, or clinical characteristics
69
+ - **Generate treatment recommendation reports** with evidence grading for clinical guidelines or pharmaceutical strategies
70
+ - **Compare outcomes** between patient subgroups with statistical analysis (survival, response rates, hazard ratios)
71
+ - **Produce pharmaceutical research documents** for drug development, clinical trials, or regulatory submissions
72
+ - **Develop clinical practice guidelines** with GRADE evidence grading and decision algorithms
73
+ - **Document biomarker-guided therapy selection** at the population level (not individual patients)
74
+ - **Synthesize evidence** from multiple trials or real-world data sources
75
+ - **Create clinical decision algorithms** with flowcharts for treatment sequencing
76
+
77
+ **Do NOT use this skill for:**
78
+ - Individual patient treatment plans (use `treatment-plans` skill)
79
+ - Bedside clinical care documentation (use `treatment-plans` skill)
80
+ - Simple patient-specific treatment protocols (use `treatment-plans` skill)
81
+
82
+ ## Visual Enhancement with Scientific Schematics
83
+
84
+ **⚠️ MANDATORY: Every clinical decision support document MUST include at least 1-2 AI-generated figures using the scientific-schematics skill.**
85
+
86
+ This is not optional. Clinical decision documents require clear visual algorithms. Before finalizing any document:
87
+ 1. Generate at minimum ONE schematic or diagram (e.g., clinical decision algorithm, treatment pathway, or biomarker stratification tree)
88
+ 2. For cohort analyses: include patient flow diagram
89
+ 3. For treatment recommendations: include decision flowchart
90
+
91
+ **How to generate figures:**
92
+ - Use the **scientific-schematics** skill to generate AI-powered publication-quality diagrams
93
+ - Simply describe your desired diagram in natural language
94
+ - Nano Banana Pro will automatically generate, review, and refine the schematic
95
+
96
+ **How to generate schematics:**
97
+
98
+ ## Document Structure
99
+
100
+ **CRITICAL REQUIREMENT: All clinical decision support documents MUST begin with a complete executive summary on page 1 that spans the entire first page before any table of contents or detailed sections.**
101
+
102
+ ### Page 1 Executive Summary Structure
103
+
104
+ The first page of every CDS document should contain ONLY the executive summary with the following components:
105
+
106
+ **Required Elements (all on page 1):**
107
+ 1. **Document Title and Type**
108
+ - Main title (e.g., "Biomarker-Stratified Cohort Analysis" or "Evidence-Based Treatment Recommendations")
109
+ - Subtitle with disease state and focus
110
+
111
+ 2. **Report Information Box** (using colored tcolorbox)
112
+ - Document type and purpose
113
+ - Date of analysis/report
114
+ - Disease state and patient population
115
+ - Author/institution (if applicable)
116
+
117
+