rlaope/oh-my-hermes / skills/omh-molecular-docking
omh-molecular-docking
Verified[omh] Prepared PDBQT inputs: run bounded standalone Vina docking with real poses, scores and replay provenance; never infer efficacy or safety. Use when the user says: molecular-docking, rigid-receptor docking, PDBQT docking, ligand docking poses, AutoDock Vina.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.0 KB |
| references/execution-and-qa.md | markdown | 5.2 KB |
| references/full-contract.md | markdown | 2.8 KB |
| references/procedure.md | markdown | 4.0 KB |
| toolkit/NOTICE.md | markdown | 1.6 KB |
| toolkit/README.md | markdown | 6.9 KB |
| toolkit/examples/settings.json | config | 581 B |
| toolkit/scripts/dock.py | script | 17.7 KB |
| toolkit/upstream-manifest.json | config | 5.9 KB |
references/procedure.md
View on GitHub# molecular-docking Specialist Procedure
Expert clarification questions:
- `prepared receptor and ligand PDBQT paths`
- English: Which prepared, rights-cleared single-ligand and rigid-receptor PDBQT files are authorized?
- Korean: 사용이 허가된, 준비를 마친 단일 리간드와 강체 수용체 PDBQT 파일은 무엇인가요?
- `binding box and preparation provenance`
- English: What are the center and box dimensions in angstrom, and which protonation, charge, tautomer and preparation choices produced these files?
- Korean: 박스 중심과 크기(옹스트롬)는 얼마이고, 어떤 양성자화, 전하, 호변이성질체, 준비 방식으로 이 파일들을 만들었나요?
- `approved local resource budget`
- English: Which isolated optional backend, finite host deadline and new evidence directory are approved?
- Korean: 승인된 격리 선택 백엔드, 유한한 호스트 제한 시간, 새 증거 폴더는 무엇인가요?
## Procedure
Declared checks:
- `docking_input_check`
- Required result fields: `file_hashes`, `format_validation`, `source_license`, `preparation_choices`, `binding_box`
- Criterion: Require safe new output paths, valid finite PDBQT atoms, rigid receptor/single ligand, rights and preparation provenance; HOLD absent binding center or preparation facts.
- `docking_budget_check`
- Required result fields: `cpu`, `seed`, `exhaustiveness`, `n_poses`, `host_deadline`
- Criterion: Require CPU 1-2, positive fixed seed, exhaustiveness 1-4, poses 1-5, box dimensions 1-24 angstrom and a host-enforced deadline at most 180 seconds; the helper records but cannot interrupt native code itself.
- `docking_execution_check`
- Required result fields: `backend_identity`, `pose_score_readback`, `hashes`, `replay`, `claim_boundary`
- Criterion: Require actual dock(), matching MODEL/ENDMDL and VINA RESULT records, finite energies in kcal/mol, engine version, stdout/stderr, exit/deadline evidence and digest-bound replay. A mock, score-only or optimize-only call cannot pass.
### `docking_scope` (analysis)
Bind rights-cleared prepared files, protonation/tautomer/charges, receptor assumptions, site and resource budget. Run optional --validate-only to read back input digests, never as completed docking.
- Input refs: `prepared receptor and ligand PDBQT paths`, `binding box and preparation provenance`, `approved local resource budget`
- Output refs: `molecular_docking_preflight/v1`
- Check IDs: `docking_input_check`, `docking_budget_check`
### `docking_execute` (production)
Explicitly run toolkit/scripts/dock.py in the chosen isolated Vina environment with a new output directory, captured logs and a real finite host timeout. Never auto-install or silently substitute a provider.
- Input refs: `prepared receptor and ligand PDBQT paths`, `binding box and preparation provenance`, `approved local resource budget`
- Output refs: `molecular_docking_run/v1 and real pose/score files`
- Check IDs: `docking_input_check`, `docking_budget_check`
- If this step fails: not_observed; still stands: `molecular_docking_preflight/v1`; hand back: Return molecular_docking_preflight/v1 with captured stdout, stderr, exit or deadline evidence and any partial pose/score files for backend review before a retry in a new output directory.
### `docking_verify` (validation)
Read poses.pdbqt, scores.json and manifest.json; reconcile saved pose energies and atom records with actual inputs and all hashes. Replay with a new output directory when needed; qualify reproducibility by version/platform.
- Input refs: `prepared receptor and ligand PDBQT paths`, `binding box and preparation provenance`, `approved local resource budget`
- Output refs: `molecular_docking_run/v1 and real pose/score files`
- Check IDs: `docking_execution_check`
- If this step fails: tentative; still stands: `molecular_docking_preflight/v1`; hand back: Return poses.pdbqt, scores.json and manifest.json with failed pose, energy, atom-record, hash or replay checks and engine version/platform limits; keep the docking run unverified.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |