> ## 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.

# Agent Skills

> Valyu skills for AI coding agents like Claude Code, Cursor, and Windsurf

## Overview

Valyu Agent Skills enable AI coding agents to access real-time information across 25+ data sources.

Install once and your coding assistant can search the web, academic papers, financial data, healthcare information, and more.

**Supported agents:**

* Claude Code
* Open Code
* Cursor
* Windsurf
* Any agent supporting [skills.sh](https://skills.sh)

**Key capabilities:**

* **Search API** - Query across web, academic, financial, medical, and news sources
* **Contents API** - Extract clean markdown from any URL
* **Answer API** - Get AI-synthesized answers with citations
* **DeepResearch API** - Generate comprehensive research reports

## Installation

Install the skill using the CLI:

```bash theme={null}
npx skills add valyuAI/skills
```

Or browse and install from [skills.sh/valyu-network/skills/valyu-best-practices](https://skills.sh/valyu-network/skills/valyu-best-practices).

## API Key Setup

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

Set the environment variable:

<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>
</Tabs>

## Usage

Once installed, your coding agent can use Valyu's APIs through natural language or structured commands.

## Data Sources

Access to 40M+ documents across specialized datasets:

| Category               | Sources                                                        |
| ---------------------- | -------------------------------------------------------------- |
| **Academic**           | arXiv, PubMed, bioRxiv, medRxiv, scholarly journals            |
| **Financial**          | SEC filings, earnings transcripts, stock data, crypto          |
| **Healthcare**         | Clinical trials (ClinicalTrials.gov), FDA drug labels, patents |
| **Economic**           | FRED, BLS, World Bank, economic indicators                     |
| **News**               | Real-time news from multiple sources                           |
| **Prediction Markets** | Polymarket, Kalshi                                             |

## Additional Resources

<CardGroup>
  <Card title="GitHub Repository" icon="github" href="https://github.com/valyuAI/skills">
    View source code and contribute
  </Card>

  <Card title="Skills.sh" icon="wand-magic-sparkles" href="https://skills.sh/valyu-network/skills/valyu-best-practices">
    Browse on skills.sh marketplace
  </Card>
</CardGroup>