Agent skill

Chemgraph Agent Guide

by wentorai in wentorai/research-plugins

Automate molecular simulations with the ChemGraph agentic framework

MITAuto-check passedAI & LLM Engineering

Install Chemgraph Agent Guide

skills CLI
$ npx skills add wentorai/research-plugins --skill chemgraph-agent-guide -a claude-code

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

GitHub CLI
$ gh skill install wentorai/research-plugins chemgraph-agent-guide --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/wentorai/research-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/domains/chemistry/chemgraph-agent-guide .claude/skills/chemgraph-agent-guide && 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
chemgraph-agent-guide
GitHub stars
298
Used in
1 other repo
Token cost
~894 tokens
SKILL.md length
205 words
Files
1
Skills in repo
405
Repo updated
First seen
Licence
MIT

At a glance

Automate molecular simulations with the ChemGraph agentic framework

  • Works in 4 steps: Parser Agent — Interprets natural… → Structure Agent — Generates/retrieves… → Calculator Agent — Selects and runs… → …
  • AI & LLM Engineering work in your project
  • SKILL.md covers Overview, Installation, Core Capabilities and Agent Architecture, plus 3 more sections
  • Calls pip and docker

What it does

Chemgraph Agent Guide is an agent skill from wentorai/research-plugins. Automate molecular simulations with the ChemGraph agentic framework

Its SKILL.md is about 890 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering. It works with LangGraph. The repository describes itself as: 350+ academic research skills, MCP configs, and plugins for Research-Claw and AI agents. The licence is MIT.

When your agent uses it

  • AI & LLM Engineering work in your project

Example prompts

  • “/chemgraph-agent-guide”

Requirements

  • Python 3
  • Docker

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Parser Agent — Interprets natural language into chemistry tasks
  2. Structure Agent — Generates/retrieves molecular structures (SMILES, PDB, CIF)
  3. Calculator Agent — Selects and runs appropriate simulation backend
  4. Analysis Agent — Processes results and generates reports

What it can do on your machine

Read from SKILL.md and the folder at commit bf44b3c. 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

    Shell commands in SKILL.md call:

    • pip
    • docker

    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
    • wiki.fysik.dtu.dk

    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

Chemgraph Agent Guide loads about 894 tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 205 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from wentorai/research-plugins at commit bf44b3c, republished under its MIT licence (© wentorai). 205 words, ~894 tokens.

