# Usa CloneKit en cualquier IA

Lo conectas una vez. Desde ahí, tu IA puede buscar, leer y ejecutar kits con el know-how de expertos.

https://clonekit.ai/es/docs

## Qué es CloneKit

Un kit es la forma en que un experto hace un trabajo, escrita para que una IA la use. Un kit de lectura tiene archivos que tu IA lee. Un kit de ejecución tiene pasos que tu IA sigue con tus herramientas y cuentas. Al final, revisa el trabajo con las verificaciones del experto.

- Tu IA hace el trabajo. CloneKit le da el kit.
- Tu IA siempre recibe la versión más reciente.
- Cualquiera puede buscar. Para ejecutar, comprar o publicar necesitas una cuenta.

## Conecta tu IA

CloneKit es un solo servidor MCP para todos los kits. Agrega este link a tu app de IA. La primera vez, inicia sesión en CloneKit y toca Permitir.

Link del servidor MCP:

```
https://clonekit.ai/mcp
```

### Claude

Abre Configuración → Conectores y elige “Agregar conector personalizado”. Pega el link e inicia sesión en CloneKit (toca Permitir).

[Abrir configuración](https://claude.ai/settings/connectors)

### ChatGPT

Abre Configuración → Apps y conectores → Avanzado y activa el modo de desarrollador. Crea un conector con el link e inicia sesión en CloneKit (toca Permitir).

[Abrir configuración](https://chatgpt.com/#settings/Connectors)

### Grok

Abre Conectores y elige Nuevo conector → Personalizado. Pega el link e inicia sesión en CloneKit (toca Permitir).

[Abrir configuración](https://grok.com/connectors)

### Cursor

Toca el botón: Cursor se abre y te pide instalar CloneKit. Inicia sesión en CloneKit cuando Cursor te lo pida.

[Agregar a Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=clonekit&config=eyJ1cmwiOiJodHRwczovL2Nsb25la2l0LmFpL21jcCJ9)

### VS Code

Toca el botón: VS Code se abre y te pide instalar CloneKit. Inicia sesión en CloneKit cuando te lo pida.

[Agregar a VS Code](vscode:mcp/install?%7B%22name%22%3A%22clonekit%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fclonekit.ai%2Fmcp%22%7D)

### Claude Code

Ejecuta este comando en tu terminal y después abre Claude Code.

```sh
claude mcp add --transport http clonekit https://clonekit.ai/mcp
```

### Codex

Ejecuta este comando en tu terminal y después abre Codex.

```sh
codex mcp add clonekit --url https://clonekit.ai/mcp
```

### Cualquier otra IA

Ejecuta este comando en tu terminal y elige tus apps (Windsurf, Gemini CLI, Zed, Goose y más).

```sh
npx add-mcp https://clonekit.ai/mcp --name clonekit
```

Luego pídele a tu IA: **“Busca en CloneKit un kit que me ayude a escribir el brief de un proyecto.”**

¿Tu app no tiene inicio de sesión? Crea una clave de API en [Panel → Conexiones](https://clonekit.ai/es/dashboard/connections) y envíala como `Authorization: Bearer ck_…`.

¿Solo quieres explorar? `https://clonekit.ai/mcp/read` es de solo lectura: busca kits y lee los gratis, sin iniciar sesión.

## CLI

Con la CLI buscas, creas y publicas kits desde tu terminal. Necesita Node.js 18 o superior. Úsala con npx o instálala una sola vez.

Conecta CloneKit a tus apps de IA:

```sh
npx clonekit-cli setup
```

Inicia sesión:

```sh
npx clonekit-cli login
```

Busca un kit:

```sh
npx clonekit-cli search "landing page design"
```

O instálala una vez. Después escribe clonekit:

```sh
npm install -g clonekit-cli
```

Mira todos los comandos:

```sh
npx clonekit-cli --help
```

## Skills

Los kits y las Agent Skills (carpetas con un SKILL.md) funcionan juntos. Convierte una skill en kit o descarga un kit como skill.

### Llévate un kit como skill

Cualquier kit de lectura gratis se descarga como una carpeta con un SKILL.md:

```sh
npx clonekit-cli export @creator/kit-name
```

Después copia la carpeta en `~/.claude/skills/` o en la carpeta de skills de tu agente.

### Convierte una skill en kit

¿Tienes una carpeta con un SKILL.md, un AGENTS.md o un repo público de GitHub? Impórtalo como borrador de kit. También puedes pegar el link de GitHub en el chat y pedirle a tu IA que lo importe.

```sh
npx clonekit-cli import ./my-skill
```

## Crea y publica un kit

### Con tu IA

Conecta CloneKit, abre un chat nuevo y escribe:

```
Entrevístame y escribe mi kit de CloneKit.
```

Tu IA te hace una pregunta a la vez y te muestra una vista previa antes de publicar.

### A mano

Escribe el kit.yaml y tus archivos, revísalos y publica. Antes ves una vista previa.

```sh
npx clonekit-cli init my-kit
npx clonekit-cli validate ./my-kit
npx clonekit-cli publish ./my-kit
```

### Revisiones antes de publicar

- Cada kit pasa por una revisión automática de seguridad. Los kits gratis se publican en cuanto la pasan.
- Los kits de pago también necesitan tu prueba y una revisión a fondo con agentes.
- Si hay algo que corregir, te mostramos qué y por qué. Lo corriges y vuelves a publicar.

### Quién puede verlo

- `public`: Aparece en la búsqueda y en /kits. Cualquiera puede usarlo.
- `unlisted`: Cualquiera con el link puede usarlo. No aparece en la búsqueda ni en /kits.
- `private`: Solo tú, o los miembros de tu organización.

Para vender un kit necesitas Pro o Max. [Mira los precios](https://clonekit.ai/es/pricing).

## Campos de kit.yaml

Un kit es una carpeta con un `kit.yaml` y sus archivos. Necesitas `id`, `title`, `listing` y contenido: archivos que tu IA lee (como README.md), pasos que ejecuta, o ambos.

### Un kit mínimo

```yaml
id: "@tu-nombre/brief-de-proyecto"
title: "Escribe el brief de un proyecto"
listing: "Un brief de una página a partir de tus notas: el objetivo, el público y el siguiente paso."
language: es

# El know-how va en README.md, junto a kit.yaml.
```

### Agrega pasos para que sea un kit de ejecución

```yaml
deliverables: ["Un brief de proyecto"]
build:
  - id: escribir-brief
    step: "Escribe el brief"
    instructions: "Usa las notas del usuario. Indica el objetivo, el público y el siguiente paso."
    check: "El brief incluye los tres."
review:
  - "El brief coincide con las notas del usuario."
```

### Obligatorios

- `id`: El nombre del kit: "@tu-nombre/nombre-del-kit". Letras minúsculas, números y guiones.
- `title`: El nombre que ve la gente. De 3 a 80 caracteres.
- `listing`: Lo que recibe la persona, en palabras simples y en unos 200 caracteres (de 20 a 400). Escribe {id-de-herramienta} o {id-de-referencia} solo para una herramienta o referencia que el kit usa de verdad: aparece como etiqueta con su logo. Sin etiquetas también está bien. Sin links ni promesas de resultados.

### Sobre el kit

- `about`: Opcional, para agentes de IA y la búsqueda: para quién es el kit, cuándo usarlo, cuándo no y qué necesita. Hasta 1.000 caracteres. No aparece en las tarjetas.
- `version`: Como "1.2.0". Empieza en 1.0.0. Súbela para publicar una versión nueva.
- `mode`: read o run. Es opcional: con pasos (build) es un kit de ejecución; sin pasos, uno de lectura.
- `domain`: marketing, design, engineering, operations, sales, content, finance u other (el valor por defecto).
- `language`: El idioma en que está escrito el kit: en (por defecto) o es.
- `i18n`: El título y el listing traducidos, por idioma, como i18n: {en: {title, listing}}. Usa los mismos {ids} que en el listing.

### Herramientas y referencias

- `tools`: Las apps que usa el kit. Cada una lleva un id y una url. Opcionales: name, mcp (un link https de MCP o un id del MCP Registry, nunca un comando), required (true por defecto), alternatives (ids de otras herramientas), recommended y est_cost.
- `refs`: Skills, fuentes y plantillas que usa el kit: id, name y kind (skill, source o template), y si quieres url y note.
- `examples`: Resultados reales que se muestran en la página del kit: type (image, video, audio, before_after o doc), src dentro de examples/ y caption. Opcionales: poster, before, input y aspect.

### Pasos de ejecución

- `understand`: Las preguntas que tu IA hace primero: ask, y si quieres id, why y changes.
- `choose`: Las decisiones que toma el usuario: id, question y de 2 a 10 options (id, label, y si quieres asset y note).
- `build`: Los pasos: id, step (un título corto) e instructions (texto o la ruta de un archivo). Opcionales: tool, check y approval: true para los pasos con efectos reales.
- `deliverables`: Lo que entrega un kit de ejecución. Necesita al menos uno.
- `review`: Las verificaciones finales que hace tu IA antes de terminar.

### Qué aporta y qué recibe el usuario

- `inputs`: Lo que el usuario necesita tener.
- `outputs`: Lo que el usuario recibe.
- `guardrails`: Las reglas que tu IA respeta de principio a fin.

### Precio y versiones

- `pricing`: model: free (por defecto) o one_time con amount_usd. client_use_usd agrega un precio más alto para trabajo con clientes.
- `license`: own_use (por defecto) o client_use.
- `refund`: Obligatorio en kits de pago: 7_days, deliverables_not_produced (kits de ejecución) o none.
- `changelog`: Qué cambió. Una línea, o una lista de versiones, de la más reciente a la más antigua: version y summary, y si quieres date y changes. Cada versión nueva necesita su entrada.

Los links solo van en `tools[].url` y `refs[].url`. El resto del texto del kit no puede tener links.

Revisa la carpeta del kit antes de publicar:

```sh
npx clonekit-cli validate ./my-kit
```
