Agent skill

Chem Similarity Search

by learningmatter-mit in learningmatter-mit/AtomisticSkills

Find structurally similar chemical compounds using PubChem's 2D fast similarity engine via the PUG-REST API.

MITAuto-check passedBackend & APIs

Install Chem Similarity Search

skills CLI
$ npx skills add learningmatter-mit/AtomisticSkills --skill chem-similarity-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install learningmatter-mit/AtomisticSkills chem-similarity-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/learningmatter-mit/AtomisticSkills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/chem-similarity-search .claude/skills/chem-similarity-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
chem-similarity-search
GitHub stars
176
Token cost
~614 tokens
SKILL.md length
186 words
Files
4 (incl. scripts)
Skills in repo
129
Repo updated
First seen
Licence
MIT

At a glance

Find structurally similar chemical compounds using PubChem's 2D fast similarity engine via the PUG-REST API.

  • Works in 2 steps: Search by SMILES String → Search by PubChem CID
  • Tasks that involve Vector databases
  • SKILL.md covers Goal, Instructions, Examples and Constraints
  • Runs Python scripts from its folder

What it does

Chem Similarity Search is an agent skill from learningmatter-mit/AtomisticSkills. Find structurally similar chemical compounds using PubChem's 2D fast similarity engine via the PUG-REST API.

Its SKILL.md is about 610 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `examples/aspirin_analogs/README.md`, `examples/aspirin_analogs/aspirin_analogs.json` and `scripts/similarity_search.py`).

It sits in Backend & APIs, covering Vector databases, REST APIs and Drug discovery and cheminformatics. The repository describes itself as: Integrating AtomisticSkills into Agentic IDEs (Cursor, Claude Code, Codex, Google Antigravity, Hermes Agent, etc). The licence is MIT.

When your agent uses it

  • Tasks that involve Vector databases
  • Tasks that involve REST APIs
  • Tasks that involve Drug discovery and cheminformatics

Example prompts

  • “/chem-similarity-search”

Requirements

  • Python 3

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Search by SMILES String
  2. Search by PubChem CID

What it can do on your machine

Read from SKILL.md and the folder at commit 6257444. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Chem Similarity Search loads about 614 tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 186 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~33
When it runs · the whole SKILL.md, loaded when a task matches
~614

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from learningmatter-mit/AtomisticSkills at commit 6257444, republished under its MIT licence (© learningmatter-mit). 186 words, ~614 tokens.

Download SKILL.mdSave it as .claude/skills/chem-similarity-search/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
chem-similarity-search
description
Find structurally similar chemical compounds using PubChem's 2D fast similarity engine via the PUG-REST API.
metadata.category
chemistry, drug-discovery
metadata.venv
cpu

Goal

To programmatically find chemical analogs, alternative precursors, and structurally similar compounds for a given target molecule using PubChem's "fastsimilarity_2d" endpoint. The skill retrieves lists of similar compounds ranked by sequence alignment of their 2D molecular fingerprints, providing CIDs, molecular weights, formulas, and SMILES strings.

Instructions

1. Search by SMILES String

Search for similar compounds by providing the canonical or isomeric SMILES. Adjust the --threshold (similarity cutoff 0-100, default is 95) to widen or narrow the search radius. Higher threshold equals higher similarity. Adjust --max_records to limit the output length.

bash
${CLAUDE_SKILL_DIR}/../../venv/run cpu python ${CLAUDE_SKILL_DIR}/scripts/similarity_search.py \
  --smiles "CC(=O)Oc1ccccc1C(=O)O" \
  --threshold 95 \
  --max_records 5 \
  --outdir research/aspirin_similar \
  --output aspirin_similar.json
2. Search by PubChem CID

Search directly using an exact compound's CID. This avoids translation steps for SMILES parsing.

bash
${CLAUDE_SKILL_DIR}/../../venv/run cpu python ${CLAUDE_SKILL_DIR}/scripts/similarity_search.py \
  --cid 2244 \
  --threshold 90 \
  --max_records 10 \
  --outdir research/aspirin_similar \
  --output cid_2244_similar.json

