# Agentes de IA

> Sirve Markdown, llms.txt, señales de contenido y skills de agente a los agentes de IA.

Cada compilación publica tu sitio en los formatos que mejor leen los agentes de IA, junto al HTML que reciben los navegadores. No necesitas configurar nada para ello. Las dos claves de abajo solo lo ajustan.

## Qué genera la compilación

| Archivo                                | Propósito                                                                                                                                                                                                                                                      |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `<page>.md`                            | Una copia en Markdown de cada página junto a su HTML: `guides/build.html` obtiene `guides/build/index.md`, con su título, descripción y contenido, y cada componente reducido a Markdown simple (un callout a una cita, las pestañas a encabezados en negrita) |
| `/llms.txt`                            | Un índice [llms.txt](https://llmstxt.org/): el título y la descripción del sitio y, después, la copia en Markdown de cada página con su descripción, agrupadas como las agrupa la navegación                                                                   |
| `/index.md`                            | La copia de la página de inicio, o una copia de `llms.txt` cuando el proyecto no tiene `index.html`                                                                                                                                                            |
| `/robots.txt`                          | Una línea `Content-Signal` que indica cómo pueden usar tu contenido los sistemas automatizados                                                                                                                                                                 |
| `/_headers`                            | Para Cloudflare y Netlify: una cabecera `Link` en la página de inicio que apunta a `llms.txt`, `index.md` y al índice de skills                                                                                                                                |
| `/.well-known/agent-skills/index.json` | Un índice de descubrimiento de [Agent Skills](https://agentskills.io/), cuando se define `skills`                                                                                                                                                              |

Cada página lleva además `<link rel="alternate" type="text/markdown">` apuntando a su copia, y la barra de herramientas de la página enlaza la copia y, con su script, la copia al portapapeles o abre la página en ChatGPT o Claude.

Un archivo del proyecto con el mismo nombre reemplaza al generado. `_headers` es la única excepción: tus reglas se conservan y la regla `Link` generada se añade después de ellas. `htmlpress start` ejecuta la misma compilación, así que también sirve estos archivos.

## Señales de contenido

`contentSignals` controla la línea de [Content Signals](https://contentsignals.org/) en `robots.txt`. Las tres señales valen `true` por defecto:

```yaml
contentSignals:
  search: true # build a search index and show links to your pages
  aiInput: true # feed pages to a model answering a question in real time
  aiTrain: false # train or fine-tune models on your content
```

La línea que produce queda en el grupo `User-agent: *`: `Content-Signal: search=yes, ai-input=yes, ai-train=no`.

## Skills de agente

Si tu proyecto incluye [Agent Skills](https://agentskills.io/specification), apunta `skills` a sus archivos `SKILL.md`, con un glob o una lista, relativos al proyecto:

```yaml
skills: .skills/*/SKILL.md
```

Cada skill encontrada se publica en `/.well-known/agent-skills/<name>/SKILL.md` y se lista en `index.json` con un resumen `sha256`. Su frontmatter necesita un `name` (letras minúsculas, dígitos y guiones simples, como máximo 64 caracteres) y una `description` (como máximo 1024), y la compilación falla si falta alguno o si dos skills comparten nombre. Este sitio publica la skill propia de htmlpress en [/.well-known/agent-skills/](/.well-known/agent-skills/index.json).

## Markdown bajo petición

Los agentes piden Markdown enviando `Accept: text/markdown` a la URL de la página. Un hosting estático no puede responder a eso por sí solo, pero una reescritura en tu CDN puede servir la copia `.md` de la página para esas peticiones y dejar el HTML para todos los demás. Cada página tiene una copia, así que la reescritura nunca apunta a un archivo inexistente. Para una regla lista para usar, consulta [Cloudflare](/es/deployment/cloudflare/).

## Ver también

- [Agent Skills](/es/agent-skills/): instala la skill propia de htmlpress en tu agente de programación.
- [Archivo de configuración](/es/customization/configuration-file/): todas las claves de primer nivel.
- [Rutas personalizadas](/es/customization/custom-routes/): archivos estáticos copiados junto a tus páginas.