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

# Personalizaciones de Devin Local

> Amplía el agente de Devin Local en Devin Desktop con rules, skills, plugins, servidores MCP y hooks, y consulta qué ha cargado cada sesión.

Devin Local ofrece varias formas de personalizar cómo trabaja el agente en tus proyectos. Usa esta tabla para elegir la más adecuada:

| Funcionalidad | Qué hace | Cómo se activa | Cuándo usarla |
| - | - | - | - |
| **[Rules](#rules)** | Indican al agente *cómo comportarse* (p. ej., «usa bun, no npm») | Siempre activas o mediante el frontmatter `trigger` | Convenciones de código, guías de estilo, restricciones del proyecto |
| **[Skills](#skills)** | Procedimientos multi-step empaquetados con archivos auxiliares (scripts, plantillas) | Las invoca el modelo cuando son pertinentes, o tú mismo | Tareas complejas en las que el agente necesita archivos de referencia |
| **[Plugins](#plugins)** | Paquetes instalables de skills, rules, hooks, servidores MCP y subagentes | Se instalan una sola vez y se comparten entre proyectos y equipos | Distribuir un conjunto de personalizaciones |
| **[Servidores MCP](#mcp-servers)** | Ofrecen al agente herramientas de servicios externos | Se configuran por proyecto o por usuario | Gestores de incidencias, herramientas de diseño, APIs internas |
| **[Hooks](#hooks)** | Ejecutan comandos de shell o prompts en eventos del ciclo de vida del agente | Se configuran por proyecto o por usuario | Aplicación de políticas, registro, formateadores, notificaciones |

Como Devin Local comparte su entorno de agente con [Devin CLI](https://cli.devin.ai), todas las personalizaciones usan el formato y el mecanismo de descubrimiento de Devin CLI, de modo que una personalización que escribas para uno funciona también en el otro.

Para reutilizar las reglas del proyecto y los flujos de trabajo de otro agente tanto en Desktop como en Cloud, empieza con el [prompt de migración](https://docs.devinenterprise.com/es/onboard-devin/migrate-from-other-agents.md).

## Personalizar

La página **Personalizar** de la ventana de agentes incluye las pestañas **Plugins**, **Habilidades**, **MCPs**, **Hooks**, **Rules** y **Subagentes**. Cada pestaña muestra lo que el agente tiene cargado, además de lo que ofrecen tu repositorio, tu organización y tu cuenta.

Para abrirla, haz clic en **Personalizar** en la barra lateral del agente.

## Rules

Las Rules son instrucciones persistentes que definen cómo se comporta el agente en tu proyecto. Se incorporan al contexto del agente al inicio de cada sesión, lo que garantiza un comportamiento coherente en todo tu equipo.

Entre los usos habituales de las reglas se encuentran los estándares de código, las directrices de arquitectura, las bibliotecas preferidas, las convenciones de pruebas y las restricciones específicas del proyecto.

### AGENTS.md

La forma más sencilla de agregar reglas es crear un archivo `AGENTS.md` en la raíz de tu proyecto. Usa Markdown simple, sin frontmatter:

```markdown theme={null}
# Reglas del proyecto

- Usa TypeScript en todos los archivos nuevos
- Sigue los patrones existentes en src/components/
- Ejecuta siempre `npm run lint` antes de confirmar cambios
- Usa pnpm, no npm ni yarn
```

`AGENTS.md`, `AGENTS.local.md` (para reglas personales que mantienes fuera del control de versiones) y `AGENT.md` se leen como reglas siempre activas. El agente los lee en la raíz del espacio de trabajo y en cada directorio situado entre la raíz del espacio de trabajo y el directorio en el que está trabajando, por lo que un `AGENTS.md` en un subdirectorio aporta instrucciones específicas para ese directorio.

### Archivos de Rules

Para tener más control, coloca una regla por archivo en `.devin/rules/*.md`. Cada archivo puede indicar cuándo se aplica mediante el campo `trigger` del frontmatter:

```markdown theme={null}
---
trigger: glob
globs: "**/*.test.ts"
---

Todos los archivos de prueba deben usar bloques `describe`/`it` y simular las llamadas a API externas.
```

| Valor de `trigger:` | Cuándo llega la regla al agente |
| - | - |
| `always_on` | En todas las sesiones |
| `glob` | Cuando el agente trabaja con archivos que coinciden con `globs` |
| `model_decision` | Cuando el agente determina que la descripción de la regla es pertinente |
| `manual` | Solo cuando la invocas |

`.devin/global_rules.md` es un único archivo siempre activo. Coloca los mismos archivos en tu directorio de inicio (`~/.devin/rules/*.md`, `~/.devin/global_rules.md`) para aplicarlos a todos los proyectos.

Los archivos legacy `.windsurf/rules/*.md`, `.windsurf/global_rules.md` y `.windsurfrules` se importan de forma predeterminada. Se cargan los archivos de reglas de `.devin/rules/` y de `.windsurf/rules/`; si existen ambos archivos `global_rules.md`, solo se carga `.devin/global_rules.md`. Consulta [reglas y AGENTS.md](https://docs.devinenterprise.com/es/cli/extensibility/rules.md) para ver la lista completa de archivos, la configuración de importación y las reglas de otras herramientas.

### Prácticas recomendadas

* Mantén las reglas breves y específicas. Las reglas forman parte del contexto de cada sesión, por lo que consumen tokens en cada mensaje.
* Recurre preferentemente a una skill para todo lo que el agente solo necesite en ocasiones, y usa una regla para indicarle qué skills debe usar en escenarios concretos.
* Da formato a las reglas con viñetas, listas numeradas y encabezados de Markdown. Son más fáciles de seguir que un párrafo largo.
* Evita reglas genéricas como «escribe buen código».

## Skills

Las tareas de ingeniería más complejas suelen requerir algo más que buenos prompts. Pueden necesitar scripts de referencia, plantillas, listas de comprobación y otros archivos auxiliares. Las skills te permiten agrupar todo esto en carpetas que el agente puede invocar.

Las skills usan **divulgación progresiva**: de forma predeterminada, el modelo solo ve el `name` y la `description` de la skill. El contenido completo de `SKILL.md` y los archivos auxiliares solo se cargan cuando el agente decide invocar la skill o cuando la invocas tú. Así, tu ventana de contexto se mantiene ligera aunque tengas muchas skills definidas.

### Crear un skill

Crea un directorio con un archivo `SKILL.md` cuyo frontmatter YAML defina el nombre y la descripción del skill:

```markdown theme={null}
---
name: deploy-to-production
description: Guides the deployment process to production with safety checks
---

## Lista de verificación previa al despliegue
1. Ejecutar todas las pruebas
2. Comprobar si hay cambios sin confirmar
3. Verificar las variables de entorno

## Pasos del despliegue
Sigue estos pasos para desplegar de forma segura...
```

* **name**: Identificador único de la skill (letras minúsculas, números y guiones). Se usa para invocarla.
* **description**: Breve explicación que se muestra al modelo para ayudarle a decidir cuándo invocar la skill. Indica de forma específica qué hace la skill y cuándo usarla.

Coloca los archivos auxiliares en la carpeta de la skill, junto a `SKILL.md`. El agente tendrá acceso a ellos cuando se invoque la skill:

```
.devin/skills/deploy-to-production/
├── SKILL.md
├── deployment-checklist.md
├── rollback-procedure.md
└── config-template.yaml
```

### Invocación de skills

Cuando tu solicitud coincide con la descripción de una skill, el agente la invoca automáticamente y sigue sus instrucciones. También puedes invocar una skill por su nombre con `/skill-name` para asegurarte de que se use.

### Ámbitos de las skills

| Ámbito | Ubicación | Disponibilidad |
| - | - | - |
| Workspace | `.devin/skills/<name>/` (también se leen `.agents/skills/` y el directorio legacy `.windsurf/skills/`) | Solo el workspace actual. Se confirma junto con tu repositorio. |
| Global | `~/.config/devin/skills/<name>/` (también se lee `~/.agents/skills/`) | Todos los workspaces de tu máquina. No se confirma. |
| Plugin | Dentro de un [plugin](#plugins) instalado | Allí donde esté instalado el plugin. |

Consulta la [documentación de skills de Devin CLI](https://docs.devinenterprise.com/es/cli/extensibility/skills/overview.md) para obtener información sobre los desencadenadores de skills, los permisos y las skills de terceros, y [Creación de skills](https://docs.devinenterprise.com/es/cli/extensibility/skills/creating-skills.md) para ver instrucciones sobre cómo crearlas.

## Plugins

Los Plugins son paquetes instalables que aportan skills, reglas, hooks, servidores MCP y subagentes al agente. Puedes instalar un plugin desde un repositorio de GitHub, una URL de git, una subcarpeta de un repositorio o una carpeta local; sus skills quedan disponibles como comandos `/<plugin>:<skill>`. Consulta [plugins](https://docs.devinenterprise.com/es/cli/extensibility/plugins/overview.md) para obtener información sobre el formato de los plugins, los comandos `devin plugins` y la gobernanza.

> [!WARNING]
>
> Aquí, **Plugins** hace referencia a los plugins del *agente* de Devin. No tienen nada que ver con los [plugins de Windsurf](https://docs.devinenterprise.com/es/windsurf/plugins/getting-started.md), que llevan Devin a JetBrains, VS Code y otros editores, ni con las [extensiones del editor](https://docs.devinenterprise.com/es/desktop/recommended-extensions.md) que instalas en Devin Desktop: ambos amplían el IDE, no el agente.

## Servidores MCP

**MCP (Model Context Protocol)** es un protocolo que permite al agente usar herramientas de servicios externos, como GitHub, bases de datos y sistemas de seguimiento de incidencias. Consulta la [documentación oficial de MCP](https://modelcontextprotocol.io/) para obtener más información.

### Instalar servidores MCP

Abre la página **Customize** desde la ventana Agents y haz clic en **MCPs**. Elige el ámbito con el selector **Install MCPs for** de la parte superior, por ejemplo, **This computer**.

* **This computer** muestra los servidores que tu agente local carga para las carpetas abiertas en la ventana. Puedes activar o desactivar un servidor, abrir su archivo de configuración o actualizar la lista.
* **Available** muestra los servidores de tus registros MCP. Haz clic en **Install** en un servidor para agregarlo.

Los Admin de Enterprise gestionan los registros en la configuración del equipo, en **MCP & ACP**. La pestaña **MCP registry** incluye un interruptor que permite, además de los de la lista de permitidos de MCP, los servidores que coincidan con una entrada del registro, y una opción **Registry** (**Configure**) para indicar las URL de los registros. Cuando hay varios registros configurados, Devin Desktop usa la unión de todos ellos. Los registros personalizados deben seguir el [esquema oficial del registro MCP](https://modelcontextprotocol.io/).

### Configuración

Los servidores MCP se configuran en [archivos de configuración](https://docs.devinenterprise.com/es/cli/extensibility/mcp/configuration.md) de tu máquina local. La ubicación del archivo depende del ámbito:

| Ámbito | Ubicación | ¿Se comparte con el equipo? |
| - | - | - |
| Proyecto | `.devin/mcp_config.json` | Sí (se incluye en el control de versiones) |
| Anulación local | `.devin/mcp_config.local.json` | No (excluido mediante las reglas de Git) |
| Usuario | `~/.config/devin/mcp_config.json` | No |

Devin Local admite los transportes `stdio`, `Streamable HTTP` y `SSE`, además de OAuth para cada uno de ellos.

### Permisos

De forma predeterminada, el agente solicita aprobación antes de llamar a cualquier herramienta MCP. Consulta [Permisos de MCP](https://docs.devinenterprise.com/es/desktop/devin-local/permissions.md#mcp-permissions) para saber cómo permitir una herramienta o un servidor, y cómo los administradores pueden permitir de forma predeterminada las integraciones de confianza.

### Reautenticación

Cuando caducan las credenciales de OAuth almacenadas de un servidor, este muestra el estado **Needs authentication**. Este estado aparece en la lista **This computer**, en la card **Available** y en la página de detalles del servidor.

Haz clic en **Authenticate** para borrar las credenciales almacenadas y volver a ejecutar el flujo de autorización en el navegador.

## Hooks

Los hooks ejecutan lógica personalizada en determinados eventos del ciclo de vida del agente, por ejemplo, antes de una llamada a herramienta. Cada hook es un comando de shell o un prompt para un LLM. Usa hooks para hacer cumplir políticas, agregar contexto, registrar acciones, modificar permisos o integrarte con sistemas externos.

Los hooks se configuran en `.devin/hooks.v1.json`, ya sea en tu proyecto o a nivel de usuario. Por ejemplo, este hook ejecuta un script antes de cada comando de shell y puede bloquear el comando:

```json theme={null}
{
  "PreToolUse": [
    {
      "matcher": "exec",
      "hooks": [
        {
          "type": "command",
          "command": "./scripts/check-command.sh"
        }
      ]
    }
  ]
}
```

Los hooks no se cargan ni se ejecutan mientras un workspace está abierto en [Modo Restringido](https://docs.devinenterprise.com/es/desktop/devin-local/overview.md#restricted-mode).

Consulta [hooks](https://docs.devinenterprise.com/es/cli/extensibility/hooks/overview.md) para ver los eventos de hook, el formato de configuración, los códigos de salida y ejemplos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.