whatisgithub

What is multiwfn-skills?

yuyukurikawa/multiwfn-skills — explained in plain English

Analysis updated 2026-05-18

20PythonAudience · researcherComplexity · 4/5Setup · hard

In one sentence

A collection of Codex AI skills that automate computational chemistry wavefunction analysis and molecular visualization using Multiwfn, VMD, and ChimeraX.

Mindmap

mindmap
  root((repo))
    What it does
      Wavefunction analysis
      Molecular rendering
      Codex skill integration
    Tech stack
      Python
      Multiwfn
      VMD
      ChimeraX
    Use cases
      Generate input files
      Aromaticity analysis
      Orbital visualization
    Audience
      Researchers
      Computational chemists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate Gaussian or ORCA input files automatically from a SMILES string with a recommended method and basis set.

USE CASE 2

Run aromaticity and delocalization analyses like NICS, HOMA, and FLU through a guided pipeline.

USE CASE 3

Render publication quality images of molecular orbitals such as HOMO and LUMO.

USE CASE 4

Produce an electrostatic potential surface image colored by charge from a wavefunction file.

What is it built with?

PythonMultiwfnVMDChimeraX

How does it compare?

yuyukurikawa/multiwfn-skillsa-shojaei/constructdrawingaialex72-py/aria-termux
Stars202020
LanguagePythonPythonPython
Setup difficultyhardmoderatemoderate
Complexity4/54/52/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires separately installing Multiwfn plus VMD or ChimeraX for rendering, not bundled with the repo.

So what is it?

MulTiwFn-skills is a collection of Codex skills for computational chemistry, built around Multiwfn, a program used to analyze molecular wavefunctions. It lets an AI coding assistant like Codex automatically find wavefunction files, structure files, and rendering programs on your machine, run Multiwfn to generate cube data from them, and then produce publication quality molecular images using VMD with its Tachyon renderer, or ChimeraX as a fallback. To install it you clone the repository and copy the full skill folders, not just their SKILL.md files since each one also depends on its own scripts, reference data, and agent files, into Codex's skills directory, then restart your Codex session. You separately need Multiwfn itself installed on your machine, and either VMD or ChimeraX for rendering, with VMD used by default for its white background, orthographic, lit images. The repository provides four skills. One turns a SMILES string into a 3D structure, asks for any missing calculation parameters, recommends a method and basis set from a curated set of benchmark papers, and writes Gaussian or ORCA input files. Another prepares aromaticity and delocalization analyses, supporting methods like NICS, HOMA, and FLU among others, and can generate a Gaussian NMR template when one is needed. A third generates cube files for specific molecular orbitals such as HOMO and LUMO and renders front and side view images of each. The fourth generates an electrostatic potential surface colored by charge from formats like fchk, molden, wfn, or wfx. Each pipeline can be called directly from the command line with a range of options, or invoked inside Codex using a short skill command. Every run writes a manifest file recording which files and programs it found, the exact commands it ran, and any warnings, and the README recommends against committing large calculation outputs to the repository since its gitignore already excludes common ORCA outputs and cube files. The README also notes some limitations plainly: the SMILES to 3D step only produces one conformer, charge and spin multiplicity are never guessed automatically, and users of Multiwfn are asked to cite the relevant paper in their own work.

Copy-paste prompts

Prompt 1
Help me install the esp-surface-skill and orb-visualize-skill into my Codex skills directory.
Prompt 2
Use input-skill to generate a Gaussian input file for benzene from its SMILES string.
Prompt 3
Walk me through running the aromatic-skill pipeline to compute NICS for a ring system.
Prompt 4
Explain how the mo_pipeline.py script renders HOMO and LUMO orbital images.

Frequently asked questions

What is multiwfn-skills?

A collection of Codex AI skills that automate computational chemistry wavefunction analysis and molecular visualization using Multiwfn, VMD, and ChimeraX.

What language is multiwfn-skills written in?

Mainly Python. The stack also includes Python, Multiwfn, VMD.

How hard is multiwfn-skills to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is multiwfn-skills for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.