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…

这是什么?Scientific Agent Skills 是一个包含 163 个开箱即用的科学与研究技能的库,可接入任何支持开放 Agent Skills 标准的 AI 智能体,让该智能体成为生物学、化学、医学、物理学等领域的研究助手。
这是我需要编写代码调用的框架,还是只需安装到智能体中的东西?它是一个普通的 skills 目录(每个技能包含一个 SKILL.md 以及 docs/ 和 scripts/ 文件),你只需把它放进兼容智能体的 skills 文件夹即可。对于支持插件的客户端,整个仓库还可以通过 plugin.json 打包成一个 Agent Plugins 插件使用。
如何把这些技能添加到我的 AI 智能体中?将 skills 复制到智能体配置的 skills 目录中,宿主程序会自动从该目录发现它们;兼容的客户端包括 Claude Code、Cursor 以及其他能读取开放 Agent Skills 格式的工具。
支持哪些编程智能体?明确支持 Cursor、Claude Code、Codex、Google Antigravity 和 Pi,以及任何实现了开放 Agent Skills 标准的客户端。
这些技能能否自行做出临床或监管决策?不能。医疗、严重程度评分和监管文件起草相关的技能被明确定位为供合格的人工审核使用的辅助工具,不用于针对具体患者的诊断、认证或自主决策。
这是为谁准备的?面向希望其 AI 智能体可靠地执行特定领域工作流的科学家、实验室工程师和研究人员,涵盖基因组学、化学信息学、蛋白质组学、临床研究、材料科学及相关领域。
什么是 K-Dense BYOK?K-Dense BYOK 是一款基于该技能库的免费开源桌面端 AI 科研助手。你需自备模型 API 密钥,即可获得一个完整的研究工作区,支持网络搜索和 100 多个数据库,还可以选择将高负载任务转交给 Modal 云计算运行。
这套技能具体覆盖哪些科学领域?163 个技能涵盖生物信息学、基因组学、化学信息学与药物发现、蛋白质组学、临床研究、医学影像、材料科学、物理学与天文学、地理空间科学以及实验室自动化,另有一个统一查询技能,可访问 78 个以上的公共科学数据库。
这些技能在合并到仓库之前会经过测试吗?会。每个包含 scripts/ 文件夹的技能都附带自己的测试套件,而且 CI 会阻止那些添加了附带工具却没有对应测试的拉取请求。
我能直接查询 PubChem 或 ClinicalTrials.gov 之类的数据库吗?可以。统一的数据库查询技能可以确定性地、并记录数据来源地访问 78 个公共数据库,包括 PubChem、ChEMBL、UniProt、COSMIC 和 ClinicalTrials.gov,此外还有针对 DepMap、PrimeKG 等的专用技能。
Creator
K-Dense-AI
Size
460.1 MB
Stars
52.4K
Age
11mo
Commits · 90 Days