Skip to content

Ling-MD/md-agent-skills / pymol-interface-hbond-figures

pymol-interface-hbond-figures

Verified

Use 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.

FileKindSize
SKILL.mdskill md3.9 KB
agents/openai.yamlconfig328 B
references/interface-hbond-style.mdmarkdown2.4 KB
scripts/render_interface_hbonds.pyscript14.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.
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall