> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Creación de Skills Skills enseñan al agente cómo y cuándo usar herramientas. Cada skill es un directorio que contiene un archivo `SKILL.md` con frontmatter YAML e instrucciones en Markdown. OpenClaw carga Skills desde varias raíces en un [orden de precedencia](/es/tools/skills#loading-order) definido. ## Crea tu primera skill Skills viven en la carpeta `skills/` de tu espacio de trabajo: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} mkdir -p ~/.openclaw/workspace/skills/hello-world ``` Puedes agrupar skills en subcarpetas para organizarlas; la skill sigue recibiendo su nombre del frontmatter de `SKILL.md`, no de la ruta de la carpeta: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} mkdir -p ~/.openclaw/workspace/skills/personal/hello-world # skill name is still "hello-world", invoked as /hello-world ``` El frontmatter define los metadatos; el cuerpo proporciona instrucciones al agente. ````markdown theme={"theme":{"light":"min-light","dark":"min-dark"}} --- name: hello-world description: A simple skill that prints a greeting. --- # Hello World When the user asks for a greeting, use the `exec` tool to run: ```bash echo "Hello from your custom skill!" ```` ```` Reglas de nomenclatura: - Usa letras minúsculas, dígitos y guiones para `name`. - Mantén alineados el nombre del directorio y el `name` del frontmatter. - `description` se muestra al agente y en el descubrimiento de comandos de barra; mantenla en una línea y por debajo de 160 caracteres. ```bash openclaw skills list ```` OpenClaw observa de forma predeterminada los archivos `SKILL.md` bajo las raíces de skills. Si el observador está deshabilitado o continúas una sesión existente, inicia una nueva para que el agente reciba la lista actualizada: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # From chat — archive current session and start fresh /new # Or restart the gateway openclaw gateway restart ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw agent --message "give me a greeting" ``` O abre un chat y pregúntale directamente al agente. Usa `/skill hello-world` para invocarla explícitamente por nombre. ## Referencia de SKILL.md ### Campos obligatorios | Campo | Descripción | | ------------- | ---------------------------------------------------------------------------- | | `name` | Slug único que usa letras minúsculas, dígitos y guiones | | `description` | Descripción de una línea mostrada al agente y en la salida de descubrimiento | ### Claves opcionales del frontmatter | Campo | Predeterminado | Descripción | | -------------------------- | -------------- | ----------------------------------------------------------------------------------------------------- | | `user-invocable` | `true` | Expone la skill como comando de barra de usuario | | `disable-model-invocation` | `false` | Mantiene la skill fuera del prompt del sistema del agente (aún se ejecuta mediante `/skill`) | | `command-dispatch` | — | Establece `tool` para enrutar el comando de barra directamente a una herramienta, omitiendo el modelo | | `command-tool` | — | Nombre de la herramienta que se invoca cuando `command-dispatch: tool` está establecido | | `command-arg-mode` | `raw` | Para el despacho a herramientas, reenvía la cadena de argumentos sin procesar a la herramienta | | `homepage` | — | URL mostrada como "Sitio web" en la interfaz de Skills de macOS | Para los campos de control de activación (`requires.bins`, `requires.env`, etc.), consulta [Skills — Control de activación](/es/tools/skills#gating). ### Uso de `{baseDir}` Referencia archivos dentro del directorio de la skill sin codificar rutas de forma fija; el agente resuelve `{baseDir}` contra el propio directorio de la skill: ```markdown theme={"theme":{"light":"min-light","dark":"min-dark"}} Run the helper script at `{baseDir}/scripts/run.sh`. ``` ## Agregar activación condicional Controla la activación de tu skill para que solo se cargue cuando sus dependencias estén disponibles: ```markdown theme={"theme":{"light":"min-light","dark":"min-dark"}} --- name: gemini-search description: Search using Gemini CLI. metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } } --- ``` | Clave | Descripción | | ------------------ | -------------------------------------------------------------------------------- | | `requires.bins` | Todos los binarios deben existir en `PATH` | | `requires.anyBins` | Al menos un binario debe existir en `PATH` | | `requires.env` | Cada variable de entorno debe existir en el proceso o en la configuración | | `requires.config` | Cada ruta de `openclaw.json` debe evaluarse como verdadera | | `os` | Filtro de plataforma: `["darwin"]`, `["linux"]`, `["win32"]` | | `always` | Establécelo en `true` para omitir todos los controles e incluir siempre la skill | Referencia completa: [Skills — Control de activación](/es/tools/skills#gating). Conecta una clave de API a una entrada de skill en `openclaw.json`: ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { skills: { entries: { "gemini-search": { enabled: true, apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, }, }, }, } ``` La clave se inyecta en el proceso host solo para ese turno del agente. No llega al sandbox; consulta [variables de entorno en sandbox](/es/tools/skills-config#sandboxed-skills-and-env-vars). ## Proponer mediante Skill Workshop Para skills redactadas por el agente o cuando quieres una revisión del operador antes de que una skill entre en producción, usa propuestas de [Skill Workshop](/es/tools/skill-workshop) en lugar de escribir `SKILL.md` directamente. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # Propose a brand-new skill openclaw skills workshop propose-create \ --name "hello-world" \ --description "A simple skill that prints a greeting." \ --proposal ./PROPOSAL.md # Propose an update to an existing skill openclaw skills workshop propose-update hello-world \ --proposal ./PROPOSAL.md \ --description "Updated greeting skill" ``` Usa `--proposal-dir` cuando la propuesta incluya archivos de soporte: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw skills workshop propose-create \ --name "hello-world" \ --description "A simple skill that prints a greeting." \ --proposal-dir ./hello-world-proposal/ ``` El directorio debe contener `PROPOSAL.md` en su raíz. Los archivos de soporte van bajo `assets/`, `examples/`, `references/`, `scripts/` o `templates/`. Después de la revisión: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw skills workshop inspect openclaw skills workshop apply ``` Consulta [Skill Workshop](/es/tools/skill-workshop) para ver el ciclo de vida completo de las propuestas. ## Publicar en ClawHub Asegúrate de que `name`, `description` y cualquier campo de control de activación de `metadata.openclaw` estén configurados. Agrega una URL de `homepage` si tienes una página de proyecto. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} npm i -g clawhub clawhub login ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub skill publish ./path/to/hello-world ``` Agrega `--version ` o `--owner ` para anular la versión inferida o publicar bajo un propietario específico. Consulta [ClawHub — Publicación](/es/clawhub/publishing) y [CLI de ClawHub](/es/clawhub/cli) para ver el flujo completo, el alcance por propietario y otros comandos de mantenimiento (`clawhub sync`, `clawhub skill rename`, ...). ## Prácticas recomendadas * **Sé conciso**: instruye al modelo sobre *qué* hacer, no sobre cómo ser una IA. * **La seguridad primero**: si tu skill usa `exec`, asegúrate de que los prompts no permitan inyección arbitraria de comandos desde entradas no confiables. * **Prueba localmente**: usa `openclaw agent --message "..."` antes de compartir. * **Usa ClawHub**: explora skills de la comunidad en [clawhub.ai](https://clawhub.ai) antes de crear desde cero. ## Relacionado Orden de carga, control de activación, listas de permitidos y formato de SKILL.md. Cola de propuestas para skills redactadas por el agente. Esquema completo de configuración de `skills.*`. Explora y publica skills en el registro público. Los plugins pueden enviar skills junto con las herramientas que documentan.