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

# Kỹ năng

> Các bộ hướng dẫn không phụ thuộc mô hình, giúp trợ lý AI xây dựng trên Solana bằng Helius — gồm logic định tuyến, các mẫu SDK chính xác và prompt hệ thống dựng sẵn.

Kỹ năng là các bộ hướng dẫn không phụ thuộc mô hình, giúp trợ lý AI biết cách định tuyến yêu cầu của bạn đến đúng [công cụ MCP](/docs/vi/agents/mcp/tools) và tệp tham chiếu. Chúng không chỉ cung cấp quyền truy cập công cụ — mà còn bao gồm logic định tuyến, các mẫu SDK chính xác và quy tắc ngăn những lỗi phổ biến như mã hóa cứng phí, sử dụng sai endpoint hoặc thiếu tiền tip cho Sender.

Kỹ năng hoạt động với **mọi nền tảng AI** — Claude Code, Codex, OpenAI API, Claude API, Cursor, ChatGPT và nhiều nền tảng khác. Mỗi kỹ năng đi kèm các biến thể prompt hệ thống dựng sẵn để bạn có thể đưa chúng vào bất kỳ công cụ nào đang sử dụng.

## Các kỹ năng hiện có

<CardGroup cols={2}>
  <Card title="Build" icon="hammer" href="/docs/vi/agents/skills/build">
    Phát triển Solana cốt lõi — DAS, Sender, WebSockets, LaserStream, webhook, Wallet API và nhiều nội dung khác
  </Card>

  <Card title="Phantom" icon="wallet" href="/docs/vi/agents/skills/phantom">
    Phát triển dApp frontend — Phantom Connect SDK (React, React Native, trình duyệt), kiểm soát quyền truy cập bằng token, thanh toán
  </Card>

  <Card title="Jupiter" icon="rocket" href="/docs/vi/agents/skills/jupiter">
    Ứng dụng DeFi — hoán đổi token, cho vay, lệnh giới hạn, DCA, dữ liệu token/giá
  </Card>

  <Card title="DFlow" icon="chart-line" href="/docs/vi/agents/skills/dflow">
    Ứng dụng giao dịch — hoán đổi giao ngay, thị trường dự đoán, truyền phát theo thời gian thực, Proof KYC
  </Card>

  <Card title="OKX" icon="chart-mixed" href="/docs/vi/agents/skills/okx">
    Giao dịch và thông tin chuyên sâu — tổng hợp OKX DEX, tín hiệu dòng tiền thông minh, phân tích meme token
  </Card>

  <Card title="SVM" icon="microchip" href="/docs/vi/agents/skills/svm">
    Cơ chế nội bộ của giao thức Solana — thực thi SVM, đồng thuận, mô hình tài khoản, kinh tế học trình xác thực
  </Card>
</CardGroup>

## Cách hoạt động của kỹ năng

Kỹ năng tuân theo kiến trúc prompt 3 lớp:

| Lớp                   | Nội dung                                                               | Vị trí                                                                                       |
| --------------------- | ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| **A: Khung thực thi** | Hành vi và quy tắc công cụ dành riêng cho tác nhân/môi trường thực thi | Tích hợp sẵn (Claude Code), `AGENTS.md` (Codex), phần mở đầu trong các biến thể prompt (API) |
| **B: Kỹ năng**        | Các quy trình chuẩn, có thể tái sử dụng và không phụ thuộc mô hình     | Các tệp `SKILL.md` + thư mục `references/`                                                   |
| **C: Tác vụ**         | Yêu cầu của người dùng + ngữ cảnh động                                 | Do từng nền tảng cung cấp khi chạy                                                           |

Nội dung kỹ năng (Lớp B) giống hệt nhau trên mọi nền tảng — chỉ lớp bao khung thực thi (Lớp A) khác nhau.

Mỗi kỹ năng bao gồm:

* **Logic định tuyến** — ánh xạ yêu cầu của bạn đến đúng công cụ MCP và tệp tham chiếu
* **Tệp tham chiếu** — tài liệu chuyên sâu cho từng sản phẩm Helius mà AI đọc trước khi viết mã
* **Quy tắc** — ngăn các lỗi phổ biến (ví dụ: mã hóa cứng phí ưu tiên, sai endpoint RPC, thiếu xử lý lỗi)

