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

# Skills

> Conjuntos de instruções independentes de modelo que ensinam assistentes de IA a construir na Solana usando Helius. As Skills fornecem lógica de roteamento, padrões corretos de SDK, arquivos de referência completos e prompts de sistema pré-construídos para Claude, OpenAI, Codex, Cursor e mais.

As Skills são conjuntos de instruções independentes de modelo que ensinam assistentes de IA a encaminhar suas solicitações para as ferramentas [MCP](/docs/pt-BR/agents/mcp/tools) e arquivos de referência corretos. Elas vão além do acesso bruto a ferramentas — incluem lógica de roteamento, padrões corretos de SDK e regras que evitam erros comuns, como taxas fixas, endpoints errados ou dicas do Remetente ausentes.

As Skills funcionam com **qualquer plataforma de IA** — Claude Code, Codex, OpenAI API, Claude API, Cursor, ChatGPT e mais. Cada skill vem com variantes predefinidas de prompts de sistema para que você possa integrá-las em qualquer ferramenta que usar.

## Skills Disponíveis

<CardGroup cols={2}>
  <Card title="Build" icon="hammer" href="/docs/pt-BR/agents/skills/build">
    Desenvolvimento central na Solana — DAS, Sender, WebSockets, LaserStream, Webhooks, Wallet API e mais
  </Card>

  <Card title="Phantom" icon="wallet" href="/docs/pt-BR/agents/skills/phantom">
    Desenvolvimento de dApps frontend — Phantom Connect SDK (React, React Native, navegador), token gating, pagamentos
  </Card>

  <Card title="Jupiter" icon="rocket" href="/docs/pt-BR/agents/skills/jupiter">
    Aplicações DeFi — trocas de tokens, empréstimos, ordens limitadas, DCA, dados de token/preço
  </Card>

  <Card title="DFlow" icon="chart-line" href="/docs/pt-BR/agents/skills/dflow">
    Aplicações de negociação — trocas spot, mercados de previsão, streaming em tempo real, Proof KYC
  </Card>

  <Card title="OKX" icon="chart-mixed" href="/docs/pt-BR/agents/skills/okx">
    Negociação e inteligência — agregação DEX OKX, sinais de dinheiro inteligente, análise de token meme
  </Card>

  <Card title="SVM" icon="microchip" href="/docs/pt-BR/agents/skills/svm">
    Internos do protocolo Solana — execução SVM, consenso, modelo de conta, economia dos validadores
  </Card>
</CardGroup>

## Como as Skills Funcionam

As Skills seguem uma arquitetura de prompt em 3 camadas:

| Camada         | O que                                                              | Onde                                                                                 |
| -------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------ |
| **A: Harness** | Comportamento específico do agente/runtime e regras de ferramentas | Integrado (Claude Code), `AGENTS.md` (Codex), preâmbulo em variantes de prompt (API) |
| **B: Skills**  | Procedimentos canônicos, reutilizáveis e independentes de modelo   | Arquivos `SKILL.md` + diretório `references/`                                        |
| **C: Task**    | Solicitação do usuário + contexto dinâmico                         | Fornecido em tempo de execução por cada plataforma                                   |

O conteúdo da skill (Camada B) é idêntico em todas as plataformas — apenas o invólucro de harness (Camada A) difere.

Cada skill inclui:

* **Lógica de roteamento** — mapeia sua solicitação para as ferramentas MCP corretas e arquivos de referência
* **Arquivos de referência** — documentação completa para cada produto Helius que a IA lê antes de escrever código
* **Regras** — previne erros comuns (por exemplo, taxas de prioridade fixas, endpoints RPC errados, falta de tratamento de erros)

## Usando Skills em Diferentes Plataformas

Cada skill vem com três variantes de prompts predefinidos em seu diretório `prompts/`:

| Arquivo               | Caso de Uso                                                          | Formato                                                                           |
| --------------------- | -------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| `openai.developer.md` | Respostas OpenAI / API de Conclusões de Chat                         | Preâmbulo da Camada A + conteúdo da skill com delimitadores `=== BEGIN SKILL ===` |
| `claude.system.md`    | Prompt de sistema Claude API                                         | Preâmbulo da Camada A + conteúdo da skill com delimitadores                       |
| `full.md`             | Regras Cursor, instruções personalizadas ChatGPT, outras ferramentas | Todos os arquivos de referência embutidos, sem dependências externas              |

Encontre-os em:

* **Repositório**: `.agents/skills/<skill>/prompts/`
* **Pacote npm**: `helius-mcp/system-prompts/<skill>/`

