Sandbox
@awslabs/hcls-agent-skills

Agent skills for healthcare and life sciences workflows

This repository packages 41 healthcare and life sciences Agent Skills for tasks across genomics, imaging, clinical data, claims, and drug discovery. The skills follow the Agent Skills standard and can be loaded into supported agents and editors to guide reasoning or run domain workflows.

32 stars8 forksPythonUpdated 17d ago
Who it's for

Builders who want their agent to handle healthcare and life sciences tasks with domain-specific guidance.

What it delivers

You can get more consistent HCLS answers and workflows without re-explaining domain rules each session.

What it does

Domain skill catalog

Provides skills for genomics, imaging, single-cell analysis, drug discovery, clinical data, and healthcare operations.

Reasoning and pipeline skills

Separates skills that guide domain judgment from skills that produce runnable analysis steps and code patterns.

Multi-agent setup

Includes a coordinator and specialist agents for Kiro multi-agent use.

Evaluation harness

Includes `eval/` scripts and reports for measuring how skills change agent output quality.

Platform installs

Supports install paths for Kiro, Claude Code, Amazon Quick, AWS Strands SDK, and other Agent Skills-compatible platforms.

How to get it

  1. 1Run
    npx skills add awslabs/hcls-agent-skills
  2. 2Or clone the repository for full control
    git clone https://github.com/awslabs/hcls-agent-skills.git
    cd ./hcls-agent-skills
    ./install.sh --target <platform>
  3. 3Run
    ./install.sh --target kiro
    
    # In Kiro CLI, switch to the unified agent:
    /agent hcls
  4. 4Or load individual skills on the fly
    /context add ./hcls-agent-skills/skills/variant-calling/SKILL.md
  5. 5For context-efficient specialist routing (loads ~15K tokens per specialist instead of…
    ./install.sh --target kiro --mode multiagent
    
    # Switch to the coordinator:
    /agent hcls-multiagent
  6. 6Amazon Quick loads skills via GUI upload of individual SKILL.md files
    # See which skills to upload and instructions
    ./install.sh --target quick-desktop

README

Agent Skills for Healthcare & Life Sciences

License: MIT-0 Skills Domains Works with

A curated collection of agent skills for healthcare and life sciences (HCLS) workflows, following the Agent Skills open standard. These 41 domain skills make any AI agent measurably better at HCLS questions. In a 410-prompt pairwise evaluation (380 single-skill + 30 cross-skill) judged by Claude Opus 4.7, skills win 70–86% of head-to-head comparisons depending on harness, with up to 85% critical thinking and up to 87% scientific accuracy win rates. Skills work on 20+ platforms including Kiro, Amazon Quick, Amazon Bedrock AgentCore, AWS Strands SDK, Claude Code, OpenAI Codex, CrewAI, LangChain, and more.

Skills fall into two categories: reasoning skills encode methodology, decision frameworks, and domain expertise to guide the agent's thinking (e.g., ACMG variant classification, target trial emulation, HEDIS measure specification); pipeline skills encode tool-specific commands, code patterns, and parameter tables that produce runnable artifacts (e.g., GATK4 variant calling, RDKit cheminformatics, HL7v2 parsing). Together they make any AI agent a competent collaborator across genomics, single-cell analysis, medical imaging, protein structure, translational research, pharmacoepidemiology, clinical data, drug discovery, proteomics, clinical data review, multi-omics integration, healthcare operations, regulatory, machine learning, and AWS architecture.

Why Agent Skills for Healthcare & Life Sciences?

The line between scientist and builder is fading. Molecular biologists want to classify variants from sequencing data, run single-cell analysis pipelines, and design validation studies all without waiting for IT to scope a project. AI agents like Amazon Quick and Kiro make this possible: universal tools that let a researcher go from question to working system in minutes.

Capability is no longer the bottleneck; methodology is. Every generation of LLMs grows more powerful and knowledgeable. They know facts but not procedures; the multi-step decision chains that domain experts internalize over years. They have "read every textbook" but never worked through the nuance of biology or patient care. When an epidemiologist asks an AI agent to emulate a target trial from claims data, adjust for time-varying confounding, or validate a risk stratification model, reproducible output must be both methodologically and scientifically sound and not just plausible. In regulated domains like healthcare and life sciences, the gap between plausible and correct has patient safety and compliance consequences.

Agent skills close this gap. A skill encodes the structured reasoning that experts follow, such as exact criteria, specific thresholds, failure modes that only experience teaches. Think of it as the computational equivalent of a lab protocol: instead of sitting in a binder, it actively guides the agent in real time. Three properties make this better than the alternatives:

  1. Better than long prompts. Real research tasks require multi-step reasoning. Benchmarks like LifeSciBench show 79% of realistic life science tasks involve multiple decision steps. A monolithic system prompt is brittle, unversioned, and impossible to share across a team. A skill gives the agent a structured starting point: pre-encoded decision logic that's reproducible across users, sessions, and platforms.

  2. Portable and updateable. These skills follow the open Agent Skills standard and work across 20+ platforms (Kiro, Quick, Strands Agent SDK, AgentCore, Claude Code, Codex). When Center of Medicare and Medicaid Services publishes new HCC coefficients or ACMG updates classification criteria, you edit the skill to reflect that knowledge for all future work.

  3. Encodes what textbooks don't. Skills capture tacit and institutional knowledge: which bioinformatics parameters work for your sequencer, which reagent vendor to trust, which clinical codes your payer actually accepts. The kind of judgment that lives in a senior scientist's head and takes years to transfer.

The biggest gains appear exactly where unguided agents fail most: on the hard, multi-step regulatory and methodological questions where getting it wrong has consequences. Outputs become reproducible, not just occasionally correct.

This is what raises the floor for every scientist without lowering the ceiling. Skills don't skip the learning; they provide scaffolding so a new postdoc's analysis meets the same methodological standard as the PI's while they build understanding of why each step matters. The work shifts from instructing the agent ("here's how to avoid immortal time bias") to exercising judgment at a higher level ("is a new-user active-comparator design even the right approach?").

Skill Catalog

41 skills across 13 domains.

Genomics

NameCategoryDescription
genomic-variant-interpretationreasoningACMG/AMP variant classification, ClinVar evidence, computational predictor thresholds
variant-callingpipelineBWA-MEM2, GATK4 HaplotypeCaller, joint genotyping, VQSR, Mutect2
rna-seq-analysispipelineSTAR/Salmon alignment, featureCounts, DESeq2 differential expression
ngs-quality-controlpipelineFastQC, fastp, Picard metrics, mosdepth coverage, MultiQC

Single-Cell Analysis

NameCategoryDescription
biomarker-discoveryreasoningPrognostic vs predictive biomarkers, feature selection, validation design
scrna-seq-pipelinepipelineScanpy/AnnData processing: QC, normalization, HVG, PCA, UMAP, Leiden
cell-type-annotationpipelineCellTypist, SingleR, marker-based annotation, label transfer
trajectory-analysispipelinePseudotime, PAGA, RNA velocity (scVelo), CellRank fate probabilities

Medical Imaging

NameCategoryDescription
imaging-study-designreasoningPreprocessing strategy selection, DICOM de-ID risk, imaging biomarker choice
digital-pathologypipelineTIAToolbox, H-optimus-0, whole-slide image tiling and inference
dicom-processingpipelineDICOM parsing, NIfTI conversion, de-identification, BIDS organization
radiology-preprocessingpipelineHD-BET skull stripping, N4 bias correction, ANTs/FSL registration

Protein Structure

NameCategoryDescription
structure-based-drug-designreasoningDruggability assessment, docking strategy, scoring function selection
protein-structure-analysispipelinePDB parsing, RMSD, Ramachandran, binding pocket detection (fpocket)
molecular-dockingpipelineAutoDock Vina receptor/ligand prep, grid box, virtual screening

Cross-Domain

NameCategoryDescription
translational-researchreasoningT0-T4 translation stages, target validation, neuro hypothesis validation
ml-researcherreasoningML experiment design, evaluation strategy, reporting standards for HCLS
aws-genai-ml-architectreasoningAWS service selection, HIPAA compliance, MLOps for regulated workloads

Pharmacoepidemiology & Real-World Data

NameCategoryDescription
pharmacoepidemiologyreasoningNew-user designs, target trial emulation, immortal time bias, propensity scores
rwd-cohort-analysispipelineClaims cohort identification, PDC adherence, Kaplan-Meier, Cox models, PS matching

Clinical Data

NameCategoryDescription
clinical-data-standardsreasoningMedDRA hierarchy, ICD-10 structure, SNOMED CT, LOINC, terminology mapping
ehr-data-parsingpipelineHL7v2 message parsing, FHIR R4 extraction, format conversion, data quality

Drug Discovery

NameCategoryDescription
drug-repurposingreasoningTarget-based vs phenotype-based repurposing, DGIdb, OpenTargets, translatability
cheminformaticspipelineRDKit descriptors, Lipinski/PAINS filtering, Morgan fingerprints, MMP analysis

Proteomics

NameCategoryDescription
quantitative-proteomicsreasoningLFQ/TMT/DIA strategy, imputation methods, normalization, DE interpretation

Clinical Data Review

NameCategoryDescription
cdisc-compliancereasoningSDTM/ADaM rules, FDA/PMDA expectations, controlled terminology, define.xml
edc-data-validationpipelineEDC export validation, range checks, SDTM structure, CT validation

Multi-Omics Integration

NameCategoryDescription
multi-omics-integrationreasoningEarly/intermediate/late integration, batch correction, partial overlap
multi-omics-pipelinepipelineID mapping, ComBat batch correction, MOFA2, GSEA enrichment

Healthcare Operations

NameCategoryDescription
claims-billing-rulesreasoningCMS billing rules, NCCI edits, FWA patterns, upcoding/unbundling detection
claims-analyticspipelineX12 837/835 parsing, provider profiling, NCCI validation, duplicate detection
risk-adjustment-strategyreasoningCMS-HCC V24/V28, disease hierarchies, RAF methodology, coding gap strategy
risk-adjustmentpipelineICD-10-to-HCC crosswalk, RAF score calculation, Rx/lab proxy gap detection
pa-clinical-policyreasoningStep therapy, medical necessity, LCD/NCD rules, Da Vinci PAS, appeals
pa-decision-automationpipelineX12 278/FHIR PAS parsing, rules engine, ML classifier, denial analysis
hedis-measure-specificationreasoningHEDIS measure structure, denominator/numerator/exclusion logic, NCQA audit, care gaps
risk-stratification-indicesreasoningLACE, Charlson, Elixhauser indices, SDOH Z-codes, ADI scoring
quality-measurespipelineHEDIS calculation, enrollment checks, care gap detection, utilization rates
provider-denial-workupreasoningCARC/RARC denial classification, appeal posture determination, appeal letter drafting
coordination-of-benefitsreasoningMedicare Secondary Payer (MSP) rules, NAIC birthday rule, primary/secondary determination, COB denial resolution

Regulatory

NameCategoryDescription
medical-device-software-compliancereasoningIEC 62304 safety classification, FDA 510(k)/De Novo/PMA pathway, SOUP/OTS assessment, PCCP for AI/ML devices

Installation

npx skills add awslabs/hcls-agent-skills

Or clone the repository for full control:

git clone https://github.com/awslabs/hcls-agent-skills.git
cd ./hcls-agent-skills
./install.sh --target <platform>

Platform Compatibility

These skills follow the Agent Skills open standard (SKILL.md + YAML frontmatter) and work across multiple AI assistants:

PlatformInstall CommandHow It Works
Kiro IDE./install.sh --target kiroCopies skills to ~/.kiro/skills/ and agent config to ~/.kiro/agents/
Kiro CLI./install.sh --target kiroSame as above; switch with /agent hcls
Claude Code./install.sh --target claude-codeSymlinks skills into .claude/skills/ for auto-discovery
Quick Desktop./install.sh --target quick-desktopPrints upload instructions (GUI-only: Settings → Skills → Upload)
GitHub Copilot, Cursor, Codex, Gemini CLI, 50+ othersnpx skills add .Universal CLI from vercel-labs/skills
CrewAIskills=["./skills"]Native parameter on Agent class
LangChain / LangGraphDocumented patternSkills as prompt-driven specializations
AWS Strands SDKAgentSkills + plugins=[skills]Built-in plugin, deploys to AgentCore
Claude Messages APIUpload via Skills Management APIFirst-class container parameter with CRUD

Kiro (IDE & CLI)

./install.sh --target kiro

# In Kiro CLI, switch to the unified agent:
/agent hcls

Or load individual skills on the fly:

/context add ./hcls-agent-skills/skills/variant-calling/SKILL.md

Multi-Agent Mode (Kiro)

For context-efficient specialist routing (loads ~15K tokens per specialist instead of ~80K for all 38 skills):

./install.sh --target kiro --mode multiagent

# Switch to the coordinator:
/agent hcls-multiagent

The coordinator routes queries to 8 domain specialists:

SpecialistDomain
hcls-genomicsVariant classification, NGS pipelines, RNA-seq
hcls-omicsSingle-cell, proteomics, multi-omics, biomarkers
hcls-imagingDICOM, digital pathology, radiology preprocessing
hcls-drug-discoveryDocking, cheminformatics, drug repurposing, translational
hcls-clinical-dataHL7/FHIR, CDISC/SDTM, EDC validation
hcls-rwePharmacoepidemiology, RWD cohorts, risk indices
hcls-healthcare-opsClaims billing, risk adjustment, prior auth, HEDIS
hcls-ai-infraML experiment design, AWS architecture

See docs/multiagent-architecture.md for the full architecture.

Amazon Quick

Amazon Quick loads skills via GUI upload of individual SKILL.md files:

# See which skills to upload and instructions
./install.sh --target quick-desktop

Upload path: Settings → Capabilities → Skills → Upload → select a SKILL.md file. Start with one domain and add more as needed. Follow the instructions in Skills and agents in the Amazon Quick documentation.

AWS Strands Agents SDK

For the AWS Strands Agents SDK, load skills directly in your Python code:

pip install strands-agents
from strands import Agent, AgentSkills
from strands.models.bedrock import BedrockModel

model = BedrockModel(model_id="us.anthropic.claude-sonnet-4-20250514", region_name="us-east-1")
skills = AgentSkills(skills="./hcls-agent-skills/skills/")
agent = Agent(model=model, plugins=[skills])

Skills integrate natively with Strands Agents SDK — no wrappers or adapters needed. The AgentSkills plugin discovers and loads all skills from the specified directory. Skills activate automatically based on query content.

Amazon AgentCore

Once your skill-equipped agent works locally, you can move it to production. Amazon Bedrock AgentCore provides an alternative path to inject skills into hosted agents. In addition to embedding them in the Strands agent code, you can configure skills at the environment level so they're available to any agent running in that harness.

Alternatively you can load skills to AgentCore harness, by following Skills in the AgentCore documentation. AgentCore harness provides managed hosting, Auto Scaling, security boundaries, and observability capabilities without managing infrastructure.

Claude Code

# Install into your project (symlinks to repo, so updates propagate)
npx skills add awslabs/hcls-agent-skills -a claude-code

Skills auto-activate when Claude Code detects relevant topics in your prompts. No agent config needed — Claude Code discovers skills from .claude/skills/ automatically.

Quick Start

Invoke a skill by describing the task in natural language — your agent will match on the skill's triggers:

> I have a new candidate biomarker for early-stage NSCLC. Help me design a validation study.
[agent loads translational-research skill]

Or request a pipeline skill explicitly:

> Use the digital-pathology skill to tile this SVS file at 20x with 512px tiles.

Chatbot Demo

A browser-based frontend that connects to kiro-cli acp mode, showcasing skills with real-time streaming, subagent visualization, and tool call tracking.

cd demo
npm install

# Terminal 1 — frontend
npm run dev

# Terminal 2 — backend (point at any repo with skills installed)
DEMO_CWD=/path/to/your/project npm run server

Open http://localhost:5173. Features:

  • Agent selector — switch between hcls (single agent) and hcls-multiagent (coordinator + specialists)
  • Streaming markdown — tables, code blocks, headers render in real-time
  • Skill badges — "★ Reading skill: risk-adjustment" appears inline when skills activate
  • Subagent cards — tabbed view per specialist with independent streaming content
  • Inline tool chips — compact file reads, searches, and commands as wrapping badges
  • Sticky task list — tracks agent progress at the top while scrolling
  • Cancel button — stops displaying output mid-stream

See examples/healthcare-ops-chatbot-demo.md and examples/drug-discovery-chatbot-demo.md for guided walkthroughs with sample prompts.

Evaluation

An automated evaluation suite measures whether skills improve agent responses. See eval/README.md for full documentation.

Quick run:

uv venv --python 3.12 && uv pip install -e .
python -m eval.run --parallel 2 --version v4 --pairwise
python eval/build_review.py
open eval/results/review.html

Latest results (pairwise, 410 prompts — 38 skills + 3 cross-skill categories): Overall win rate 70–86% (v9 Strands: 85.9%, d=0.97; v3 kiro-cli: 69.5%, d=0.39), critical thinking 77–85%. Eval reports show results across 8 versions testing different harness configurations. See eval/TECHNICAL_REPORT.md and eval/HARNESS_EFFECTS.md for the full analysis.

Customization

Want to modify a skill for your org, or create a new one? See CUSTOMIZING.md and SKILL_DESIGN_GUIDE.md for practical guidance on adapting skills to your workflows.

Contributing

New skills and improvements are welcome. See CONTRIBUTING.md and the QUALITY_CHECKLIST.md before submitting.

License

MIT-0

Disclaimer

This solution is for demonstrative purposes only. It is not for clinical use and is not a substitute for professional medical advice, diagnosis, or treatment. The associated skills, and source code are not intended for production. It is each customers' responsibility to determine whether they are subject to HIPAA, and if so, how best to comply with HIPAA and its implementing regulations. Before using AWS in connection with protected health information, customers must enter an AWS Business Associate Addendum (BAA) and follow its configuration requirements.

Files in the repo

Repository payload16 top-level entries
  • .github
  • agents
  • eval
  • examples
  • skills
  • tests
  • .gitignore
  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.md
  • CUSTOMIZING.md
  • install.sh
  • LICENSE
  • pyproject.toml
  • QUALITY_CHECKLIST.md
  • README.md
  • SKILL_DESIGN_GUIDE.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

obra/
superpowers

An agentic skills framework & software development methodology that works.

285k
1 add

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

117k
1 add
Vincentwei1021/
anything2explainer

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666

Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

71k