skills-quantumnous

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# Alva Skills

![Agent Skills](https://alva-ai-static.b-cdn.net/images/alva-skill-github-cover-new.png)

> Turn your AI agent into Alva Agent — research market theses with live financial context, build or remix Playbooks, set alerts, connect accounts, and backtest strategies on Alva Cloud.

## Quick Start

### 1. Install

#### Claude Code

```bash
npx skills add https://github.com/alva-ai/skills
```

#### OpenClaw

```bash
clawhub install alva
```

Or manually copy the skill directory:

```bash
cp -r skills/alva ~/.openclaw/skills/alva
```

#### Other Agents

This skill uses the [AgentSkills](https://github.com/anthropics/agent-skills) format. Any agent that supports `SKILL.md` can load it by pointing to the `skills/alva/` directory.

### 2. Configure

Get an API key at [alva.ai](https://alva.ai), then add it to your agent's environment:

#### Claude Code

```json
// ~/.claude/settings.json
{
  "env": {
    "ALVA_API_KEY": "your_api_key"
  }
}
```

#### OpenClaw

```json
// openclaw.json
{
  "skills": {
    "entries": {
      "alva": {
        "enabled": true,
        "env": { "ALVA_API_KEY": "your_api_key" }
      }
    }
  }
}
```

### Auto-Update

The Alva skill automatically checks for updates on first use each session. If a
newer version is available, your agent will display a notification:

```
Alva skill update available.
  Installed: v1.0.0
  Latest:    v1.2.0
Update with one of:
  npx skills update
  clawhub update alva
  git clone https://github.com/alva-ai/skills ./tmp/alva-skills && cp -r ./tmp/alva-skills/skills/alva/* "<skill-dir>/" && rm -rf ./tmp/alva-skills
```

The check is silent when your skill is up to date. It runs at most once every 8 hours and fails gracefully offline.

### 3. Try It

Start with a simple prompt:

```
Explain why NVDA moved last week and what changed in semis
```

That's it. Your agent can now answer market questions, build or remix live Playbooks, set alerts, and work with connected accounts on Alva. By default, the skill builds live Playbooks unless you explicitly ask for a static snapshot. When you explicitly ask for user-callable functions, interactive Playbooks register them through the functions CLI and invoke them through the PBSV + UDF runtime.

---

## Example Prompts

| Use Case                    | Example Prompt                                                                                         |
| --------------------------- | ------------------------------------------------------------------------------------------------------ |
| Ask Market Questions        | *"Explain why NVDA moved last week and what changed in semis."*                                        |
| Set Alerts                  | *"Create a weekday 8:30am ET alert for SPY, QQQ, NVDA, MSFT, and TSLA meaningful changes."*            |
| Build Playbooks             | *"Build a Playbook tracking AAPL with price charts, analyst targets, and insider trades."*             |
| Discover & Remix Playbooks  | *"Find a semiconductor Playbook tracking AI infrastructure and subscribe me to its alerts."*            |
| Backtest Strategies         | *"Backtest an RSI mean-reversion strategy on BTC with daily rebalancing."*                             |
| Connect Accounts & Trading  | *"Show my connected portfolio holdings and summarize recent activity."*                                |
| Interactive Playbook Tools  | *"Register a Playbook UDF and expose it through a Run analysis button for the selected ticker."*        |

---

## Platform Capabilities

### Data — 250+ Financial Skills

Unified access to crypto, equities, ETFs, macro, on-chain, and social data through built-in skills:

| Category      | Highlights                                                                                                  |
| ------------- | ----------------------------------------------------------------------------------------------------------- |
| Crypto        | Spot & futures OHLCV, funding rates, open interest, long/short ratios, exchange flows, DeFi metrics         |
| Equities      | Fundamentals (income, balance sheet, cash flow), analyst estimates, price targets, insider & senator trades |
| Macro         | CPI, GDP, unemployment, fed funds rate, Treasury rates, VIX, consumer sentiment                             |
| On-Chain      | MVRV, SOPR, NUPL, whale ratio, exchange inflow/outflow                                                      |
| Social & News | Twitter/X, Reddit, YouTube, podcasts, news feeds, web search                                                |
| Technical     | 50+ indicator calculations — RSI, MACD, Bollinger, ATR, VWAP, Ichimoku, and more                            |

For unstructured content, use `feed_widgets` to subscribe to specific accounts or channels, and `unified_search` to discover content about a topic.

### Compute — Cloud JavaScript Runtime

Write JavaScript that runs on Alva Cloud in a secure V8 isolate. No local dependencies, no infrastructure to manage. Full access to built-in skills, HTTP networking, and LLM APIs.

### Pipelines — Feed SDK

Build persistent data pipelines that store time series data. Schedule them as cronjobs for continuous updates — every minute, every hour, or daily.

### Backtest — Altra Trading Engine

Event-driven backtesting with historical data and live paper trading. Define strategies, register features, simulate portfolios, and analyze performance.

### Deploy & Share — Playbook Web Apps

Turn your work into a hosted web app at `https://alva.ai/u/<username>/playbooks/<playbook_name>`. Built with the Alva Design System — charts, KPIs, tables, and optional UDF controls for explicitly requested user-registered functions registered by the functions CLI. You can also remix published playbooks and add a creator's note after release.

---

## Architecture at a Glance

```
┌───────────────┐    ┌──────────────────────────────────────────────────────┐
│   AI Agent    │───▶│                      Alva Cloud                      │
│ (Claude, etc) │    │                                                      │
└───────────────┘    │  ┌──────────────┐  ┌──────────┐  ┌──────────────┐    │
                     │  │  Skill Hub   │  │   ALFS   │  │  JS Runtime  │    │
                     │  │ 250+ Skills  │  │  Files   │  │  V8 Isolate  │    │
                     │  └──────┬───────┘  └────┬─────┘  └──────┬───────┘    │
                     │         │               │               │            │
                     │  ┌──────▼────────────────▼───────────────▼───────┐   │
                     │  │               Feed SDK + Altra                │   │
                     │  │         Data Pipelines & Backtesting          │   │
                     │  └───────────────────────┬───────────────────────┘   │
                     │                          │                           │
                     │  ┌───────────────────────▼───────────────────────┐   │
                     │  │          Cronjobs · Playbooks · Releases      │   │
                     │  └───────────────────────────────────────────────┘   │
                     └──────────────────────────────────────────────────────┘
```

---

## Available Skills

| Skill                            | Description                                                                                                                                                                 |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **[alva](https://github.com/alva-ai/skills/blob/HEAD/skills/alva/SKILL.md)** | Alva Agent for investing workflows — ask market questions, set alerts, build/remix Playbooks, connect accounts, backtest strategies, and use Alva Cloud data/runtime capabilities. See the [skill reference](https://github.com/alva-ai/skills/blob/HEAD/skills/alva/SKILL.md) for detailed instructions. |

---

## Links

- **Platform**: [alva.ai](https://alva.ai)
- **Skill Reference**: [skills/alva/SKILL.md](https://github.com/alva-ai/skills/blob/HEAD/skills/alva/SKILL.md)
- **Issues**: [github.com/alva-ai/skills/issues](https://github.com/alva-ai/skills/issues)

Alva Skills

Agent Skills

Turn your AI agent into Alva Agent — research market theses with live financial context, build or remix Playbooks, set alerts, connect accounts, and backtest strategies on Alva Cloud.

Quick Start

1. Install

Claude Code

npx skills add https://github.com/alva-ai/skills

OpenClaw

clawhub install alva

Or manually copy the skill directory:

cp -r skills/alva ~/.openclaw/skills/alva

Other Agents

This skill uses the AgentSkills format. Any agent that supports SKILL.md can load it by pointing to the skills/alva/ directory.

2. Configure

Get an API key at alva.ai, then add it to your agent's environment:

Claude Code

// ~/.claude/settings.json
{
  "env": {
    "ALVA_API_KEY": "your_api_key"
  }
}

OpenClaw

// openclaw.json
{
  "skills": {
    "entries": {
      "alva": {
        "enabled": true,
        "env": { "ALVA_API_KEY": "your_api_key" }
      }
    }
  }
}

Auto-Update

The Alva skill automatically checks for updates on first use each session. If a newer version is available, your agent will display a notification:

Alva skill update available.
  Installed: v1.0.0
  Latest:    v1.2.0
Update with one of:
  npx skills update
  clawhub update alva
  git clone https://github.com/alva-ai/skills ./tmp/alva-skills && cp -r ./tmp/alva-skills/skills/alva/* "<skill-dir>/" && rm -rf ./tmp/alva-skills

The check is silent when your skill is up to date. It runs at most once every 8 hours and fails gracefully offline.

3. Try It

Start with a simple prompt:

Explain why NVDA moved last week and what changed in semis

That's it. Your agent can now answer market questions, build or remix live Playbooks, set alerts, and work with connected accounts on Alva. By default, the skill builds live Playbooks unless you explicitly ask for a static snapshot. When you explicitly ask for user-callable functions, interactive Playbooks register them through the functions CLI and invoke them through the PBSV + UDF runtime.

Example Prompts

Use Case	Example Prompt
Ask Market Questions	"Explain why NVDA moved last week and what changed in semis."
Set Alerts	"Create a weekday 8:30am ET alert for SPY, QQQ, NVDA, MSFT, and TSLA meaningful changes."
Build Playbooks	"Build a Playbook tracking AAPL with price charts, analyst targets, and insider trades."
Discover & Remix Playbooks	"Find a semiconductor Playbook tracking AI infrastructure and subscribe me to its alerts."
Backtest Strategies	"Backtest an RSI mean-reversion strategy on BTC with daily rebalancing."
Connect Accounts & Trading	"Show my connected portfolio holdings and summarize recent activity."
Interactive Playbook Tools	"Register a Playbook UDF and expose it through a Run analysis button for the selected ticker."

Platform Capabilities

Data — 250+ Financial Skills

Unified access to crypto, equities, ETFs, macro, on-chain, and social data through built-in skills:

Category	Highlights
Crypto	Spot & futures OHLCV, funding rates, open interest, long/short ratios, exchange flows, DeFi metrics
Equities	Fundamentals (income, balance sheet, cash flow), analyst estimates, price targets, insider & senator trades
Macro	CPI, GDP, unemployment, fed funds rate, Treasury rates, VIX, consumer sentiment
On-Chain	MVRV, SOPR, NUPL, whale ratio, exchange inflow/outflow
Social & News	Twitter/X, Reddit, YouTube, podcasts, news feeds, web search
Technical	50+ indicator calculations — RSI, MACD, Bollinger, ATR, VWAP, Ichimoku, and more

For unstructured content, use feed_widgets to subscribe to specific accounts or channels, and unified_search to discover content about a topic.

Compute — Cloud JavaScript Runtime

Write JavaScript that runs on Alva Cloud in a secure V8 isolate. No local dependencies, no infrastructure to manage. Full access to built-in skills, HTTP networking, and LLM APIs.

Pipelines — Feed SDK

Build persistent data pipelines that store time series data. Schedule them as cronjobs for continuous updates — every minute, every hour, or daily.

Backtest — Altra Trading Engine

Event-driven backtesting with historical data and live paper trading. Define strategies, register features, simulate portfolios, and analyze performance.

Deploy & Share — Playbook Web Apps

Turn your work into a hosted web app at https://alva.ai/u/<username>/playbooks/<playbook_name>. Built with the Alva Design System — charts, KPIs, tables, and optional UDF controls for explicitly requested user-registered functions registered by the functions CLI. You can also remix published playbooks and add a creator's note after release.

Architecture at a Glance

┌───────────────┐    ┌──────────────────────────────────────────────────────┐
│   AI Agent    │───▶│                      Alva Cloud                      │
│ (Claude, etc) │    │                                                      │
└───────────────┘    │  ┌──────────────┐  ┌──────────┐  ┌──────────────┐    │
                     │  │  Skill Hub   │  │   ALFS   │  │  JS Runtime  │    │
                     │  │ 250+ Skills  │  │  Files   │  │  V8 Isolate  │    │
                     │  └──────┬───────┘  └────┬─────┘  └──────┬───────┘    │
                     │         │               │               │            │
                     │  ┌──────▼────────────────▼───────────────▼───────┐   │
                     │  │               Feed SDK + Altra                │   │
                     │  │         Data Pipelines & Backtesting          │   │
                     │  └───────────────────────┬───────────────────────┘   │
                     │                          │                           │
                     │  ┌───────────────────────▼───────────────────────┐   │
                     │  │          Cronjobs · Playbooks · Releases      │   │
                     │  └───────────────────────────────────────────────┘   │
                     └──────────────────────────────────────────────────────┘

Available Skills

Skill	Description
alva	Alva Agent for investing workflows — ask market questions, set alerts, build/remix Playbooks, connect accounts, backtest strategies, and use Alva Cloud data/runtime capabilities. See the skill reference for detailed instructions.