> ## Documentation Index
> Fetch the complete documentation index at: https://docs.valyu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Community Skills

> Community-built skills for AI coding agents powered by Valyu

## Overview

The Valyu community has built powerful skills that extend AI coding agents with specialized capabilities. These community-maintained integrations provide domain-specific search and research functionality.

## Scientific Skills

**Repository:** [yorkeccak/scientific-skills](https://github.com/yorkeccak/scientific-skills)

Natural language scientific literature search with semantic search over PubMed, arXiv, ChEMBL, DrugBank, bioRxiv, medRxiv, clinical trials, and more.

### Why Scientific Skills Are Powerful

* **No API Parameter Parsing**: Pass natural language queries directly - no complex search syntax required
* **Semantic Search**: Understands meaning and context, not just keyword matching
* **Full-Text Access**: Returns complete article content, not just abstracts
* **Image Links**: Includes figures and images from papers
* **Comprehensive Coverage**: Access to all scientific literature across multiple databases

### Supported Agents

* Antigravity
* Claude Code
* Clawdbot
* Codex
* Cursor
* Droid
* Gemini CLI
* GitHub Copilot
* Goose
* Kilo Code
* Kiro CLI
* OpenCode
* Roo Code
* Trae
* Windsurf

### Available Skills

**Individual Data Sources (10 skills)**

| Skill                  | Data Source        | Coverage                                                               |
| ---------------------- | ------------------ | ---------------------------------------------------------------------- |
| pubmed-search          | PubMed             | Biomedical and life sciences literature                                |
| arxiv-search           | arXiv              | Physics, mathematics, computer science, quantitative biology preprints |
| biorxiv-search         | bioRxiv            | Biology preprints                                                      |
| medrxiv-search         | medRxiv            | Medical and health sciences preprints                                  |
| chembl-search          | ChEMBL             | Bioactive molecules with drug-like properties                          |
| drugbank-search        | DrugBank           | Comprehensive drug and drug target database                            |
| clinical-trials-search | ClinicalTrials.gov | Clinical trials registry                                               |
| drug-labels-search     | FDA Drug Labels    | Official FDA drug information                                          |
| open-targets-search    | Open Targets       | Drug targets and disease associations                                  |
| patents-search         | Patent Databases   | Global patent filings                                                  |

**Aggregated Skills (3 skills)**

| Skill                 | Combined Sources                                          | Best For                             |
| --------------------- | --------------------------------------------------------- | ------------------------------------ |
| literature-search     | PubMed + arXiv + bioRxiv + medRxiv                        | General scientific literature review |
| biomedical-search     | PubMed + bioRxiv + medRxiv + ClinicalTrials + Drug Labels | Medical and clinical research        |
| drug-discovery-search | ChEMBL + DrugBank + Drug Labels + Open Targets            | Drug discovery and development       |

### Installation

**Via skills.sh (Recommended)**

```bash theme={null}
npx skills i yorkeccak/scientific-skills
```

Or browse individual skills at [skills.sh](https://skills.sh) - search for "yorkeccak"

Example: [skills.sh/yorkeccak/scientific-skills/biomedical-search](https://skills.sh/yorkeccak/scientific-skills/biomedical-search)

**Via Claude Plugin**

```bash theme={null}
/plugin install yorkeccak/scientific-skills
```

**Manual Installation**

```bash theme={null}
# Clone the repository
cd ~/dev
git clone https://github.com/yorkeccak/scientific-skills.git

# Add as a local plugin
/plugin add ~/dev/scientific-skills
```

### Setup

Get your API key from [platform.valyu.ai](https://platform.valyu.ai) with **\$10 free credits**.

**First Use (Automatic)**

Just start using any skill - Claude will automatically detect that no API key is configured, ask for your key, save it, and run your search.

**Manual Setup (Optional)**

<Tabs>
  <Tab title="macOS/Linux (Zsh)">
    ```bash theme={null}
    echo 'export VALYU_API_KEY="your-api-key-here"' >> ~/.zshrc
    source ~/.zshrc
    ```
  </Tab>

  <Tab title="macOS/Linux (Bash)">
    ```bash theme={null}
    echo 'export VALYU_API_KEY="your-api-key-here"' >> ~/.bashrc
    source ~/.bashrc
    ```
  </Tab>

  <Tab title="Windows">
    ```powershell theme={null}
    [Environment]::SetEnvironmentVariable("VALYU_API_KEY", "your-api-key-here", "User")
    ```
  </Tab>

  <Tab title="Config File">
    ```bash theme={null}
    mkdir -p ~/.valyu
    echo '{"apiKey": "your-api-key-here"}' > ~/.valyu/config.json
    ```
  </Tab>
</Tabs>

### Usage Examples

**Literature Review**

Search across all scientific literature:

```bash theme={null}
Search PubMed for CRISPR advances in 2024
```

**Drug Discovery**

Find compounds and targets:

```bash theme={null}
Find kinase inhibitors for melanoma using drug discovery search
```

**Clinical Research**

Find trials and patient outcomes:

```bash theme={null}
Search biomedical sources for checkpoint inhibitor combinations trials
```

**Patent Research**

Search for prior art:

```bash theme={null}
Search patents for CRISPR delivery methods
```

### Output Format

All skills return consistent JSON output:

```json theme={null}
{
  "success": true,
  "type": "pubmed_search",
  "query": "your query",
  "result_count": 10,
  "results": [
    {
      "title": "Article Title",
      "url": "https://...",
      "content": "Full article text with figures...",
      "source": "pubmed",
      "relevance_score": 0.95,
      "images": ["https://example.com/figure1.jpg"]
    }
  ],
  "cost": 0.025
}
```

### Processing Results

**With jq**

```bash theme={null}
# Get article titles
jq -r '.results[].title'

# Get URLs
jq -r '.results[].url'

# Extract content
jq -r '.results[].content'

# Filter by relevance score
jq '.results[] | select(.relevance_score > 0.9)'
```

### Comparison to Traditional Search

| Feature          | Traditional Search                | Scientific Skills       |
| ---------------- | --------------------------------- | ----------------------- |
| Query Format     | Complex syntax, Boolean operators | Natural language        |
| Search Type      | Keyword matching                  | Semantic understanding  |
| Content Returned | Abstracts, metadata               | Full-text with images   |
| API Complexity   | High - learn each API             | Zero - same interface   |
| Setup Time       | Hours per database                | Minutes for all         |
| Multiple Sources | Write separate integrations       | Single unified approach |

## Contributing Your Skills

Have you built Valyu-powered skills that others would find useful? We'd love to feature them here.

**Requirements:**

* Open source (MIT, Apache, or similar license)
* Clear documentation with examples
* Maintained and actively supported
* Uses Valyu APIs for core functionality

Submit your integration via [GitHub](https://github.com/valyuAI/valyu-docs) or reach out on [Discord](https://discord.gg/umtmSsppRY).

## Additional Resources

<CardGroup cols={2}>
  <Card title="Scientific Skills Repository" icon="github" href="https://github.com/yorkeccak/scientific-skills">
    View source code and documentation
  </Card>

  <Card title="Skills.sh Marketplace" icon="wand-magic-sparkles" href="https://skills.sh/yorkeccak/scientific-skills">
    Browse and install individual skills
  </Card>

  <Card title="Official Valyu Skills" icon="sparkles" href="/integrations/agent-skills">
    See official Valyu agent skills
  </Card>

  <Card title="Join Discord" icon="discord" href="https://discord.gg/umtmSsppRY">
    Get help from the community
  </Card>
</CardGroup>