> For the complete documentation index, see [llms.txt](https://minara.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://minara.ai/docs/minara-handbook/es/operar/minara-skills.md).

# Habilidades

## ¿Qué es Minara Skills?

Minara Skills es el paquete oficial de habilidades que da a cualquier agente de IA compatible acceso al trading de criptomonedas y acciones, ejecución on-chain e inteligencia de mercado. Una vez instalado, tu agente puede analizar y operar con criptomonedas, acciones de EE. UU., materias primas y forex; ejecutar transacciones on-chain en EVM, Solana y Hyperliquid; gestionar wallets y la entrada con tarjeta de crédito; y obtener inteligencia de mercado en tiempo real, todo ello hablándole en lenguaje natural.

Minara Skills se ejecuta sobre [Minara CLI](https://www.npmjs.com/package/minara) y se entrega como un paquete listo para usar para [Claude Code](https://claude.com/claude-code), [OpenClaw](https://docs.openclaw.ai/tools/skills) y [Hermes](https://hermes-agent.nousresearch.com/).

**Lo que puedes hacer con Minara Skills:**

* Comprar, vender, intercambiar, convertir y transferir activos spot por ticker, nombre del token o dirección de contrato en 19 redes
* Abrir y cerrar posiciones de futuros perpetuos en Hyperliquid con apalancamiento, gestión de múltiples wallets y piloto automático de IA
* Colocar, listar y cancelar órdenes límite para spot y perps
* Depositar, retirar y transferir entre wallets spot y perps, incluida la entrada con tarjeta de crédito a través de MoonPay
* Obtener datos on-chain, fundamentos de tokens, flujos de ballenas, tokens y acciones en tendencia, análisis de renta variable, materias primas y forex
* Pagar [x402](https://www.x402.org/)API HTTP habilitadas directamente desde la wallet de Minara
* Gestionar tu suscripción de Minara, créditos y plan premium

***

## ¿Para quién es Minara Skills?

| Tipo de usuario                 | Nivel de experiencia                              | Cómo usarlo                                                                                                                                           |
| ------------------------------- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Traders minoristas**          | Cualquiera                                        | Háblale a tu agente en inglés sencillo: *"Compra 100 USDC de ETH"*, *"Abrir largo en ETH perp 5x"*, *"¿Qué está en tendencia hoy?"*                   |
| **Usuarios avanzados y quants** | Cómodos con CLIs                                  | Controla la [Minara CLI](https://www.npmjs.com/package/minara) directamente para scripting, trabajos por lotes y flujos de trabajo reproducibles      |
| **Desarrolladores de agentes**  | Construyendo sobre Claude Code, OpenClaw o Hermes | Añade el paquete de habilidades al directorio de habilidades de tu agente y usa Minara como una herramienta de primera clase; sin código de pegamento |

***

## Cómo acceder

Minara Skills se distribuye a través de GitHub: [github.com/Minara-AI/skills](https://github.com/Minara-AI/skills).

Instálalo en uno de los tres entornos de ejecución de agentes compatibles (Claude Code, OpenClaw o Hermes) usando el instalador con un clic de ese entorno; luego ejecuta `Inicia sesión en Minara` desde dentro del agente para autenticarte.

Necesitarás:

* Una instalación funcional de Claude Code, OpenClaw o Hermes
* Node.js (para `npm install -g minara`)
* Una cuenta de Minara ([minara.ai](https://minara.ai))

***

## Instalación

Elige el instalador que coincida con tu agente. Cada script de un clic instala la CLI de Minara desde npm, copia los archivos de habilidades al directorio de habilidades del agente e inicia el flujo de inicio de sesión.

### Claude Code

Envía este prompt a tu agente Claude Code:

```
Ejecuta "curl -fsSL https://raw.githubusercontent.com/Minara-AI/skills/main/scripts/claudecode-minara-skill-setup.sh | bash" para instalar Minara CLI, Minara Skills y establecer la siguiente configuración. Sigue la URL de inicio de sesión cuando se te indique.
```

Esto instala Minara CLI globalmente, copia la habilidad a `~/.claude/skills/minara`y abre la URL de inicio de sesión en tu navegador.

**Instalación manual:**

```bash
npm install -g minara@latest
git clone https://github.com/Minara-AI/skills.git /tmp/minara-skills
cp -r /tmp/minara-skills/skills/minara ~/.claude/skills/minara
```

### OpenClaw

Envía este prompt a tu agente OpenClaw:

```
Ejecuta "curl -fsSL https://raw.githubusercontent.com/Minara-AI/skills/main/scripts/openclaw-minara-skill-setup.sh | bash" para instalar Minara CLI, Minara Skills y establecer la siguiente configuración. Sigue la URL de inicio de sesión cuando se te indique.
```

Esto instala la CLI, copia la habilidad a `~/.openclaw/skills/minara`registra la habilidad en `openclaw.json`y empieza el inicio de sesión.

**ClawHub:**

```bash
clawhub install lowesyang/minara
```

**Instalación manual:** clona el repositorio, copia `skills/minara` a tu espacio de trabajo de OpenClaw, luego añade la habilidad a `~/.openclaw/openclaw.json`:

```json
{
  "skills": {
    "entries": {
      "minara": {
        "enabled": true
      }
    }
  }
}
```

### Hermes

Envía este prompt a tu agente Hermes:

```
Ejecuta "curl -fsSL https://raw.githubusercontent.com/Minara-AI/skills/main/scripts/hermes-minara-skill-setup.sh | bash" para instalar Minara CLI, Minara Skills y establecer la siguiente configuración. Sigue la URL de inicio de sesión cuando se te indique.
```

Esto instala la Minara CLI, copia la habilidad a `~/.hermes/skills/minara`y comienza el flujo de inicio de sesión.

Todos los scripts de configuración son idempotentes. Admiten una estrategia de respaldo de descarga de habilidades en tres niveles: ClawHub → GitHub → CLI de clawhub.

***

## Flujo del primer uso

La forma más rápida de validar que la instalación funcionó de principio a fin. Tres comandos te llevan de una instalación nueva a tu primera operación.

{% stepper %}
{% step %}
**Inicia sesión**

Dile al agente: *"Inicia sesión en Minara"*. El agente ejecuta el comando de inicio de sesión de la CLI y abre una pestaña del navegador. Autentícate con tu cuenta de Minara; la CLI guarda la sesión localmente.
{% endstep %}

{% step %}
**Financia tu wallet**

Dile al agente: *"Muestra mi dirección de depósito de Minara"* para depositar criptomonedas existentes, o *"Comprar criptomonedas con tarjeta de crédito"* para hacer la entrada vía MoonPay. Para operar con perps, sigue con *"Deposita 500 USDC en perps"* para mover fondos de spot a la wallet de perps de Hyperliquid.
{% endstep %}

{% step %}
**Operar**

Dile al agente lo que quieres: *"Compra ETH por valor de 100 USDC"*, *"Intercambia 0.1 ETH a USDC"*&#x6F; *"Abrir largo en ETH perp, apalancamiento 5x"*. El agente confirma los detalles de la operación antes de ejecutarla. Revisa cuidadosamente la **divulgación de riesgos** antes de aprobar.
{% endstep %}
{% endstepper %}

***

## Trading spot

El trading spot cubre comprar, vender, intercambiar, convertir y transferir tokens en todas las [redes compatibles](#supported-networks). Puedes referirte a los activos por ticker (`ETH`, `SOL`), nombre (`ethereum`), o dirección de contrato.

**Ejemplos:**

* *"Compra ETH por valor de 100 USDC"*
* *"Vende todo mi SOL"*
* *"Intercambia 0.1 ETH a USDC en Base"*
* *"Transfiere 50 USDC a 0xabc..."*

El agente elige la red y el enrutamiento correctos según los saldos de tu wallet y el activo.

***

## Futuros perpetuos

Los futuros perpetuos se enrutan a través de Hyperliquid. Puedes abrir y cerrar posiciones, establecer apalancamiento, gestionar varias wallets y ver el historial de operaciones.

**Ejemplos:**

* *"Abrir largo en ETH perp"*
* *"Abrir corto en BTC, apalancamiento 10x"*
* *"Cierra mi posición en ETH"*
* *"Muestra mi historial de perps"*

### Piloto automático de IA

El piloto automático permite que el agente gestione posiciones de perps por ti según una estrategia. Actívalo con *"Activa el piloto automático de IA para perps"*. El piloto automático solo actúa dentro del alcance que autorizas, y puedes desactivarlo en cualquier momento.

> **Riesgo:** Los futuros perpetuos son productos apalancados. Las pérdidas pueden superar tu margen inicial. Revisa la divulgación de riesgos antes de activar el piloto automático o abrir posiciones apalancadas.

***

## Órdenes límite

Las órdenes límite funcionan tanto en spot como en perps. Coloca una orden, lista las órdenes abiertas y cancela por ID.

**Ejemplos:**

* *"Compra ETH cuando el precio llegue a $3000"*
* *"Compra SOL a $150"*
* *"Lista mis órdenes límite"*
* *"Cancela la orden límite \[id]"*

***

## Wallet y fondos

| Acción                         | Ejemplos de prompts                                                                     |
| ------------------------------ | --------------------------------------------------------------------------------------- |
| **Consultar saldo**            | *"¿Cuál es mi saldo?"* / *"Muestra mi cartera de criptomonedas"*                        |
| **Depósito**                   | *"Muestra mi dirección de depósito"* / *"Comprar criptomonedas con tarjeta de crédito"* |
| **Transferencia Spot ↔ Perps** | *"Deposita 500 USDC en perps"* / *"Retira 200 USDC de perps"*                           |
| **Retiro on-chain**            | *"Retira 10 SOL a \[dirección]"*                                                        |
| **Pagar**                      | *"Paga 100 USDC a \[dirección]"*                                                        |

La entrada con tarjeta de crédito usa MoonPay. Los retiros a direcciones externas se realizan on-chain y generan la tarifa estándar de red.

***

## Inteligencia de mercado

Minara Skills expone a tu agente toda la pila de inteligencia de mercado de Minara: datos on-chain en tiempo real, fundamentos de tokens, flujos de ballenas, tokens y acciones en tendencia, análisis de renta variable, materias primas y forex.

**Ejemplos:**

* *"¿Qué tokens están en tendencia?"*
* *"Busca tokens SOL"*
* *"Muéstrame los flujos de ballenas en ETH"*
* *"¿Cuál es la perspectiva de NVDA?"*
* *"Precio del oro ahora mismo"*

***

## Pagos x402

Minara Skills puede pagar [x402](https://www.x402.org/)APIs HTTP habilitadas directamente desde tu wallet de Minara. Esto permite que tu agente llame a APIs de pago sin que tengas que gestionar claves API o recargas por separado.

La CLI gestiona el intercambio x402; solo verás que el agente pide confirmación cuando una llamada de pago esté a punto de liquidarse.

***

## Premium

Gestiona tu suscripción de Minara, saldo de créditos y plan desde dentro del agente.

**Ejemplos:**

* *"Muestra mis créditos"*
* *"Actualiza mi plan de Minara"*
* *"¿En qué plan estoy?"*

***

## Redes compatibles

El trading spot y las operaciones on-chain están disponibles en:

Ethereum, Base, Arbitrum, Optimism, Polygon, Avalanche, Solana, BSC, Berachain, Blast, Manta, Mode, Sonic, Conflux, Merlin, Monad, Polymarket, XLayer.

Los futuros perpetuos se enrutan a través de Hyperliquid.

***

## Benchmark

Minara Skills obtuvo una puntuación de **88/100** en [crypto-skill-bench](https://github.com/Minara-AI/crypto-skill-benchmark) v3.0.2, evaluado en Claude Sonnet 4.6 en 76 escenarios.

| Dimensión    | Puntuación |
| ------------ | ---------- |
| Seguridad    | 91         |
| Cobertura    | 86         |
| Robustez     | 88         |
| Enrutamiento | 88         |
| UX           | 86         |

66 escenarios aprobados, 10 parciales, 0 fallidos. Puerta de seguridad: APROBADA.

El benchmark es de código abierto. Puedes reproducir la ejecución, inspeccionar cada escenario y compararlo con otros paquetes de habilidades.

***

## Qué puede y qué no puede hacer Minara Skills

### Lo que puedes definir

* El entorno de ejecución del agente (Claude Code, OpenClaw o Hermes)
* Las redes y los activos con los que quieres operar
* Si habilitar el piloto automático de IA para perps y dentro de qué alcance
* Los precios de las órdenes límite, los niveles de apalancamiento y las asignaciones de margen
* Si financiar mediante depósito on-chain o entrada con tarjeta de crédito

### Lo que controla la plataforma

* Enrutamiento de órdenes y selección de mercado
* Tarifas de red y tiempos de confirmación on-chain
* Liquidez de Hyperliquid, tasas de financiación y lógica de liquidación para perps
* La verificación KYC y los precios de MoonPay para la entrada con tarjeta de crédito
* Actualizaciones de versión de la habilidad (gestionadas por `version-check.sh` por sesión)

### Limitaciones actuales

* La habilidad está vinculada a los tres entornos de ejecución compatibles; otros marcos de agentes aún no están integrados.
* No se admiten depósitos directos en la wallet de perps. Los fondos deben llegar primero a spot y luego transferirse.
* Hyperliquid cobra una comisión de 1 USDT por los retiros de perps; la habilidad no la exime.
* Los futuros perpetuos solo están disponibles en Hyperliquid. Actualmente no se enrutan otros mercados de perps.
* Algunos tipos de órdenes avanzadas (TWAP, iceberg) no se exponen mediante prompts en lenguaje natural.

***

## Consejos para mejores resultados

1. **Sé específico con las cantidades y los activos.** *"Compra 100 USDC de ETH"* es inequívoco; *"compra algo de ETH"* activará una ronda de aclaración.
2. **Nombra la red cuando tengas dudas.** *"Intercambia 0.1 ETH a USDC en Base"* evita que el agente tenga que inferir el enrutamiento.
3. **Confirma antes de aprobar.** El agente siempre muestra los detalles de la operación antes de ejecutarla. Léelos; rechaza si algo parece incorrecto.
4. **Empieza poco a poco.** Valida la instalación con un intercambio de 5 $ antes de mover una cantidad real.
5. **Usa órdenes límite para las entradas que te importan.** Las órdenes de mercado son más rápidas pero menos precisas en pares con poca liquidez.
6. **Mantén la CLI actualizada.** Ejecuta `minara --version` y compáralo con npm; el nivel de sesión `version-check.sh` script señala las actualizaciones automáticamente.
7. **Autoriza el piloto automático en un alcance que comprendas.** Empieza con un solo activo y una pequeña asignación de margen antes de escalar.

***

## Avisos

* Todo trading implica riesgo. Opera solo con fondos que puedas permitirte perder.
* Los futuros perpetuos son productos apalancados. Las pérdidas pueden superar tu margen inicial.
* Minara Skills es una herramienta que permite a tu agente operar la plataforma de Minara. No es asesoramiento financiero.
* Minara **no** proporciona liquidez ni actúa como contraparte. Las rutas spot pasan por mercados externos; los perps se ejecutan en Hyperliquid.
* Tú conservas el control total. Puedes desactivar el piloto automático, cancelar órdenes límite o retirar fondos en cualquier momento.
* El rendimiento histórico del benchmark no garantiza resultados futuros.

***

## Enlaces

* Repositorio: [github.com/Minara-AI/skills](https://github.com/Minara-AI/skills)
* CLI en npm: [npmjs.com/package/minara](https://www.npmjs.com/package/minara)
* Benchmark: [github.com/Minara-AI/crypto-skill-benchmark](https://github.com/Minara-AI/crypto-skill-benchmark)
* Licencia: MIT


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://minara.ai/docs/minara-handbook/es/operar/minara-skills.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
