Agent skill

Clinical Trials Search

by wu-yc in wu-yc/LabClaw

Search ClinicalTrials.gov with natural language queries. An agent skill from wu-yc/LabClaw.

MITAuto-check passedResearch & Science

Install Clinical Trials Search

skills CLI
$ npx skills add wu-yc/LabClaw --skill clinical-trials-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install wu-yc/LabClaw clinical-trials-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/wu-yc/LabClaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/literature/clinical-trials-search .claude/skills/clinical-trials-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
clinical-trials-search
GitHub stars
1.1k
Used in
2 other repos
Token cost
~1.3k tokens
SKILL.md length
317 words
Files
1
Skills in repo
68
Repo updated
First seen
Licence
MIT

At a glance

Search ClinicalTrials.gov with natural language queries. An agent skill from wu-yc/LabClaw.

  • Works in 2 steps: Node.js 18+ (uses built-in fetch) → Valyu API key from…
  • Tasks that involve Clinical and healthcare research
  • SKILL.md covers Why This Skill is Powerful, Requirements, CRITICAL: Script Path Resolution and API Key Setup Flow, plus 8 more sections
  • Calls jq; reaches api.valyu.ai and clinicaltrials.gov

What it does

Clinical Trials Search is an agent skill from wu-yc/LabClaw. Search ClinicalTrials.gov with natural language queries. Find clinical trials, enrollment, and outcomes using Valyu semantic search.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science, covering Clinical and healthcare research. The repository describes itself as: LabClaw – Operating Layer for LabOS (Stanford-Princeton AI Co-Scientists). The licence is MIT.

When your agent uses it

  • Tasks that involve Clinical and healthcare research

Example prompts

  • “/clinical-trials-search”

Requirements

  • Python 3
  • Node.js

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Node.js 18+ (uses built-in fetch)
  2. Valyu API key from https://platform.valyu.ai ($10 free credits)

What it can do on your machine

Read from SKILL.md and the folder at commit df37802. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.valyu.ai
    • clinicaltrials.gov

    Also links to:

    • platform.valyu.ai
    • docs.valyu.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Clinical Trials Search loads about 1.3k tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 317 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from wu-yc/LabClaw at commit df37802, republished under its MIT licence (© wu-yc). 317 words, ~1,272 tokens.

