Ling-MD/md-agent-skills / pymol-interface-hbond-figures
pymol-interface-hbond-figures
VerifiedUse when creating reusable PyMOL figures for protein-protein or chain-chain interfaces from PDB/MD snapshot files, especially when the user wants only protein kept, water/ions/ligands removed, inter-chain hydrogen-bonding residues shown as sticks, green dashed hydrogen bonds, chain-colored cartoons and labels, MM/PBSA-style blue/orange chain coloring, or a reproducible PML plus rendered PNG for other systems.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.9 KB |
| agents/openai.yaml | config | 328 B |
| references/interface-hbond-style.md | markdown | 2.4 KB |
| scripts/render_interface_hbonds.py | script | 14.2 KB |
references/interface-hbond-style.md
View on GitHub# Interface H-Bond Figure Contract
Use this reference when adapting the interface hydrogen-bond figure workflow to a new protein system.
## Required outputs
Generate a rendered PNG and a reproducible PML. Also save TSV files listing the detected atom pairs and residues so the user can audit what was shown in the figure.
## Scientific selection
The default selection is chain-chain interfacial hydrogen bonds:
- Include only atoms from `polymer.protein`.
- Remove waters, ions, ligands, cofactors, and other hetero objects unless the user explicitly asks to keep them.
- Detect cross-chain hydrogen bonds between the requested chains.
- Show sticks only for residues participating in at least one detected cross-chain H-bond.
- Do not show extra nearby residues just because they are close to the interface.
## Visual style
Use a white background, orthoscopic camera, no depth cue, no heavy shadows, and a transparent cartoon so sticks and dashed H-bonds remain readable.
Preferred colors:
- Chain A: `#0B7DB3` / PyMOL RGB `[0.043, 0.490, 0.702]`
- Chain B: `#E69F00` / PyMOL RGB `[0.902, 0.624, 0.000]`
- H-bonds: `#00C71F` / bright green
Stick carbons must match the chain color. Nitrogen, oxygen, and sulfur should remain atomic colors.
## Label placement
Labels should be on the figure, close to their residue, and colored by chain. Prefer residue labels like `ARG142`, not `A:ARG142`, unless chain ambiguity matters. Labels may cover cartoon regions but should not cover sticks or dashed H-bonds. If auto labels are imperfect, manually adjust the generated PML or regenerate with a larger canvas.
## Common command
```powershell
& 'C:\Users\dell\Downloads\PyMOL-3.1.6.1_appveyor2641-Win64-portable-py310\PyMOL\python.exe' `
'C:\Users\dell\.codex\skills\pymol-interface-hbond-figures\scripts\render_interface_hbonds.py' `
--pdb 'E:\simulation\example\snapshots\snapshot_100ns.pdb' `
--chain-a A `
--chain-b B `
--prefix snapshot_100ns
```
## Troubleshooting
- If no H-bonds are detected, confirm chain IDs and inspect whether the input PDB contains protein records for both chains.
- If ligands or ions appear, verify the render script used `remove ... not polymer.protein`.
- If labels are too large or crowded, rerun with `--width 3000 --height 2400 --label-size 22`.
- If the view hides important sticks, edit the generated PML camera/orientation and rerender with PyMOL.
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 |