Download SKILL.mdSave it as .claude/skills/chemgraph-agent-guide/SKILL.md (or your agent's skills folder).
name
chemgraph-agent-guide
description
Automate molecular simulations with the ChemGraph agentic framework

ChemGraph Agent Guide

Overview

ChemGraph is an agentic framework from Argonne National Lab that automates molecular simulation workflows using LLMs. Built on LangGraph and ASE (Atomic Simulation Environment), it enables natural language control of computational chemistry tasks — structure generation, geometry optimization, thermochemistry, and more. Supports DFT (NWChem, ORCA), semi-empirical (xTB), and ML potentials (MACE).

Installation

bash
pip install chemgraph

# Or via Docker
docker pull ghcr.io/argonne-lcf/chemgraph:latest

Core Capabilities

Natural Language Chemistry
python
from chemgraph import ChemGraphAgent

agent = ChemGraphAgent(
    llm_provider="anthropic",
    calculator="xtb",  # fast semi-empirical
)

# Natural language molecular tasks
result = agent.run("Optimize the geometry of caffeine and calculate its vibrational frequencies")
print(result.energy)
print(result.frequencies)

# Thermochemistry
result = agent.run("Calculate the enthalpy of formation of ethanol at 298K")
print(f"ΔHf = {result.enthalpy:.2f} kJ/mol")
Supported Calculators
CalculatorTypeSpeedAccuracy
xTB (TBLite)Semi-empiricalFastModerate
MACEML potentialFastGood
NWChemAb initio DFTSlowHigh
ORCAAb initio/DFTSlowHigh
UMAUniversal MLFastGood
Workflow Automation
python
# Multi-step workflow
workflow = agent.create_workflow([
    "Generate 3D structure of aspirin from SMILES",
    "Optimize geometry with DFT/B3LYP/6-31G*",
    "Calculate IR spectrum",
    "Identify key functional group vibrations",
])
results = workflow.execute()

# Reaction pathway
pathway = agent.run(
    "Find the transition state for the Diels-Alder reaction "
    "between butadiene and ethylene"
)
Integration with ASE
python
from ase.io import read
from chemgraph.calculators import get_calculator

# Use ChemGraph's calculator with ASE directly
atoms = read("molecule.xyz")
calc = get_calculator("xtb")
atoms.calc = calc

energy = atoms.get_potential_energy()
forces = atoms.get_forces()

Agent Architecture

ChemGraph uses LangGraph's state machine to orchestrate:

  1. Parser Agent — Interprets natural language into chemistry tasks
  2. Structure Agent — Generates/retrieves molecular structures (SMILES, PDB, CIF)
  3. Calculator Agent — Selects and runs appropriate simulation backend
  4. Analysis Agent — Processes results and generates reports

Use Cases

  1. High-throughput screening: Automated property calculation for molecular libraries
  2. Reaction discovery: Transition state finding and reaction pathway analysis
  3. Materials design: Optimize structures for target properties
  4. Education: Natural language interface for learning computational chemistry

Requirements

  • Python 3.10+
  • At least one calculator backend (xTB recommended for getting started)
  • LLM API key (Anthropic, OpenAI, or local)

References

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

Files

Just SKILL.md in skills/domains/chemistry/chemgraph-agent-guide of wentorai/research-plugins.

Open the folder on GitHubat commit bf44b3c

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in wentorai/research-plugins, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Chemgraph Agent Guide 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.

Chemgraph Agent Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Chemgraph Agent Guide this skillwentorai/research-plugins2981 repos~894Automated safety check: PassMIT
RAG Implementationwshobson/agents40k10 repos~1.1kAutomated safety check: PassMIT
Langgraph Agent Patternssoba-labs/langchain-agent-skills107—~3.6kAutomated safety check: PassMIT
AI EngineerDokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI507—~1.1kAutomated safety check: PassCustom licence
Langgraph Error Handlingsoba-labs/langchain-agent-skills107—~1.5kAutomated safety check: PassMIT
Port From Langgraphstrands-agents/harness-sdk8.7k—~200Automated safety check: PassApache-2.0

Similar skills

  • RAG Implementation

    wshobson/agents

    Build retrieval-augmented generation systems: pick a vector database and embedding model, choose retrieval and reranking strategies, and start from a LangGraph pipeline.

    40k GitHub starsUsed in 10 repos~1.1k tokens
    AI & LLM EngineeringAuto-check passed
  • Langgraph Agent Patterns

    soba-labs/langchain-agent-skills

    Implement multi-agent coordination patterns (supervisor-subagent, router, orchestrator-worker, handoffs) for LangGraph applications.

    107 GitHub stars~3.6k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • AI Engineer

    Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI

    Principal AI Architect and Machine Learning Engineer. An agent skill from Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI.

    507 GitHub stars~1.1k tokensUpdated 3 mo ago
    AI & LLM EngineeringAuto-check passed
  • Langgraph Error Handling

    soba-labs/langchain-agent-skills

    Implement LangGraph error handling with current v1 patterns.

    107 GitHub stars~1.5k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • Port From Langgraph

    strands-agents/harness-sdk

    Migrate a LangGraph application to Strands Agents while preserving its external entrypoint, routing, persistence, interrupts, limits, and tracing.

    8.7k GitHub stars~200 tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Databricks ML Training

    databricks/databricks-agent-skills

    Official

    Train ML models on Databricks. An agent skill from databricks/databricks-agent-skills.

    345 GitHub stars~4.6k tokensUpdated today
    AI & LLM EngineeringAuto-check passed

More from wentorai/research-plugins

All 405 skills in this repo
  • Abstract Writing Guide

    wentorai/research-plugins

    Craft structured research abstracts that maximize clarity and journal acceptance

    298 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Academic Citation Manager

    wentorai/research-plugins

    Manage academic citations across BibTeX, APA, MLA, and Chicago formats

    298 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed
  • Academic Paper Summarizer

    wentorai/research-plugins

    Summarize academic papers with structured extraction of key elements

    298 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Academic Study Methods

    wentorai/research-plugins

    Evidence-based study techniques for academic learning and retention

    298 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Academic Tone Guide

    wentorai/research-plugins

    Adjust writing tone and register for academic audiences and venues

    298 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Academic Translation Guide

    wentorai/research-plugins

    Academic translation, post-editing, and Chinglish correction guide

    298 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed

Works with

Questions about Chemgraph Agent Guide

What does Chemgraph Agent Guide do?

Automate molecular simulations with the ChemGraph agentic framework. Chemgraph Agent Guide is an agent skill from wentorai/research-plugins.

When should I use Chemgraph Agent Guide?

Chemgraph Agent Guide fits situations like: AI & LLM Engineering work in your project.

How do I install Chemgraph Agent Guide in Claude Code?

Run `npx skills add wentorai/research-plugins --skill chemgraph-agent-guide -a claude-code`. Or copy the skill folder (skills/domains/chemistry/chemgraph-agent-guide in wentorai/research-plugins) into .claude/skills/chemgraph-agent-guide in your project. Claude Code loads it when a task matches its description.

How do I install Chemgraph Agent Guide in Codex?

Run `npx skills add wentorai/research-plugins --skill chemgraph-agent-guide -a codex`. Or copy the skill folder (skills/domains/chemistry/chemgraph-agent-guide in wentorai/research-plugins) into .agents/skills/chemgraph-agent-guide in your project. Codex loads it when a task matches its description.

Can I use Chemgraph Agent Guide 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 wentorai/research-plugins --skill chemgraph-agent-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/chemgraph-agent-guide, .gemini/skills/chemgraph-agent-guide, .github/skills/chemgraph-agent-guide and .opencode/skills/chemgraph-agent-guide in your project.

What does Chemgraph Agent Guide need to run?

Going by SKILL.md and its folder, Chemgraph Agent Guide needs the command-line tools its instructions call (pip and docker). Our summary lists: Python 3; Docker.

Does Chemgraph Agent Guide access the network?

SKILL.md names 2 domains. As links in the text: github.com and wiki.fysik.dtu.dk. This is read from the text; nothing was executed.

Is Chemgraph Agent Guide 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. Review the folder before installing.

What licence does Chemgraph Agent Guide use?

Chemgraph Agent Guide 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 Chemgraph Agent Guide use?

About 894 tokens (SKILL.md is roughly 3.6k 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 Chemgraph Agent Guide?

Skills that share tags, products or a category with Chemgraph Agent Guide: RAG Implementation (wshobson/agents, 40k stars), Langgraph Agent Patterns (soba-labs/langchain-agent-skills, 107 stars), AI Engineer (Dokhacgiakhoa/Agent-Skills-4-Vibe-Coding-CLI, 507 stars) and Langgraph Error Handling (soba-labs/langchain-agent-skills, 107 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Chemgraph Agent Guide?

wentorai (a GitHub user) maintains it in wentorai/research-plugins, which has 298 GitHub stars. The repository holds 405 skills in this directory. The repository was last updated on June 19, 2026.

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