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,43 @@
1
+ ---
2
+ name: resource-discovery-config
3
+ description: pi-crew resource and configuration discovery workflow. Use when changing agents, teams, workflows, skills, resource hooks, config precedence, or project/user overrides.
4
+ ---
5
+
6
+
7
+ # resource-discovery-config
8
+
9
+ Use this skill for pi-crew resource/config work.
10
+
11
+ ## Source patterns distilled
12
+
13
+ - Pi resource loader: `source/pi-mono/packages/coding-agent/src/core/resource-loader.ts`, extension `resources_discover` hook
14
+ - pi-crew discovery: `src/agents/discover-agents.ts`, `src/teams/discover-teams.ts`, `src/workflows/discover-workflows.ts`
15
+ - Config: `src/config/config.ts`, `src/schema/config-schema.ts`, `schema.json`, `docs/resource-formats.md`
16
+
17
+ ## Rules
18
+
19
+ - Respect discovery precedence: project resources should override user/builtin where supported.
20
+ - Keep built-in resource formats stable and documented.
21
+ - Project config (`.pi/pi-crew.json`) must be sanitized: do not allow dangerous user-only settings such as agent override injection if project trust is lower.
22
+ - Resource paths exposed through Pi hooks must point to package-root resources after build; verify `__dirname` resolution carefully.
23
+ - Avoid dynamic inline imports; keep discovery synchronous or async according to call-site expectations.
24
+ - Validate config with schema and provide actionable errors.
25
+ - When adding new config fields, update defaults, schema, docs, tests, and examples together.
26
+
27
+ ## Anti-patterns
28
+
29
+ - Resolving package skills to `src/skills` instead of package-root `skills` after publishing.
30
+ - Letting project-local config inject arbitrary global agent overrides.
31
+ - Introducing precedence ambiguity between project/user/builtin resources.
32
+ - Changing resource file syntax without migration notes.
33
+
34
+ ## Verification
35
+
36
+ ```bash
37
+ cd pi-crew
38
+ npx tsc --noEmit
39
+ node --experimental-strip-types --test test/unit/config-schema-validation.test.ts test/unit/config.test.ts test/unit/extension-api-surface.test.ts test/unit/agent-override-skills.test.ts
40
+ npm test
41
+ npm pack --dry-run
42
+ ```
43
+
@@ -0,0 +1,100 @@
1
+ ---
2
+ name: rowan
3
+ description: Rowan is a cloud-native molecular modeling and medicinal-chemistry workflow platform with a Python API. Use for pKa and macropKa prediction, conformer and tautomer ensembles, docking and analogue docking, protein-ligand cofolding, MSA generation, molecular dynamics, permeability, descriptor workflows, and related small-molecule or protein modeling tasks. Ideal for programmatic batch screening, multi-step chemistry pipelines, and workflows that would otherwise require maintaining local HPC/GPU infrastructure.
4
+ ---
5
+
6
+ # Rowan: Cloud-Native Molecular-Modeling and Drug-Design Workflows
7
+
8
+ ## Overview
9
+
10
+ Rowan is a cloud-native workflow platform for molecular simulation, medicinal chemistry, and structure-based design. Its Python API exposes a unified interface for small-molecule modeling, property prediction, docking, molecular dynamics, and AI structure workflows.
11
+
12
+ Use Rowan when you want to run medicinal-chemistry or molecular-design workflows programmatically without maintaining local HPC infrastructure, GPU provisioning, or a collection of separate modeling tools. Rowan handles all infrastructure, result management, and computation scaling.
13
+
14
+ ## When to use Rowan
15
+
16
+ **Rowan is a good fit for:**
17
+
18
+ - Quantum chemistry, semiempirical methods, or neural network potentials
19
+ - Batch property prediction (pKa, descriptors, permeability, solubility)
20
+ - Conformer and tautomer ensemble generation
21
+ - Docking workflows (single-ligand, analogue series, pose refinement)
22
+ - Protein-ligand cofolding and MSA generation
23
+ - Multi-step chemistry pipelines (e.g., tautomer search → docking → pose analysis)
24
+ - Batch medicinal-chemistry campaigns where you need consistent, scalable infrastructure
25
+
26
+ **Rowan is not the right fit for:**
27
+ - Simple molecular I/O (use RDKit directly)
28
+ - Post-HF *ab initio* quantum chemistry or relativistic calculations
29
+
30
+ ## Access and pricing model
31
+
32
+ Rowan uses a credit-based usage model. All users, including free-tier users, can create API keys and use the Python API.
33
+
34
+ ### Free-tier access
35
+
36
+ - Access to all Rowan core workflows
37
+ - 20 credits per week
38
+ - 500 signup credits
39
+
40
+ ### Pricing and credit consumption
41
+
42
+ Credits are consumed according to compute type:
43
+
44
+ - **CPU**: 1 credit per minute
45
+ - **GPU**: 3 credits per minute
46
+ - **H100/H200 GPU**: 7 credits per minute
47
+
48
+ Purchased credits are priced per credit and remain valid for up to one year from purchase.
49
+
50
+ ### Typical cost estimates
51
+
52
+ | Workflow | Typical Runtime | Estimated Credits | Notes |
53
+ |----------|----------------|-------------------|-------|
54
+ | Descriptors | <1 min | 0.5–2 | Lightweight, good for triage |
55
+ | pKa (single transition) | 2–5 min | 2–5 | Depends on molecule size |
56
+ | MacropKa (pH 0–14) | 5–15 min | 5–15 | Broader sampling, higher cost |
57
+ | Conformer search | 3–10 min | 3–10 | Ensemble quality matters |
58
+ | Tautomer search | 2–5 min | 2–5 | Heterocyclic systems |
59
+ | Docking (single ligand) | 5–20 min | 5–20 | Depends on pocket size, refinement |
60
+ | Analogue docking series (10–50 ligands) | 30–120 min | 30–100+ | Shared reference frame |
61
+ | MSA generation | 5–30 min | 5–30 | Sequence length dependent |
62
+ | Protein-ligand cofolding | 15–60 min | 20–50+ | AI structure prediction, GPU-heavy |
63
+
64
+ ## Quick start
65
+
66
+ ```bash
67
+ uv pip install rowan-python
68
+ ```
69
+
70
+ ```python
71
+ import rowan
72
+ rowan.api_key = "your_api_key_here" # or set ROWAN_API_KEY env var
73
+
74
+ # Submit a descriptors workflow — completes in under a minute
75
+ wf = rowan.submit_descriptors_workflow("CC(=O)Oc1ccccc1C(=O)O", name="aspirin")
76
+ result = wf.result()
77
+
78
+ print(result.descriptors['MW']) # 180.16
79
+ print(result.descriptors['SLogP']) # 1.19
80
+ print(result.descriptors['TPSA']) # 59.44
81
+ ```
82
+
83
+ If that prints without error, you're set up correctly.
84
+
85
+ ## User and webhook management
86
+
87
+ ### Authentication
88
+
89
+ Set an API key via environment variable (recommended):
90
+
91
+ ```bash
92
+ export ROWAN_API_KEY="your_api_key_here"
93
+ ```
94
+
95
+ Or set directly in Python:
96
+
97
+ ```python
98
+ import rowan
99
+ rowan.api_key = "your_api_key_here"
100
+ ```
@@ -0,0 +1,46 @@
1
+ ---
2
+ name: runtime-state-reader
3
+ description: Safe read-only navigation of pi-crew run state. Use for inspecting manifests, tasks, events, agents, artifacts, health, and diagnostics without modifying state.
4
+ ---
5
+
6
+
7
+ # runtime-state-reader
8
+
9
+ Use this skill when debugging or auditing a pi-crew run.
10
+
11
+ ## Source patterns distilled
12
+
13
+ - `src/state/types.ts`, `src/state/contracts.ts`, `src/state/state-store.ts`
14
+ - `src/state/event-log.ts`, `src/state/artifact-store.ts`, `src/runtime/crew-agent-records.ts`
15
+ - `src/extension/run-index.ts`, `src/extension/team-tool/status.ts`, `src/extension/team-tool/inspect.ts`
16
+
17
+ ## Rules
18
+
19
+ - Prefer exported state APIs over direct file parsing: `loadRunManifestById(cwd, runId)`, run index/list helpers, event readers, and agent readers.
20
+ - Treat state as append-mostly/durable. For review and debugging, do not mutate manifests/tasks/events.
21
+ - Validate run IDs and path-derived IDs; never concatenate untrusted path segments outside state helpers.
22
+ - Read events as JSONL; expect partial/corrupt trailing lines in crash scenarios and handle gracefully.
23
+ - Check status contracts before inferring behavior: terminal vs active run/task statuses matter.
24
+ - Agent aggregate records (`agents.json`) and per-agent status files can disagree briefly; prefer the latest loaded run state plus event log for final conclusions.
25
+ - Include exact paths inspected and distinguish direct evidence from inference.
26
+
27
+ ## Common inspection order
28
+
29
+ 1. Load manifest/tasks.
30
+ 2. Check run/task statuses and timestamps.
31
+ 3. Read recent events.
32
+ 4. Read agent records and per-agent output/status if needed.
33
+ 5. Inspect artifacts/diagnostics only through contained paths.
34
+ 6. Report root cause and smallest safe remediation.
35
+
36
+ ## Verification
37
+
38
+ For code changes to state readers:
39
+
40
+ ```bash
41
+ cd pi-crew
42
+ npx tsc --noEmit
43
+ node --experimental-strip-types --test test/unit/run-index.test.ts test/unit/crew-contracts.test.ts test/unit/atomic-write.test.ts
44
+ npm test
45
+ ```
46
+
@@ -0,0 +1,85 @@
1
+ ---
2
+ name: safe-bash
3
+ description: Safe shell-command workflow. Use whenever a task may execute shell commands, especially to prefer read-only commands and avoid destructive actions without confirmation.
4
+ ---
5
+
6
+
7
+ # safe-bash
8
+
9
+ Use this skill whenever a task may execute shell commands. This skill covers cross-platform shell safety, destructive action confirmation, and Windows-specific patterns.
10
+
11
+ ## Classification
12
+
13
+ Every shell command is either **read-only** or **mutating**. Always report which it is.
14
+
15
+ ### Read-only commands (safe)
16
+ ```bash
17
+ pwd # print working directory
18
+ ls -la # list files
19
+ find . -name "*.ts" | head -20 # search without writing
20
+ rg "pattern" --type ts | head -20 # ripgrep without write
21
+ git status # inspect state
22
+ git log --oneline -5 # recent commits
23
+ git diff --staged # staged changes
24
+ npm view <pkg> # query registry (no install)
25
+ npx tsc --noEmit # typecheck (no write)
26
+ node -e "console.log(process.version)" # inspect version
27
+ ```
28
+
29
+ ### Mutating commands (require confirmation)
30
+ ```bash
31
+ npm install # changes node_modules
32
+ git commit # creates new commit
33
+ git push # publishes to remote
34
+ rm -rf <path> # DESTRUCTIVE
35
+ git reset --hard # rewrites history
36
+ npm publish # publishes to registry
37
+ ```
38
+
39
+ ## Cross-Platform Considerations
40
+
41
+ ### Windows vs Unix paths
42
+
43
+ ```typescript
44
+ // ❌ Never hardcode paths with forward slashes on Windows
45
+ const path = "D:/project/src/file.ts";
46
+
47
+ // ✅ Use path.join() or Node's path module
48
+ import * as path from "path";
49
+ const filePath = path.join(cwd, "src", "file.ts");
50
+
51
+ // ✅ Or use forward slashes that work on both
52
+ const filePath = "src/file.ts"; // relative paths work on both
53
+ ```
54
+
55
+ ### argv vs cmd /c
56
+
57
+ ```typescript
58
+ // ✅ Preferred on Windows: argv-based execution (no shell)
59
+ import { spawn } from "child_process";
60
+ spawn("node", ["--version"], { stdio: "pipe" });
61
+
62
+ // ✅ If shell needed: use cmd /c explicitly
63
+ spawn("cmd", ["/c", "dir /b"], { stdio: "pipe" });
64
+
65
+ // ❌ Don't use cmd /c with complex commands as single string
66
+ spawn("cmd", ["/c", "node --version && npm test"], { stdio: "pipe" });
67
+ ```
68
+
69
+ ### Package manager detection
70
+
71
+ ```typescript
72
+ // Detect npm vs pnpm vs yarn
73
+ function detectPackageManager(cwd: string): "npm" | "pnpm" | "yarn" | "unknown" {
74
+ if (fs.existsSync(path.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
75
+ if (fs.existsSync(path.join(cwd, "yarn.lock"))) return "yarn";
76
+ return "npm";
77
+ }
78
+ ```
79
+
80
+ ## Heredoc and Quoting Gotchas
81
+
82
+ ### Quoting variables in commands
83
+
84
+ ```bash
85
+ # ❌ Unsafe: variable expansion without quoting
@@ -0,0 +1,32 @@
1
+ ---
2
+ name: scanpy
3
+ description: Single-cell RNA-seq analysis toolkit. Use when working with scRNA-seq data, AnnData objects, cell clustering, marker gene detection, UMAP/t-SNE embedding, differential expression, or trajectory inference. Trigger on imports of scanpy, sc, anndata, or mentions of single-cell, transcriptomics, cell-type annotation.
4
+ ---
5
+ # scanpy
6
+
7
+ Use this skill for single-cell RNA-seq analysis workflows.
8
+
9
+ ## Core patterns
10
+
11
+ - **Loading**: `sc.read_10x_mtx()` for 10X data; `sc.read_h5ad()` for AnnData files.
12
+ - **QC**: Filter cells by `n_genes`, `n_counts`, `pct_mito`.
13
+ - **Normalization**: `sc.pp.normalize_total()` → `sc.pp.log1p()` → `sc.pp.highly_variable_genes()`.
14
+ - **PCA + Neighbors**: `sc.tl.pca()` → `sc.pp.neighbors()`.
15
+ - **Clustering**: `sc.tl.leiden()` or `sc.tl.louvain()`.
16
+ - **Embedding**: `sc.tl.umap()` → `sc.pl.umap(color='louvain')`.
17
+ - **Markers**: `sc.tl.rank_genes_groups()` → `sc.pl.rank_genes_groups()`.
18
+
19
+ ## Rules
20
+
21
+ - Always `.copy()` AnnData before destructive operations.
22
+ - Store raw counts in `adata.raw` before normalization.
23
+ - Use sparse matrices (`scipy.sparse`) for large datasets — don't densify unnecessarily.
24
+ - Batch correction: consider `sc.pp.harmony_integrate()` or `sc.external.pp.bbknn()`.
25
+
26
+ ## Anti-patterns
27
+
28
+ - Don't run UMAP before computing neighbors graph.
29
+ - Don't interpret marker genes without statistical testing (use `rank_genes_groups` with `method='wilcoxon'`).
30
+ - Don't filter genes before selecting highly variable genes.
31
+
32
+
@@ -0,0 +1,115 @@
1
+ ---
2
+ name: scholar-evaluation
3
+ description: Systematically evaluate scholarly work using the ScholarEval framework, providing structured assessment across research quality dimensions including problem formulation, methodology, analysis, and writing with quantitative scoring and actionable feedback.
4
+ ---
5
+
6
+ # Scholar Evaluation
7
+
8
+ ## Overview
9
+
10
+ Apply the ScholarEval framework to systematically evaluate scholarly and research work. This skill provides structured evaluation methodology based on peer-reviewed research assessment criteria, enabling comprehensive analysis of academic papers, research proposals, literature reviews, and scholarly writing across multiple quality dimensions.
11
+
12
+ ## When to Use This Skill
13
+
14
+ Use this skill when:
15
+ - Evaluating research papers for quality and rigor
16
+ - Assessing literature review comprehensiveness and quality
17
+ - Reviewing research methodology design
18
+ - Scoring data analysis approaches
19
+ - Evaluating scholarly writing and presentation
20
+ - Providing structured feedback on academic work
21
+ - Benchmarking research quality against established criteria
22
+ - Assessing publication readiness for target venues
23
+ - Providing quantitative evaluation to complement qualitative peer review
24
+
25
+ ## Visual Enhancement with Scientific Schematics
26
+
27
+ **When creating documents with this skill, always consider adding scientific diagrams and schematics to enhance visual communication.**
28
+
29
+ If your document does not already contain schematics or diagrams:
30
+ - Use the **scientific-schematics** skill to generate AI-powered publication-quality diagrams
31
+ - Simply describe your desired diagram in natural language
32
+ - Nano Banana Pro will automatically generate, review, and refine the schematic
33
+
34
+ **For new documents:** Scientific schematics should be generated by default to visually represent key concepts, workflows, architectures, or relationships described in the text.
35
+
36
+ **How to generate schematics:**
37
+ ```bash
38
+ python scripts/generate_schematic.py "your diagram description" -o figures/output.png
39
+ ```
40
+
41
+ ## Evaluation Workflow
42
+
43
+ ### Step 1: Initial Assessment and Scope Definition
44
+
45
+ Begin by identifying the type of scholarly work being evaluated and the evaluation scope:
46
+
47
+ **Work Types:**
48
+ - Full research paper (empirical, theoretical, or review)
49
+ - Research proposal or protocol
50
+ - Literature review (systematic, narrative, or scoping)
51
+ - Thesis or dissertation chapter
52
+ - Conference abstract or short paper
53
+
54
+ **Evaluation Scope:**
55
+ - Comprehensive (all dimensions)
56
+ - Targeted (specific aspects like methodology or writing)
57
+ - Comparative (benchmarking against other work)
58
+
59
+ Ask the user to clarify if the scope is ambiguous.
60
+
61
+ ### Step 2: Dimension-Based Evaluation
62
+
63
+ Systematically evaluate the work across the ScholarEval dimensions. For each applicable dimension, assess quality, identify strengths and weaknesses, and provide scores where appropriate.
64
+
65
+ Refer to `(see docs)` for detailed criteria and rubrics for each dimension.
66
+
67
+ **Core Evaluation Dimensions:**
68
+
69
+ 1. **Problem Formulation & Research Questions**
70
+ - Clarity and specificity of research questions
71
+ - Theoretical or practical significance
72
+ - Feasibility and scope appropriateness
73
+ - Novelty and contribution potential
74
+
75
+ 2. **Literature Review**
76
+
77
+ ### Step 3: Scoring and Rating
78
+
79
+ For each evaluated dimension, provide:
80
+
81
+ **Qualitative Assessment:**
82
+ - Key strengths (2-3 specific points)
83
+ - Areas for improvement (2-3 specific points)
84
+ - Critical issues (if any)
85
+
86
+ **Quantitative Scoring (Optional):**
87
+ Use a 5-point scale where applicable:
88
+ - 5: Excellent - Exemplary quality, publishable in top venues
89
+ - 4: Good - Strong quality with minor improvements needed
90
+ - 3: Adequate - Acceptable quality with notable areas for improvement
91
+ - 2: Needs Improvement - Significant revisions required
92
+
93
+ ### Step 4: Synthesize Overall Assessment
94
+
95
+ Provide an integrated evaluation summary:
96
+
97
+ 1. **Overall Quality Assessment** - Holistic judgment of the work's scholarly merit
98
+ 2. **Major Strengths** - 3-5 key strengths across dimensions
99
+ 3. **Critical Weaknesses** - 3-5 primary areas requiring attention
100
+ 4. **Priority Recommendations** - Ranked list of improvements by impact
101
+ 5. **Publication Readiness** (if applicable) - Assessment of suitability for target venues
102
+
103
+ ### Step 5: Provide Actionable Feedback
104
+
105
+ Transform evaluation findings into constructive, actionable feedback:
106
+
107
+ **Feedback Structure:**
108
+ - **Specific** - Reference exact sections, paragraphs, or page numbers
109
+ - **Actionable** - Provide concrete suggestions for improvement
110
+ - **Prioritized** - Rank recommendations by importance and feasibility
111
+ - **Balanced** - Acknowledge strengths while addressing weaknesses
112
+ - **Evidence-based** - Ground feedback in evaluation criteria
113
+
114
+ **Feedback Format Options:**
115
+
@@ -0,0 +1,118 @@
1
+ ---
2
+ name: scientific-brainstorming
3
+ description: Creative research ideation and exploration. Use for open-ended brainstorming sessions, exploring interdisciplinary connections, challenging assumptions, or identifying research gaps. Best for early-stage research planning when you do not have specific observations yet. For formulating testable hypotheses from data use hypothesis-generation.
4
+ ---
5
+
6
+ # Scientific Brainstorming
7
+
8
+ ## Overview
9
+
10
+ Scientific brainstorming is a conversational process for generating novel research ideas. Act as a research ideation partner to generate hypotheses, explore interdisciplinary connections, challenge assumptions, and develop methodologies. Apply this skill for creative scientific problem-solving.
11
+
12
+ ## When to Use This Skill
13
+
14
+ This skill should be used when:
15
+ - Generating novel research ideas or directions
16
+ - Exploring interdisciplinary connections and analogies
17
+ - Challenging assumptions in existing research frameworks
18
+ - Developing new methodological approaches
19
+ - Identifying research gaps or opportunities
20
+ - Overcoming creative blocks in problem-solving
21
+ - Brainstorming experimental designs or study plans
22
+
23
+ ## Core Principles
24
+
25
+ When engaging in scientific brainstorming:
26
+
27
+ 1. **Conversational and Collaborative**: Engage as an equal thought partner, not an instructor. Ask questions, build on ideas together, and maintain a natural dialogue.
28
+
29
+ 2. **Intellectually Curious**: Show genuine interest in the scientist's work. Ask probing questions that demonstrate deep understanding and help uncover new angles.
30
+
31
+ 3. **Creatively Challenging**: Push beyond obvious ideas. Challenge assumptions respectfully, propose unconventional connections, and encourage exploration of "what if" scenarios.
32
+
33
+ 4. **Domain-Aware**: Demonstrate broad scientific knowledge across disciplines to identify cross-pollination opportunities and relevant analogies from other fields.
34
+
35
+ 5. **Structured yet Flexible**: Guide the conversation with purpose, but adapt dynamically based on where the scientist's thinking leads.
36
+
37
+ ## Brainstorming Workflow
38
+
39
+ ### Phase 1: Understanding the Context
40
+
41
+ Begin by deeply understanding what the scientist is working on. This phase establishes the foundation for productive ideation.
42
+
43
+ **Approach:**
44
+ - Ask open-ended questions about their current research, interests, or challenge
45
+ - Understand their field, methodology, and constraints
46
+ - Identify what they're trying to achieve and what obstacles they face
47
+ - Listen for implicit assumptions or unexplored angles
48
+
49
+ **Example questions:**
50
+ - "What aspect of your research are you most excited about right now?"
51
+ - "What problem keeps you up at night?"
52
+ - "What assumptions are you making that might be worth questioning?"
53
+ - "Are there any unexpected findings that don't fit your current model?"
54
+
55
+ **Transition:** Once the context is clear, acknowledge understanding and suggest moving into active ideation.
56
+
57
+ ### Phase 2: Divergent Exploration
58
+
59
+ Help the scientist generate a wide range of ideas without judgment. The goal is quantity and diversity, not immediate feasibility.
60
+
61
+ **Techniques to employ:**
62
+
63
+ 1. **Cross-Domain Analogies**
64
+ - Draw parallels from other scientific fields
65
+ - "How might concepts from [field X] apply to your problem?"
66
+ - Connect biological systems to social networks, physics to economics, etc.
67
+
68
+ 2. **Assumption Reversal**
69
+ - Identify core assumptions and flip them
70
+ - "What if the opposite were true?"
71
+ - "What if you had unlimited resources/time/data?"
72
+
73
+ ### Phase 3: Connection Making
74
+
75
+ Help identify patterns, themes, and unexpected connections among the generated ideas.
76
+
77
+ **Approach:**
78
+ - Look for common threads across different ideas
79
+ - Identify which ideas complement or enhance each other
80
+ - Find surprising connections between seemingly unrelated concepts
81
+ - Map relationships between ideas visually (if helpful)
82
+
83
+ **Prompts:**
84
+ - "I notice several ideas involve [theme]—what if we combined them?"
85
+ - "These three approaches share [commonality]—is there something deeper there?"
86
+ - "What's the most unexpected connection you're seeing?"
87
+
88
+ ### Phase 4: Critical Evaluation
89
+
90
+ Shift to constructively evaluating the most promising ideas while maintaining creative momentum.
91
+
92
+ **Balance:**
93
+ - Be critical but not dismissive
94
+ - Identify both strengths and challenges
95
+ - Consider feasibility while preserving innovative elements
96
+ - Suggest modifications to make wild ideas more tractable
97
+
98
+ **Questions to explore:**
99
+ - "What would it take to actually test this?"
100
+ - "What's the first small experiment to run?"
101
+ - "What existing data or tools could be leveraged?"
102
+ - "Who else would need to be involved?"
103
+ - "What's the biggest obstacle, and how might it be overcome?"
104
+
105
+ ### Phase 5: Synthesis and Next Steps
106
+
107
+ Help crystallize insights and create concrete paths forward.
108
+
109
+ **Deliverables:**
110
+ - Summarize the most promising directions identified
111
+ - Highlight novel connections or perspectives discovered
112
+ - Suggest immediate next steps (literature search, pilot experiments, collaborations)
113
+ - Capture key questions that emerged for future exploration
114
+ - Identify resources or expertise that would be valuable
115
+
116
+ **Close with encouragement:**
117
+
118
+
@@ -0,0 +1,119 @@
1
+ ---
2
+ name: scientific-critical-thinking
3
+ description: Evaluate scientific claims and evidence quality. Use for assessing experimental design validity, identifying biases and confounders, applying evidence grading frameworks (GRADE, Cochrane Risk of Bias), or teaching critical analysis. Best for understanding evidence quality, identifying flaws. For formal peer review writing use peer-review.
4
+ ---
5
+
6
+ # Scientific Critical Thinking
7
+
8
+ ## Overview
9
+
10
+ Critical thinking is a systematic process for evaluating scientific rigor. Assess methodology, experimental design, statistical validity, biases, confounding, and evidence quality using GRADE and Cochrane ROB frameworks. Apply this skill for critical analysis of scientific claims.
11
+
12
+ ## When to Use This Skill
13
+
14
+ This skill should be used when:
15
+ - Evaluating research methodology and experimental design
16
+ - Assessing statistical validity and evidence quality
17
+ - Identifying biases and confounding in studies
18
+ - Reviewing scientific claims and conclusions
19
+ - Conducting systematic reviews or meta-analyses
20
+ - Applying GRADE or Cochrane risk of bias assessments
21
+ - Providing critical analysis of research papers
22
+
23
+ ## Visual Enhancement with Scientific Schematics
24
+
25
+ **When creating documents with this skill, always consider adding scientific diagrams and schematics to enhance visual communication.**
26
+
27
+ If your document does not already contain schematics or diagrams:
28
+ - Use the **scientific-schematics** skill to generate AI-powered publication-quality diagrams
29
+ - Simply describe your desired diagram in natural language
30
+ - Nano Banana Pro will automatically generate, review, and refine the schematic
31
+
32
+ **For new documents:** Scientific schematics should be generated by default to visually represent key concepts, workflows, architectures, or relationships described in the text.
33
+
34
+ **How to generate schematics:**
35
+ ```bash
36
+ python scripts/generate_schematic.py "your diagram description" -o figures/output.png
37
+ ```
38
+
39
+ ## Core Capabilities
40
+
41
+ ### 1. Methodology Critique
42
+
43
+ Evaluate research methodology for rigor, validity, and potential flaws.
44
+
45
+ **Apply when:**
46
+ - Reviewing research papers
47
+ - Assessing experimental designs
48
+ - Evaluating study protocols
49
+ - Planning new research
50
+
51
+ **Evaluation framework:**
52
+
53
+ 1. **Study Design Assessment**
54
+ - Is the design appropriate for the research question?
55
+ - Can the design support causal claims being made?
56
+
57
+ ### 2. Bias Detection
58
+
59
+ Identify and evaluate potential sources of bias that could distort findings.
60
+
61
+ **Apply when:**
62
+ - Reviewing published research
63
+ - Designing new studies
64
+ - Interpreting conflicting evidence
65
+ - Assessing research quality
66
+
67
+ **Systematic bias review:**
68
+
69
+ 1. **Cognitive Biases (Researcher)**
70
+ - **Confirmation bias:** Are only supporting findings highlighted?
71
+ - **HARKing:** Were hypotheses stated a priori or formed after seeing results?
72
+
73
+ ### 3. Statistical Analysis Evaluation
74
+
75
+ Critically assess statistical methods, interpretation, and reporting.
76
+
77
+ **Apply when:**
78
+ - Reviewing quantitative research
79
+ - Evaluating data-driven claims
80
+ - Assessing clinical trial results
81
+ - Reviewing meta-analyses
82
+
83
+ **Statistical review checklist:**
84
+
85
+ 1. **Sample Size and Power**
86
+ - Was a priori power analysis conducted?
87
+ - Is sample adequate for detecting meaningful effects?
88
+
89
+ ### 4. Evidence Quality Assessment
90
+
91
+ Evaluate the strength and quality of evidence systematically.
92
+
93
+ **Apply when:**
94
+ - Weighing evidence for decisions
95
+ - Conducting literature reviews
96
+ - Comparing conflicting findings
97
+ - Determining confidence in conclusions
98
+
99
+ **Evidence evaluation framework:**
100
+
101
+ 1. **Study Design Hierarchy**
102
+ - Systematic reviews/meta-analyses (highest for intervention effects)
103
+ - Randomized controlled trials
104
+
105
+ ### 5. Logical Fallacy Identification
106
+
107
+ Detect and name logical errors in scientific arguments and claims.
108
+
109
+ **Apply when:**
110
+ - Evaluating scientific claims
111
+ - Reviewing discussion/conclusion sections
112
+ - Assessing popular science communication
113
+ - Identifying flawed reasoning
114
+
115
+ **Common fallacies in science:**
116
+
117
+ 1. **Causation Fallacies**
118
+
119
+