Examples

We can test extracting highly similar analogs (Threshold 95) for Aspirin (CID: 2244 or SMILES: CC(=O)Oc1ccccc1C(=O)O).

bash
${CLAUDE_SKILL_DIR}/../../venv/run cpu python ${CLAUDE_SKILL_DIR}/scripts/similarity_search.py \
  --cid 2244 \
  --threshold 95 \
  --max_records 5 \
  --outdir ${CLAUDE_SKILL_DIR}/examples/aspirin_analogs \
  --output aspirin_analogs.json

Constraints

  • Rate Limiting: PubChem PUG REST API enforces per-user throttling limits. Heavy bursts will result in HTTP 503 Server Busy errors. The script implements an exponential backoff retry mechanism.
  • 2D Similarity: Uses exact structural bit-vector fingerprints. Stereochemical and 3D properties do not strongly affect the score.
  • Network: Internet access is required.


Author: Bowen Deng Contact: GitHub @learningmatter-mit

© learningmatter-mit, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts) in skills/chem-similarity-search of learningmatter-mit/AtomisticSkills.

  • SKILL.md
  • examples/aspirin_analogs/README.md
  • examples/aspirin_analogs/aspirin_analogs.json
  • scripts/similarity_search.py

Open the folder on GitHubat commit 6257444

Compare with similar skills

Chem Similarity Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Chem Similarity Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Chem Similarity Search this skilllearningmatter-mit/AtomisticSkills176—~614Automated safety check: PassMIT
CLI Anything ChromadbHKUDS/CLI-Anything52k—~727Automated safety check: PassApache-2.0
Pubchem Database Skillaipoch/medical-research-skills1.9k—~954Automated safety check: PassMIT
CohesivityAnil-matcha/awesome-muse-connectors1.3k—~1.1kAutomated safety check: PassMIT
Ncbi Blast APIwentorai/research-plugins2981 repos~1.6kAutomated safety check: PassMIT
DBoracle/skills877—~1.4kAutomated safety check: PassUPL-1.0

Similar skills

  • CLI Anything Chromadb

    HKUDS/CLI-Anything

    Command-line interface for ChromaDB - A stateless CLI for managing vector database collections, documents, and semantic search.

    52k GitHub stars~727 tokensUpdated 18 days ago
    DatabasesAuto-check passed
  • Pubchem Database Skill

    aipoch/medical-research-skills

    Programmatic access to the PubChem database (via PUG-REST API and PubChemPy) for searching chemical compounds, retrieving physicochemical properties, performing structure similarity/substructure…

    1.9k GitHub stars~954 tokensUpdated 23 days ago
    Backend & APIsAuto-check passed
  • Cohesivity

    Anil-matcha/awesome-muse-connectors

    Backend infrastructure for a project via Cohesivity (cohesivity.ai).

    1.3k GitHub stars~1.1k tokensUpdated 4 days ago
    DatabasesAuto-check passed
  • Ncbi Blast API

    wentorai/research-plugins

    Run sequence similarity searches via the NCBI BLAST REST API

    298 GitHub starsUsed in 1 repo~1.6k tokens
    Backend & APIsAuto-check passed
  • DB

    oracle/skills

    Official

    Oracle Database guidance for SQL, PL/SQL, SQLcl, ORDS, Oracle Vector SDK, administration, app development, performance, security, migrations, and agent-safe database workflows.

    877 GitHub stars~1.4k tokensUpdated today
    DatabasesAuto-check passed
  • Open Notebook

    K-Dense-AI/scientific-agent-skills

    Organizes research with the self-hosted Open Notebook alternative to NotebookLM.

    48k GitHub starsUsed in 1 repo~2.8k tokens
    AI & LLM EngineeringAuto-check passed

More from learningmatter-mit/AtomisticSkills