<Tabs>
  <Tab title="Vercel Skills CLI">
    Instale skills diretamente em seu agente de codificação IA usando o [Vercel Skills CLI](https://skills.sh/). Funciona com Claude Code, Cursor, Copilot, Codex e mais.

    ```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
    ```

    | Skill                                                                                       | Comando de Instalação                                |
    | ------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
    | **build** — Desenvolvimento central Solana (Sender, DAS, WebSockets, LaserStream, webhooks) | `npx skills add helius-labs/core-ai --skill build`   |
    | **phantom** — dApps frontend (Phantom Connect, React, token gating)                         | `npx skills add helius-labs/core-ai --skill phantom` |
    | **jupiter** — Apps DeFi (trocas, empréstimos, ordens limitadas, DCA)                        | `npx skills add helius-labs/core-ai --skill jupiter` |
    | **dflow** — Apps de negociação (trocas, mercados de previsão, streaming, KYC)               | `npx skills add helius-labs/core-ai --skill dflow`   |
    | **okx** — Negociação e inteligência (OKX DEX, dinheiro inteligente, scanner de memes)       | `npx skills add helius-labs/core-ai --skill okx`     |
    | **svm** — Internos de protocolo (motor SVM, consenso, modelo de conta)                      | `npx skills add helius-labs/core-ai --skill svm`     |
  </Tab>

  <Tab title="Claude Code Plugin">
    O [plugin Helius](/docs/pt-BR/agents/claude-code-plugin) agrupa todas as skills + servidores MCP em uma única instalação. Do registro curado pela Anthropic:

    ```bash theme={"system"}
    claude plugin install helius @claude-plugins-official
    ```

    Ou do marketplace Helius dentro do Claude Code:

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

    As Skills são invocadas com `/helius:build`, `/helius:phantom`, `/helius:jupiter`, `/helius:dflow`, `/helius:okx`, ou `/helius:svm`.
  </Tab>

  <Tab title="Claude Code Standalone">
    Cada skill pode ser instalada independentemente usando seu script `install.sh`:

    ```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
    ```

    Skills independentes são automaticamente invocadas como Skills de Agente — não é necessário comando de barra.
  </Tab>

  <Tab title="Codex CLI">
    Codex descobre automaticamente skills de `.agents/skills/` na raiz do seu projeto:

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

    As skills são acionadas implicitamente quando sua tarefa corresponde, ou explicitamente com `$helius`, `$helius-phantom`, `$helius-jupiter`, `$helius-dflow`, `$helius-okx`, ou `$svm`.
  </Tab>

  <Tab title="OpenAI API">
    Use `openai.developer.md` como uma mensagem `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"
    )
    ```

    Também funciona com Conclusões de Chat usando `{"role": "developer", "content": skill_prompt}`.
  </Tab>

  <Tab title="Claude API">
    Use `claude.system.md` como o prompt do sistema:

    ```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">
    Use `full.md` — ele embute todos os arquivos de referência para que não haja dependências externas.

    **Cursor:** Copie para `.cursor/rules/helius.md`:

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

    **Instruções Personalizadas ChatGPT:** Use o conteúdo central `SKILL.md` (o `full.md` pode exceder o limite de 8.000 caracteres do ChatGPT para skills maiores).
  </Tab>
</Tabs>

## Pré-requisitos

Todas as skills requerem que o [servidor Helius MCP](/docs/pt-BR/agents/mcp) esteja em execução (ou as ferramentas equivalentes configuradas em sua estrutura de agente). A skill DFlow requer adicionalmente o [servidor DFlow MCP](https://pond.dflow.net/build/mcp). A skill Phantom requer adicionalmente uma conta do [Phantom Portal](https://phantom.com/portal) para carteiras embutidas. A skill Jupiter requer uma [chave de API Jupiter](https://developers.jup.ag/portal). A skill OKX requer a [biblioteca de skills OKX](https://github.com/okx/onchainos-skills) e o CLI `onchainos`.

| Skill                                   | Requer                                                  | Chave de API Necessária                         |
| --------------------------------------- | ------------------------------------------------------- | ----------------------------------------------- |
| [Build](/docs/pt-BR/agents/skills/build)     | Helius MCP                                              | Sim (Helius)                                    |
| [Phantom](/docs/pt-BR/agents/skills/phantom) | Helius MCP                                              | Sim (Helius)                                    |
| [Jupiter](/docs/pt-BR/agents/skills/jupiter) | Helius MCP                                              | Sim (Helius + Jupiter)                          |
| [DFlow](/docs/pt-BR/agents/skills/dflow)     | Helius MCP + DFlow MCP                                  | Sim (Helius + DFlow para produção)              |
| [OKX](/docs/pt-BR/agents/skills/okx)         | Helius MCP + biblioteca de skills OKX + CLI `onchainos` | Sim (Helius; OKX opcional para desenvolvimento) |
| [SVM](/docs/pt-BR/agents/skills/svm)         | Helius MCP                                              | Não                                             |