## Sử dụng kỹ năng trên nhiều nền tảng

Mỗi kỹ năng đi kèm ba biến thể prompt dựng sẵn trong thư mục `prompts/`:

| Tệp                   | Trường hợp sử dụng                                          | Định dạng                                                                        |
| --------------------- | ----------------------------------------------------------- | -------------------------------------------------------------------------------- |
| `openai.developer.md` | OpenAI Responses / Chat Completions API                     | Phần mở đầu Lớp A + nội dung kỹ năng với các dấu phân cách `=== BEGIN SKILL ===` |
| `claude.system.md`    | Prompt hệ thống Claude API                                  | Phần mở đầu Lớp A + nội dung kỹ năng với các dấu phân cách                       |
| `full.md`             | Cursor Rules, hướng dẫn tùy chỉnh ChatGPT, các công cụ khác | Tất cả tệp tham chiếu được nhúng trực tiếp, không có phần phụ thuộc bên ngoài    |

Tìm các tệp này tại:

* **Kho mã nguồn**: `.agents/skills/<skill>/prompts/`
* **Gói npm**: `helius-mcp/system-prompts/<skill>/`

<Tabs>
  <Tab title="Vercel Skills CLI">
    Cài đặt kỹ năng trực tiếp vào tác nhân lập trình AI bằng [Vercel Skills CLI](https://skills.sh/). Hoạt động với Claude Code, Cursor, Copilot, Codex và nhiều công cụ khác.

    ```bash theme={"system"}
    # Install a single skill
    npx skills add helius-labs/core-ai --skill build

    # Browse all available Helius skills
    npx skills add helius-labs/core-ai --list
    ```

    | Kỹ năng                                                                                      | Lệnh cài đặt                                         |
    | -------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
    | **build** — Phát triển Solana cốt lõi (Sender, DAS, WebSockets, LaserStream, webhook)        | `npx skills add helius-labs/core-ai --skill build`   |
    | **phantom** — dApp frontend (Phantom Connect, React, kiểm soát quyền truy cập bằng token)    | `npx skills add helius-labs/core-ai --skill phantom` |
    | **jupiter** — Ứng dụng DeFi (hoán đổi, cho vay, lệnh giới hạn, DCA)                          | `npx skills add helius-labs/core-ai --skill jupiter` |
    | **dflow** — Ứng dụng giao dịch (hoán đổi, thị trường dự đoán, truyền phát, KYC)              | `npx skills add helius-labs/core-ai --skill dflow`   |
    | **okx** — Giao dịch và thông tin chuyên sâu (OKX DEX, dòng tiền thông minh, trình quét meme) | `npx skills add helius-labs/core-ai --skill okx`     |
    | **svm** — Cơ chế nội bộ của giao thức (công cụ SVM, đồng thuận, mô hình tài khoản)           | `npx skills add helius-labs/core-ai --skill svm`     |
  </Tab>

  <Tab title="Claude Code Plugin">
    [Plugin Helius](/docs/vi/agents/claude-code-plugin) gộp tất cả kỹ năng + máy chủ MCP vào một lần cài đặt. Trong Claude Code, hãy chạy chúng dưới dạng hai lệnh riêng biệt:

    ```
    /plugin marketplace add helius-labs/core-ai
    ```

    ```
    /plugin install helius@helius-labs
    ```

    Các kỹ năng được gọi bằng `/helius:build`, `/helius:phantom`, `/helius:jupiter`, `/helius:dflow`, `/helius:okx` hoặc `/helius:svm`.
  </Tab>

  <Tab title="Claude Code Standalone">
    Có thể cài đặt độc lập từng kỹ năng bằng tập lệnh `install.sh` tương ứng:

    ```bash theme={"system"}
    git clone https://github.com/helius-labs/core-ai.git
    cd core-ai/helius-skills
    ./helius/install.sh            # Install to ~/.claude/skills/helius/
    ./helius/install.sh --project  # Or install to current project
    ```

    Các kỹ năng độc lập được tự động gọi dưới dạng Agent Skills — không cần lệnh gạch chéo.
  </Tab>

  <Tab title="Codex CLI">
    Codex tự động phát hiện các kỹ năng từ `.agents/skills/` trong thư mục gốc của dự án:

    ```bash theme={"system"}
    # Copy the .agents/ directory into your project
    cp -r /path/to/core-ai/.agents/ your-project/
    ```

    Các kỹ năng được kích hoạt ngầm khi tác vụ của bạn khớp hoặc được kích hoạt rõ ràng bằng `$helius`, `$helius-phantom`, `$helius-jupiter`, `$helius-dflow`, `$helius-okx` hoặc `$svm`.
  </Tab>

  <Tab title="OpenAI API">
    Sử dụng `openai.developer.md` làm thông báo `developer`:

    ```python theme={"system"}
    from openai import OpenAI

    client = OpenAI()

    with open(".agents/skills/helius/prompts/openai.developer.md") as f:
        skill_prompt = f.read()

    response = client.responses.create(
        model="o3",
        instructions=skill_prompt,
        input="Build a swap interface that submits via Helius Sender"
    )
    ```

    Cũng hoạt động với Chat Completions khi sử dụng `{"role": "developer", "content": skill_prompt}`.
  </Tab>

  <Tab title="Claude API">
    Sử dụng `claude.system.md` làm prompt hệ thống:

    ```python theme={"system"}
    import anthropic

    client = anthropic.Anthropic()

    with open(".agents/skills/helius/prompts/claude.system.md") as f:
        skill_prompt = f.read()

    message = client.messages.create(
        model="claude-sonnet-4-6-20250514",
        max_tokens=4096,
        system=skill_prompt,
        messages=[
            {"role": "user", "content": "Build a swap interface that submits via Helius Sender"}
        ]
    )
    ```
  </Tab>

  <Tab title="Cursor / ChatGPT">
    Sử dụng `full.md` — tệp này nhúng trực tiếp tất cả tệp tham chiếu nên không có phần phụ thuộc bên ngoài.

    **Cursor:** Sao chép vào `.cursor/rules/helius.md`:

    ```bash theme={"system"}
    cp .agents/skills/helius/prompts/full.md .cursor/rules/helius.md
    ```

    **Hướng dẫn tùy chỉnh ChatGPT:** Sử dụng nội dung `SKILL.md` cốt lõi (`full.md` có thể vượt quá giới hạn 8.000 ký tự của ChatGPT đối với các kỹ năng lớn hơn).
  </Tab>
</Tabs>

## Điều kiện tiên quyết

Tất cả kỹ năng đều yêu cầu [máy chủ Helius MCP](/docs/vi/agents/mcp) đang chạy (hoặc các công cụ tương đương đã được cấu hình trong framework tác nhân của bạn). Kỹ năng DFlow còn yêu cầu [máy chủ DFlow MCP](https://pond.dflow.net/build/mcp). Kỹ năng Phantom còn yêu cầu tài khoản [Phantom Portal](https://phantom.com/portal) cho ví nhúng. Kỹ năng Jupiter yêu cầu [khóa Jupiter API](https://developers.jup.ag/portal). Kỹ năng OKX yêu cầu [thư viện kỹ năng OKX](https://github.com/okx/onchainos-skills) và CLI `onchainos`.

| Kỹ năng                              | Yêu cầu                                             | Cần khóa API                                   |
| ------------------------------------ | --------------------------------------------------- | ---------------------------------------------- |
| [Build](/docs/vi/agents/skills/build)     | Helius MCP                                          | Có (Helius)                                    |
| [Phantom](/docs/vi/agents/skills/phantom) | Helius MCP                                          | Có (Helius)                                    |
| [Jupiter](/docs/vi/agents/skills/jupiter) | Helius MCP                                          | Có (Helius + Jupiter)                          |
| [DFlow](/docs/vi/agents/skills/dflow)     | Helius MCP + DFlow MCP                              | Có (Helius + DFlow cho môi trường production)  |
| [OKX](/docs/vi/agents/skills/okx)         | Helius MCP + thư viện kỹ năng OKX + CLI `onchainos` | Có (Helius; OKX không bắt buộc khi phát triển) |
| [SVM](/docs/vi/agents/skills/svm)         | Helius MCP                                          | Không                                          |