Index of every page on this site: llms.txt
All skills
k-dense-ai avatar

/rowan

@ec59a29
Run it yourself

Rowan is a cloud-native molecular modeling and medicinal-chemistry workflow platform with a Python API. Use for pKa and macropKa prediction, conformer and tautomer ensembles, docking and analogue docking, protein-ligand cofolding, MSA generation, molecular dynamics, permeability, descriptor workflows, and related small-molecule or protein modeling tasks. Ideal for programmatic batch screening, multi-step chemistry pipelines, and workflows that would otherwise require maintaining local HPC/GPU infrastructure.

Use this Skill: https://skilld.dev/gh/k-dense-ai/scientific-agent-skills/rowan

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesend_to_end_example.md

≈1.2k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Example: Tautomer-Aware Analogue Triage

This illustrative campaign preserves molecule objects through geometry workflows, uses SMILES only for a SMILES pKa method, and records workflow identifiers. The toy aminopyridines below are not claimed to be active against a target. Hosted results and docking accuracy were not tested in this refresh.

Requires rowan-python==3.2.0, pandas, a configured ROWAN_API_KEY, and a prepared receptor plus validated pocket coordinates for the optional follow-up.

from pathlib import Path
import json
import pandas as pd
import rowan

# Work around the Folder annotation defect in SDK 3.2.0.
from datetime import datetime
rowan.Folder.model_rebuild(_types_namespace={"datetime": datetime})

project = rowan.create_project(name="Analogue triage example")
rowan.project_uuid = project.uuid
folder = rowan.create_folder(name="round_1", parent_uuid=project.root_folder_uuid)
compounds = {"fluoro": "Nc1ncc(F)cc1", "chloro": "Nc1ncc(Cl)cc1", "methoxy": "Nc1ncc(OC)cc1"}

rows = []
selected_tautomers = {}
workflow_ids = {}

def remember(compound, step, workflow):
    workflow_ids.setdefault(compound, {})[step] = workflow.uuid
    Path("campaign_workflows.json").write_text(json.dumps(workflow_ids, indent=2))

for compound, smiles in compounds.items():
    try:
        taut_wf = rowan.submit_tautomer_search_workflow(
            rowan.Molecule.from_smiles(smiles), name=f"{compound} tautomers", folder=folder,
        )
        remember(compound, "tautomers", taut_wf)
        tautomer = taut_wf.result().best_tautomer  # Molecule or None
        if tautomer is None or not tautomer.smiles:
            rows.append({"compound": compound, "error": "No weighted tautomer with SMILES"})
            continue
        selected_tautomers[compound] = tautomer

        pka_wf = rowan.submit_pka_workflow(
            tautomer.smiles, method="starling", name=f"{compound} pKa", folder=folder,
        )
        remember(compound, "pka", pka_wf)
        desc_wf = rowan.submit_descriptors_workflow(
            tautomer, name=f"{compound} descriptors", folder=folder,
        )
        remember(compound, "descriptors", desc_wf)
        pka = pka_wf.result()
        desc = desc_wf.result().descriptors
        if desc is None:
            raise ValueError("Completed descriptor workflow returned no descriptors")
        rows.append({
            "compound": compound,
            "tautomer_smiles": tautomer.smiles,
            "strongest_acid": pka.strongest_acid,
            "strongest_base": pka.strongest_base,
            "exact_mass": desc.get("MW"),
            "topological_psa": desc.get("TopoPSA"),
            "logp": desc.get("SLogP"),
        })
    except rowan.WorkflowError as exc:
        rows.append({"compound": compound, "error": str(exc)})

summary = pd.DataFrame(rows)
summary.to_csv("triage.csv", index=False)
print(summary.to_string(index=False))

Do not automatically rank compounds by the smallest pKa: the relevant acid/base site, desired charge at assay pH, permeability, solubility, and target interactions all matter. A single highest-weight tautomer is a triage simplification. Carry multiple populated tautomers/protomers into docking when warranted.

After reviewing the table and experimental objectives, supply candidate.txt with the selected compound identifier, prepared_receptor.pdb, and pocket.json containing [[cx, cy, cz], [sx, sy, sz]] in Å for that exact receptor:

candidate = Path("candidate.txt").read_text().strip()
if candidate not in selected_tautomers:
    raise ValueError("Selected candidate has no usable tautomer structure")
pocket = json.loads(Path("pocket.json").read_text())
protein = rowan.upload_protein(
    name="prepared target", file_path="prepared_receptor.pdb", project_uuid=project.uuid,
)
docking_wf = rowan.submit_docking_workflow(
    protein=protein,
    pocket=pocket,
    initial_molecule=selected_tautomers[candidate],
    docking_settings=rowan.VinaSettings(scoring_function="vinardo"),
    do_pose_refinement=True,
    name=f"{candidate} docking",
    folder=folder,
)
remember(candidate, "docking", docking_wf)
dock = docking_wf.result()
if not dock.scores:
    raise RuntimeError("No successful docking poses")
print(f"Docking score: {dock.scores[0].score:.2f} kcal/mol")
Path("best_pose.xyz").write_text(dock.best_pose.to_xyz())
if dock.scores[0].complex_pdb:
    dock.get_complex(0).download_structure(name="docked_complex", file_format="mmcif")

Set per-workflow max_credits to the campaign's agreed limits before execution. Inspect poses, stereochemistry, clashes, and retained waters/cofactors; validate with a known ligand where possible. Neither a docking score nor a cofolding confidence score establishes biological activity. For restartable batches and submission ambiguity, see batch_and_webhooks.md.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning27d4 checks · Risk SAFE
  • Gen Agent Trust Hub27d

    This skill provides a comprehensive integration for the Rowan Science molecular modeling platform. It uses the official Rowan Python SDK to perform various chemical simulations and property predictions via cloud-based APIs. The skill demonstrates security best practices by recommending environment variables for API key management and providing warnings against package name confusion (typosquatting). No malicious patterns or security risks were identified.

  • Socket27d

    No alerts

  • Snyk27d

    Risk: LOW · No issues

  • ZeroLeaks7mo

    3 findings · Score: 69/100

Signed by skilld at ec59a29. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 4 days ago.

Activeupdated 2 months ago
Other metadata
compatibility
Python 3.12+ with rowan-python and its RDKit/stjames dependencies. Requires network access and ROWAN_API_KEY for hosted workflows.
metadata
{
  "version": "1.7",
  "last-reviewed": "2026-09-30",
  "upstream-version": "rowan-python 3.2.0",
  "skill-author": "Rowan Science",
  "trigger-keywords": "pKa prediction, molecular docking, conformer search, chemistry workflow, drug discovery, SMILES, protein structure, batch molecular modeling, cloud chemistry",
  "openclaw": {
    "primaryEnv": "ROWAN_API_KEY",
    "envVars": [
      {
        "name": "ROWAN_API_KEY",
        "required": true,
        "description": "Rowan computational chemistry API key."
      }
    ]
  }
}

README badge

README badge for k-dense-ai/scientific-agent-skills/rowan