scientific-agent-skills README

The project's README from github.com/K-Dense-AI/scientific-agent-skills. As one markdown file: README.md.

Scientific Agent Skills

License: MIT arXiv Version Skills Databases Agent Skills Agent Plugins Security Scan Skill Tests Works with X LinkedIn YouTube Reddit

🔔 Claude Scientific Skills is now Scientific Agent Skills. Same skills, broader compatibility — now works with any AI agent that supports the open Agent Skills standard, not just Claude.

New: K-Dense BYOK — A free, open-source AI co-scientist that runs on your desktop, powered by Scientific Agent Skills. Bring your own API keys, pick from 40+ models, and get a full research workspace with web search, file handling, 100+ scientific databases, and access to all 163 skills in this repo. Your data stays on your computer, and you can optionally scale to cloud compute via Modal for heavy workloads. Get started here.

🎥 Webinar recording — Getting Started with K-Dense BYOK A hands-on walkthrough of K-Dense BYOK, our free, open-source AI co-scientist that runs locally on your own machine and is powered by Scientific Agent Skills. We cover how to set it up, bring your own API keys, and run real research workflows with these skills. No prior technical experience needed. Watch the recording →

Stay up to date: Follow K-Dense on X, LinkedIn, YouTube, and Reddit for new skills, release announcements, walkthroughs, research workflow demos, and examples you can use with your own AI agent.

📄 Paper: Scientific Agent Skills is described in Scientific Agent Skills: A Library of Procedural Knowledge for Research Agents (arXiv:2609.00065). If you use these skills in your research, please cite the paper.

A comprehensive collection of 163 ready-to-use scientific and research skills (covering cancer genomics, individual-level 1000 Genomes queries, hosted regulatory-sequence prediction, live pathogen-variant surveillance, analytical method validation, PK/PD modelling and dose selection, full-text biomedical and regulatory literature retrieval, drug-target binding, bounded biomedical knowledge graph search, molecular dynamics, RNA velocity, microbiome foundation models, geospatial science, time series forecasting, scientific ML resource discovery via Hugging Science, 78+ scientific databases, and more) for any AI agent that supports the open Agent Skills standard, created by K-Dense. The repository is also a portable Agent Plugins package (plugin.json + skills/), so plugin-capable clients can load the whole collection as one plugin. Works with Cursor, Claude Code, Codex, Google Antigravity, and more. Transform your AI agent into a research assistant capable of executing complex multi-step scientific workflows across biology, chemistry, medicine, and beyond.

⭐ Help make AI for science easier to discover: If Scientific Agent Skills saves you time, teaches your agent a workflow, or helps your lab move faster, please star this repository. A star is a public signal that these open, reusable research skills are worth maintaining: it helps scientists, engineers, and open-source contributors find the project, shows which agent-skill standards are gaining real adoption, and gives us a clear reason to keep expanding the collection for the community.


These skills enable your AI agent to seamlessly work with specialized scientific libraries, databases, and tools across multiple scientific domains. While the agent can use any Python package or API on its own, these explicitly defined skills provide curated documentation and examples that make it significantly stronger and more reliable for the workflows below:

Transform your AI coding agent into an 'AI Scientist' on your desktop!

🎬 New to Scientific Agent Skills? Watch our Getting Started with Scientific Agent Skills video for a quick walkthrough.

🎥 More tutorials

Recorded walkthroughs of these skills on real research tasks, from the K-Dense YouTube channel:

Video What it covers
Skills 101: Build Your Own Scientific Agent Skill Writing, testing, and packaging a new skill from scratch
Literature Review and Hypothesis Generation Searching the literature and generating grounded hypotheses
Draft and Budget an Experimental Protocol Turning a planned experiment into a costed, written protocol
Draft Responses to Reviewer Comments Building a point-by-point rebuttal from reviewer feedback
Can AI Reproduce a Nature Medicine Paper? An end-to-end reproduction attempt on a published analysis

📦 What's Included

This repository provides 163 scientific and research skills organized into the following categories:

Each skill includes:


📋 Table of Contents


🚀 Why Use This?

⚡ Accelerate Your Research

🎯 Comprehensive Coverage

🔧 Easy Integration

🌟 Maintained & Supported


🎯 Getting Started

Option 1: npx (supported hosts)

Install Scientific Agent Skills with a single command:

npx skills add K-Dense-AI/scientific-agent-skills

This is a common standards-based installer for supported Agent Skills hosts, including current versions of Claude Code, Claude Cowork, Codex, Gemini CLI, Google Antigravity, and Cursor. Confirm installation paths and optional metadata behavior in your host's current documentation.

Option 2: GitHub CLI (gh skill)

If you use the GitHub CLI (v2.90.0+), you can install skills with gh skill:

# Browse and install interactively
gh skill install K-Dense-AI/scientific-agent-skills

# Install a specific skill directly
gh skill install K-Dense-AI/scientific-agent-skills scanpy

# Target a specific agent host
gh skill install K-Dense-AI/scientific-agent-skills --agent cursor
gh skill install K-Dense-AI/scientific-agent-skills --agent claude-code
gh skill install K-Dense-AI/scientific-agent-skills --agent codex
gh skill install K-Dense-AI/scientific-agent-skills --agent gemini

