Home / pku-yuangroup / openai4s · skills/bioskills/bio-chemoinformatics-shape-similarity/SKILL.md · GitHub

bio-shape-similarity skillA

bio-shape-similarity is agent-read markdown (skill) from pku-yuangroup/openai4s: Performs 3D shape-based similarity searching using ROCS (OpenEye), USRCAT (ultra-fast), Open3DAlign (RDKit), ESPSim (electrostatic), and ShaEP with explicit handling of Tanimoto-Combo (shape + color), shape vs ECFP4 complementarity, conformer-ensemble searching, alignment optimization, and scaffold hopping. Use when searching for shape-mimicking compounds with different scaffolds, identifying bioisosteric replacements, prospective scaffold hopping, or expanding hit series beyond 2D similarity..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

## Version Compatibility

Reference examples tested with: RDKit 2024.09+ (Open3DAlign and USRCAT); official ShaEP syntax checked against ShaEP 1.4.2; ROCS/FastROCS/ROCS X are commercial OpenEye products.

Before using code patterns, verify installed versions match. If versions differ:
- Python: `pip show <package>` then `help(module.function)` to check signatures

If code throws ImportError, AttributeError, or TypeError, introspect the installed
package and adapt the example to match the actual API rather than retrying.

# Shape Similarity

Search for compounds with similar 3D shape (and optionally chemical features) to a query molecule. Shape-based screening complements 2D fingerprint search: it can find scaffold-hopped compounds that ECFP4 misses (different scaffolds with similar shape). ROCS (OpenEye) is the industry-standard commercial tool; Open3DAlign (RDKit), USRCAT (Schreyer & Blundell 2012), and ShaEP are open-source alternatives. Modern best practice combines shape with color (chemical-feature similarity) via Tanimoto-Combo: matches share both shape and pharmacophore feature distribution.
…

Read the whole file at its exact version.

How to install

Latest version
mdr add pku-yuangroup/openai4s/bio-shape-similarity@git:20260821.2d1b678
Exact content
mdr add pku-yuangroup/openai4s/bio-shape-similarity@sha256:23e8293d74a1cdfd

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_kbf2bvozztnlbuv6.svg)](https://markdownregistry.com/a/art_kbf2bvozztnlbuv6)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260821.2d1b678 latest2026-08-21 2d1b678 15,913 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (15913 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

pku-yuangroup/openai4s · 586 stars · license MIT · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_kbf2bvozztnlbuv6
GET https://markdownregistry.com/api/v1/resolve?ref=pku-yuangroup/openai4s/bio-shape-similarity
GET https://markdownregistry.com/api/v1/blob/23e8293d74a1cdfd340ae12cea1134551c2ae1498b248b716dd1a11b60e3fdee

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from pku-yuangroup/openai4s

AGENTS.md agents
pku-yuangroup/openai4s · AGENTS.md
git:20260706.f0fd27c · audit B · 586 stars
CLAUDE.md claude
pku-yuangroup/openai4s · CLAUDE.md
git:20260916.bb0d860 · audit B · 586 stars
admet_genetic skill
pku-yuangroup/openai4s · skills/admet_genetic/SKILL.md · ADMET-guided genetic molecule optimization workflow from seed SMILES; use when the agent needs to build or run an…
git:20260828.e9753be · audit A · 586 stars
alphafold2 skill
pku-yuangroup/openai4s · skills/alphafold2/SKILL.md · Predict protein structure for monomers and multimers with AlphaFold2 via the ColabFold runner (Mirdita et al. 2022…
git:20260828.e9753be · audit A · 586 stars
audit-dataset skill
pku-yuangroup/openai4s · skills/audit-dataset/SKILL.md · Audit tabular datasets before analysis or training for schema drift, missing values, duplicate rows or IDs, target…
git:20260828.e9753be · audit A · 586 stars
bioprobench skill
pku-yuangroup/openai4s · skills/bioprobench/SKILL.md · Score an LLM's biological-protocol reasoning on the BioProBench benchmark: protocol QA, step ordering, error detection…
git:20260828.e9753be · audit A · 586 stars
bio-alignment-io skill
pku-yuangroup/openai4s · skills/bioskills/bio-alignment-alignment-io/SKILL.md · Read, write, and convert multiple sequence alignment files using Biopython Bio.AlignIO. Supports Clustal, PHYLIP…
git:20260821.2d1b678 · audit A · 586 stars
bio-alignment-trimming skill
pku-yuangroup/openai4s · skills/bioskills/bio-alignment-alignment-trimming/SKILL.md · Trim multiple sequence alignments using ClipKIT, trimAl, BMGE, Divvier, or HMMcleaner with mode selection guidance per…
git:20260821.2d1b678 · audit A · 586 stars
bio-alignment-amplicon-clipping skill
pku-yuangroup/openai4s · skills/bioskills/bio-alignment-files-alignment-amplicon-clipping/SKILL.md · Trim PCR primers from aligned reads in amplicon-panel BAMs using samtools ampliconclip. Use when processing SARS-CoV-2…
git:20260821.2d1b678 · audit A · 586 stars
bio-alignment-filtering skill
pku-yuangroup/openai4s · skills/bioskills/bio-alignment-files-alignment-filtering/SKILL.md · Filter alignments by flags, mapping quality, and regions using samtools view and pysam. Use when extracting specific…
git:20260821.2d1b678 · audit A · 586 stars
bio-alignment-indexing skill
pku-yuangroup/openai4s · skills/bioskills/bio-alignment-files-alignment-indexing/SKILL.md · Create and use BAI/CSI indices for BAM/CRAM files using samtools and pysam. Use when enabling random access to…
git:20260821.2d1b678 · audit A · 586 stars
bio-alignment-sorting skill
pku-yuangroup/openai4s · skills/bioskills/bio-alignment-files-alignment-sorting/SKILL.md · Sort alignment files by coordinate or read name using samtools and pysam. Use when preparing BAM files for indexing…
git:20260821.2d1b678 · audit A · 586 stars

Every file in pku-yuangroup/openai4s

Browse by kind, by grade A, or by owner.