Download SKILL.mdSave it as .claude/skills/clinical-trials-search/SKILL.md (or your agent's skills folder).
name
clinical-trials-search
description
Search ClinicalTrials.gov with natural language queries. Find clinical trials, enrollment, and outcomes using Valyu semantic search.
keywords
clinical-trials, trial-search, patient-recruitment, clinical-research, trial-outcomes, semantic-search
license
MIT

Search the complete ClinicalTrials.gov database of clinical studies using natural language queries powered by Valyu's semantic search API.

Why This Skill is Powerful

  • No API Parameter Parsing: Just pass natural language queries directly - no need to construct complex search parameters
  • Semantic Search: Understands the meaning of your query, not just keyword matching
  • Full-Text Access: Returns complete trial information including phases, conditions, interventions, and outcomes
  • Image Links: Includes data visualizations when available
  • Comprehensive Coverage: Access to all ClinicalTrials.gov data

Requirements

  1. Node.js 18+ (uses built-in fetch)
  2. Valyu API key from https://platform.valyu.ai ($10 free credits)

CRITICAL: Script Path Resolution

The scripts/search commands in this documentation are relative to this skill's installation directory.

Before running any command, locate the script using:

bash
CLINICAL_TRIALS_SCRIPT=$(find ~/.claude/plugins/cache -name "search" -path "*/clinical-trials-search/*/scripts/*" -type f 2>/dev/null | head -1)

Then use the full path for all commands:

bash
$CLINICAL_TRIALS_SCRIPT "CAR-T cell therapy trials" 15

API Key Setup Flow

When you run a search and receive "setup_required": true, follow this flow:

  1. Ask the user for their API key: "To search ClinicalTrials.gov, I need your Valyu API key. Get one free ($10 credits) at https://platform.valyu.ai"

  2. Once the user provides the key, run:

    bash
    scripts/search setup <api-key>
  3. Retry the original search.

When to Use This Skill

  • Finding ongoing and completed clinical trials
  • Identifying trial eligibility criteria
  • Recruiting status and enrollment information
  • Comparing treatment approaches in trials
  • Patient recruitment and enrollment research
  • Outcomes and safety data from trials

Output Format

json
{
  "success": true,
  "type": "clinical_trials_search",
  "query": "CAR-T cell therapy trials",
  "result_count": 10,
  "results": [
    {
      "title": "Trial Title",
      "url": "https://clinicaltrials.gov/...",
      "content": "Trial details, phase, conditions, outcomes...",
      "source": "clinical-trials",
      "relevance_score": 0.95,
      "images": []
    }
  ],
  "cost": 0.025
}

Processing Results

With jq
bash
# Get trial titles
scripts/search "query" 10 | jq -r '.results[].title'

# Get URLs
scripts/search "query" 10 | jq -r '.results[].url'

# Extract full content
scripts/search "query" 10 | jq -r '.results[].content'

Common Use Cases

Drug Development
bash
# Find drug trials
scripts/search "phase 2 trials for Alzheimer's disease" 50
Treatment Research
bash
# Search for treatment studies
scripts/search "checkpoint inhibitor combinations in lung cancer" 20
Medical Device Studies
bash
# Find device trials
scripts/search "continuous glucose monitoring device studies" 15
Intervention Analysis
bash
# Search for intervention studies
scripts/search "behavioral interventions for obesity" 25

Error Handling

All commands return JSON with success field:

json
{
  "success": false,
  "error": "Error message"
}

Exit codes:

  • 0 - Success
  • 1 - Error (check JSON for details)

API Endpoint

  • Base URL: https://api.valyu.ai/v1
  • Endpoint: /search
  • Authentication: X-API-Key header

Architecture

scripts/
├── search          # Bash wrapper
└── search.mjs      # Node.js CLI

Direct API calls using Node.js built-in fetch(), zero external dependencies.

Adding to Your Project

If you're building an AI project and want to integrate Clinical Trials Search directly into your application, use the Valyu SDK:

Python Integration
python
from valyu import Valyu

client = Valyu(api_key="your-api-key")

response = client.search(
    query="your search query here",
    included_sources=["valyu/valyu-clinical-trials"],
    max_results=20
)

for result in response["results"]:
    print(f"Title: {result['title']}")
    print(f"URL: {result['url']}")
    print(f"Content: {result['content'][:500]}...")
TypeScript Integration
typescript
import { Valyu } from "valyu-js";

const client = new Valyu("your-api-key");

const response = await client.search({
  query: "your search query here",
  includedSources: ["valyu/valyu-clinical-trials"],
  maxResults: 20
});

response.results.forEach((result) => {
  console.log(`Title: ${result.title}`);
  console.log(`URL: ${result.url}`);
  console.log(`Content: ${result.content.substring(0, 500)}...`);
});

See the Valyu docs for full integration examples and SDK reference.

© wu-yc, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/literature/clinical-trials-search of wu-yc/LabClaw.

Open the folder on GitHubat commit df37802

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in wu-yc/LabClaw, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Clinical Trials Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Clinical Trials Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Clinical Trials Search this skillwu-yc/LabClaw1.1k2 repos~1.3kAutomated safety check: PassMIT
Clinical Trials Databasegoogle-deepmind/science-skills3.2k2 repos~3.2kAutomated safety check: PassApache-2.0
CHARLS Paper Reproduction Guidexjtulyc/MedgeClaw6171 repos~1.8kAutomated safety check: PassNone
Biomedical Analysis Dispatchxjtulyc/MedgeClaw6171 repos~2kAutomated safety check: PassNone
Research Paperluwill/research-skills862—~1.9kAutomated safety check: PassNone
Research Proposalluwill/research-skills862—~4.5kAutomated safety check: NotesNone

Similar skills

  • Clinical Trials Database

    google-deepmind/science-skills

    Query ClinicalTrials.gov via APIv2. An agent skill from google-deepmind/science-skills.

    3.2k GitHub starsUsed in 2 repos~3.2k tokens
    Research & ScienceAuto-check passed
  • Guides an agent through reproducing papers built on the CHARLS health and retirement survey, from variable mapping to cognition, depression and isolation scores.

    617 GitHub starsUsed in 1 repo~1.8k tokens
    Research & ScienceAuto-check passed
  • Routes bioinformatics, drug discovery, clinical and multi-omics tasks from a chat interface to Claude Code sessions running K-Dense scientific skills, with a live dashboard per task.

    617 GitHub starsUsed in 1 repo~2k tokens
    Research & ScienceAuto-check passed
  • Research Paper

    luwill/research-skills

    A skill your agent uses when the user asks to write or draft an ORIGINAL RESEARCH ARTICLE — IMRaD paper, conference paper, short/workshop paper, 研究论文/期刊论文/会议论文 — reporting their own completed…

    862 GitHub stars~1.9k tokensUpdated today
    Research & ScienceAuto-check passed
  • Research Proposal

    luwill/research-skills

    A skill your agent uses when the user asks to write or draft a PhD / doctoral research proposal, research plan, 研究计划书, or 开题报告 — a forward-looking plan of background, gap, research questions…

    862 GitHub stars~4.5k tokensUpdated today
    Research & ScienceAuto-check: notes
  • Medical Imaging Review

    LeonChaoX/qinyan-academic-skills

    Write comprehensive literature reviews for medical imaging AI research.

    944 GitHub starsUsed in 3 repos~1.1k tokens
    Research & ScienceAuto-check: notes

More from wu-yc/LabClaw

All 68 skills in this repo
  • Retrieves chemical compound information from PubChem and ChEMBL with disambiguation, cross-referencing, and quality assessment.

    1.1k GitHub starsUsed in 2 repos~2.3k tokens
    Auto-check passed
  • Search and retrieve clinical practice guidelines across 12+ authoritative sources including NICE, WHO, ADA, AHA/ACC, NCCN, SIGN, CPIC, CMA, CTFPHC, GIN, MAGICapp, PubMed, EuropePMC, TRIP, and…

    1.1k GitHub starsUsed in 2 repos~4.9k tokens
    Auto-check passed
  • Generate comprehensive disease research reports using 100+ ToolUniverse tools.

    1.1k GitHub starsUsed in 2 repos~4.7k tokens
    Auto-check passed
  • Identify drug repurposing candidates using ToolUniverse for target-based, compound-based, and disease-driven strategies.

    1.1k GitHub starsUsed in 2 repos~4.4k tokens
    Auto-check passed
  • Retrieves gene expression and omics datasets from ArrayExpress and BioStudies with gene disambiguation, experiment quality assessment, and structured reports.

    1.1k GitHub starsUsed in 2 repos~2.6k tokens
    Auto-check passed
  • Perform comprehensive gene enrichment and pathway analysis using gseapy (ORA and GSEA), PANTHER, STRING, Reactome, and 40+ ToolUniverse tools.

    1.1k GitHub starsUsed in 2 repos~4k tokens
    Auto-check passed

Questions about Clinical Trials Search

What does Clinical Trials Search do?

Search ClinicalTrials.gov with natural language queries. An agent skill from wu-yc/LabClaw. Clinical Trials Search is an agent skill from wu-yc/LabClaw.gov with natural language queries.

When should I use Clinical Trials Search?

Clinical Trials Search fits situations like: tasks that involve Clinical and healthcare research.

How do I install Clinical Trials Search in Claude Code?

Run `npx skills add wu-yc/LabClaw --skill clinical-trials-search -a claude-code`. Or copy the skill folder (skills/literature/clinical-trials-search in wu-yc/LabClaw) into .claude/skills/clinical-trials-search in your project. Claude Code loads it when a task matches its description.

How do I install Clinical Trials Search in Codex?

Run `npx skills add wu-yc/LabClaw --skill clinical-trials-search -a codex`. Or copy the skill folder (skills/literature/clinical-trials-search in wu-yc/LabClaw) into .agents/skills/clinical-trials-search in your project. Codex loads it when a task matches its description.

Can I use Clinical Trials Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wu-yc/LabClaw --skill clinical-trials-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/clinical-trials-search, .gemini/skills/clinical-trials-search, .github/skills/clinical-trials-search and .opencode/skills/clinical-trials-search in your project.

What does Clinical Trials Search need to run?

Going by SKILL.md and its folder, Clinical Trials Search needs the command-line tools its instructions call (jq). Our summary lists: Python 3; Node.js.

Does Clinical Trials Search access the network?

SKILL.md names 4 domains. In commands or code: api.valyu.ai and clinicaltrials.gov; the agent is likely to contact these when it follows the instructions. As links in the text: platform.valyu.ai and docs.valyu.ai. This is read from the text; nothing was executed.

Is Clinical Trials Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Clinical Trials Search use?

Clinical Trials Search is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Clinical Trials Search use?

About 1.3k tokens (SKILL.md is roughly 5.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Clinical Trials Search?

Skills that share tags, products or a category with Clinical Trials Search: Clinical Trials Database (google-deepmind/science-skills, 3.2k stars), CHARLS Paper Reproduction Guide (xjtulyc/MedgeClaw, 617 stars), Biomedical Analysis Dispatch (xjtulyc/MedgeClaw, 617 stars) and Research Paper (luwill/research-skills, 862 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Clinical Trials Search?

wu-yc (a GitHub user) maintains it in wu-yc/LabClaw, which has 1,055 GitHub stars. The repository holds 68 skills in this directory. The repository was last updated on March 19, 2026.

Source: wu-yc/LabClaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.