gh skill automatically installs to the correct directory for your agent host and records provenance metadata for supply chain integrity.

Version pinning

Pin to a specific release tag or commit SHA for reproducible installs:

# Pin to a release tag
gh skill install K-Dense-AI/scientific-agent-skills --pin v2.65.0

# Pin to a commit SHA
gh skill install K-Dense-AI/scientific-agent-skills --pin abc123def

Keeping skills up to date

# Check for updates interactively
gh skill update

# Update all installed skills
gh skill update --all

Option 3: Agent Plugins (Cursor, Codex, and other plugin clients)

This repository is a valid Agent Plugins 1.0.0 package: root plugin.json plus Agent Skills under skills/. Clients that support the standard discover every immediate child of skills/ that contains a SKILL.md.

Cursor — symlink or copy the repo into the local plugins directory, then reload:

mkdir -p ~/.cursor/plugins/local
ln -s "$(pwd)" ~/.cursor/plugins/local/scientific-agent-skills

Restart Cursor or run Developer: Reload Window, then confirm the plugin and its skills appear under Customize. See Cursor plugins.

Codex — install from a local checkout (confirm the current CLI flag names in Codex docs):

codex plugins install .

Compatible clients (Cursor, Codex, GitHub Copilot, VS Code, Kiro, and others listed at agent-plugins.org) share the same package layout; installation UX stays client-specific.

Other Agent Skills hosts (OpenClaw, NemoClaw, Pi, Hermes, …)

Agent hosts differ in install paths, discovery settings, and support for optional frontmatter fields. npx skills add (Option 1) commonly installs into the ~/.agents/skills/ convention, with project-scoped installs under .agents/skills/; confirm both paths against your host's current documentation. To install manually on a host configured to scan one of those locations:

git clone https://github.com/K-Dense-AI/scientific-agent-skills.git ~/.agents/skills/scientific-agent-skills   # user-level
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git .agents/skills/scientific-agent-skills      # project-level

For Hermes versions that support skill taps, add the repository as a tap:

hermes skills tap add K-Dense-AI/scientific-agent-skills

Every SKILL.md has YAML frontmatter, but legacy and community skills vary in metadata formatting (block or flow style) and optional extension fields. Repository updates must keep metadata.version as a quoted numeric string and pass canonical skills-ref validate ./skills/<skill-name> checks. Hosts may interpret optional metadata and credential prompts differently, so verify behavior on the target host. Because 163 skills add up to a lot of standing context, consider installing a topical subset rather than the whole collection.

NemoClaw note: NemoClaw runs agents inside NVIDIA OpenShell with default-deny outbound networking. Skills are discovered and loaded normally, but any skill that needs the network — package installs via uv, or API calls (Exa, Parallel, Ben

scientific-agent-skills (K-Dense-AI/scientific-agent-skills)

Searching Database…

What is this?Scientific Agent Skills is a library of 163 ready-to-use scientific and research skills that plug into any AI agent supporting the open Agent Skills standard, turning that agent into a research assistant for biology, chemistry, medicine, physics, and more.
Is this a framework I code against, or something I just install into my agent?It's a plain skills directory (each skill is a SKILL.md plus docs/scripts) that you drop into a compatible agent's skills folder. The whole repo also doubles as a single Agent Plugins package via plugin.json for plugin-capable clients.
How do I add these skills to my AI agent?Copy the skills into your agent's configured skills directory and the host will auto-discover them from there; compatible clients include Claude Code, Cursor and others that read the open Agent Skills format.
Which coding agents are supported?Cursor, Claude Code, Codex, Google Antigravity and Pi are explicitly supported, along with any client implementing the open Agent Skills standard.
Can these skills make clinical or regulatory decisions on their own?No — the healthcare, severity-scoring and regulatory-drafting skills are explicitly scoped as aids for qualified human review, not for patient-specific diagnosis, certification, or autonomous decision-making.
Who is this built for?Scientists, lab engineers and researchers in genomics, cheminformatics, proteomics, clinical research, materials science and related fields who want their AI agent to run domain-specific workflows reliably.
What is K-Dense BYOK?K-Dense BYOK is a free, open-source desktop AI co-scientist powered by this skills library — you bring your own model API keys, get a full research workspace with web search and 100+ databases, and can optionally offload heavy jobs to Modal cloud compute.
What scientific domains does the skill set actually cover?The 163 skills span bioinformatics, genomics, cheminformatics and drug discovery, proteomics, clinical research, medical imaging, materials science, physics/astronomy, geospatial science, and lab automation, plus a unified lookup skill for 78+ public scientific databases.
Are the skills tested before being merged into the repo?Yes — every skill that ships a scripts/ folder includes its own test suite, and CI blocks pull requests that add bundled tooling without matching tests.
Can I query databases like PubChem or ClinicalTrials.gov directly?Yes, a unified database-lookup skill gives deterministic, provenance-tracked access to 78 public databases including PubChem, ChEMBL, UniProt, COSMIC and ClinicalTrials.gov, plus dedicated skills for DepMap, PrimeKG and others.
Creator
K-Dense-AI
Size
460.1 MB
Stars
51.7K
Age
11mo
Commits · 90 Days