All 129 skills in this repo
  • Drug Binding Site Definition

    learningmatter-mit/AtomisticSkills

    Define a docking search box (center coordinates + box dimensions in Angstroms) from a co-crystal ligand, binding-site residues, or a saved JSON specification.

    176 GitHub stars~2.9k tokensUpdated 2 days ago
    Auto-check passed
  • Drug Complex System Builder

    learningmatter-mit/AtomisticSkills

    Build a solvated, charge-neutralized protein-ligand complex for OpenMM molecular dynamics simulation.

    176 GitHub stars~2k tokensUpdated 2 days ago
    Auto-check passed
  • Drug Pocket Detection

    learningmatter-mit/AtomisticSkills

    Identify and rank ligandable pockets on a protein structure or model using geometry (fpocket) or an ML predictor (P2Rank).

    176 GitHub stars~4k tokensUpdated 2 days ago
    Auto-check passed
  • Chem Bond Dissociation

    learningmatter-mit/AtomisticSkills

    Calculate homolytic and heterolytic bond dissociation energies (BDEs) for all single bonds in a molecule using MLIPs with RDKit fragmentation.

    176 GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check passed
  • Chem Conformer Search

    learningmatter-mit/AtomisticSkills

    Generate molecular conformers with RDKit ETKDG, relax with MLIPs, and rank by energy with Boltzmann weighting.

    176 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed
  • Chem DB Mof

    learningmatter-mit/AtomisticSkills

    Query multiple MOF databases (QMOF via MPContribs; ARC-MOF DB7/Majumdar et al.

    176 GitHub stars~1.9k tokensUpdated 2 days ago
    Auto-check passed

Questions about Chem Similarity Search

What does Chem Similarity Search do?

Find structurally similar chemical compounds using PubChem's 2D fast similarity engine via the PUG-REST API. Chem Similarity Search is an agent skill from learningmatter-mit/AtomisticSkills. Find structurally similar chemical compounds using PubChem's 2D fast similarity engine via the PUG-REST API.

When should I use Chem Similarity Search?

Chem Similarity Search fits situations like: tasks that involve Vector databases; tasks that involve REST APIs; tasks that involve Drug discovery and cheminformatics.

How do I install Chem Similarity Search in Claude Code?

Run `npx skills add learningmatter-mit/AtomisticSkills --skill chem-similarity-search -a claude-code`. Or copy the skill folder (skills/chem-similarity-search in learningmatter-mit/AtomisticSkills) into .claude/skills/chem-similarity-search in your project. Claude Code loads it when a task matches its description.

How do I install Chem Similarity Search in Codex?

Run `npx skills add learningmatter-mit/AtomisticSkills --skill chem-similarity-search -a codex`. Or copy the skill folder (skills/chem-similarity-search in learningmatter-mit/AtomisticSkills) into .agents/skills/chem-similarity-search in your project. Codex loads it when a task matches its description.

Can I use Chem Similarity Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add learningmatter-mit/AtomisticSkills --skill chem-similarity-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/chem-similarity-search, .gemini/skills/chem-similarity-search, .github/skills/chem-similarity-search and .opencode/skills/chem-similarity-search in your project.

What does Chem Similarity Search need to run?

Going by SKILL.md and its folder, Chem Similarity Search needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Chem Similarity Search access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Chem Similarity Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Chem Similarity Search use?

Chem Similarity Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Chem Similarity Search use?

About 614 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Chem Similarity Search?

Skills that share tags, products or a category with Chem Similarity Search: CLI Anything Chromadb (HKUDS/CLI-Anything, 52k stars), Pubchem Database Skill (aipoch/medical-research-skills, 1.9k stars), Cohesivity (Anil-matcha/awesome-muse-connectors, 1.3k stars) and Ncbi Blast API (wentorai/research-plugins, 298 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Chem Similarity Search?

learningmatter-mit (a GitHub organization) maintains it in learningmatter-mit/AtomisticSkills, which has 176 GitHub stars. The repository holds 129 skills in this directory. The repository was last updated on October 7, 2026.

Source: learningmatter-mit/AtomisticSkills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.