La página en inglés es más reciente que esta traducción. Leerla en inglés

CLI

Shell
npm install -g instruction.md

Sin conexión, sin necesidad de cuenta

ComandoQué hace
instruction validate <file>comprueba un documento con el lector de la especificación: cada problema con su línea y un código estable. Los errores hacen fallar el comando (código de salida 1); las advertencias, como un ${name} que nada declara, se muestran y no lo hacen fallar, y con --strict también fallan. Una línea escrita todavía según la especificación 1.1 es un error
instruction init <name> --template agentun documento inicial con reglas y sus motivos, una condición, una persona que aprueba, la forma de la respuesta y un glosario
instruction deliver <file> name=valueel texto exacto que recibe un modelo (instruction-text/1), con sus bases e inclusiones leídas de los archivos que tiene al lado; --resolved imprime el documento resuelto (instruction-resolved/1) con su digest
instruction fmt <file> --writeformato conservador: los finales de línea, el salto de línea final, los espacios al final de las líneas de directiva
instruction tree <file>el árbol del documento tal como se escribió (instruction/1), en JSON
instruction digest <file>el digest del documento tal como se escribió: el SHA-256 de los bytes del archivo
instruction render <file> --fullHTML para un sitio estático
instruction test <dir>ejecuta los vectores de conformidad de la especificación, para tu propio lector
instruction eval <file>ejecuta los casos :::eval del documento contra Claude con tus propias credenciales; --dry-run muestra lo que enviaría cada caso y no llama a ningún modelo

Contra el registro

Estos comandos hablan MCP 2026-07-28 con el servidor, sin estado: no hay sesión, y cada petición se sostiene por sí sola, la responda la réplica del servidor que la responda.

ComandoQué hace
instruction logininiciar sesión, en tu navegador; la sesión se guarda en tu directorio de configuración
instruction login --deviceiniciar sesión con un código en otro dispositivo, para una máquina sin navegador (por SSH, en un contenedor)
instruction list, get, pullbuscar y descargar
instruction push <file> --publishcrear o actualizar un borrador, y publicarlo
instruction publish <id> --tag v2 --refs latest,stablepublicar el borrador actual y mover referencias
instruction refs <id> set stable <ver>mover una referencia, que es como se vuelve a una versión anterior
instruction diff <id> <from> <to>diferencias en formato unificado y por bloques
instruction watch <uri> --out FILEseguir una referencia, conservando la última versión válida
instruction connect --host claude-code <uri> --with-hooks --writehacer de una instrucción la de un proyecto en Claude Code o Codex (--host codex, Codex; en inglés): el archivo de vínculo y los hooks
instruction hook claude-code, hook codexlo que ejecutan esos hooks: la instrucción al empezar una sesión y una nueva versión con la siguiente petición
instruction sync <uri> --as claude-skilluna instrucción como subagente o habilidad de Claude Code, o habilidad de Codex (claude-agent, codex-skill)
instruction connect --managed claude-code <uri>la configuración que la lleva a cada equipo de una organización (agentes gestionados, en inglés)
instruction audit export <id> --format csvel registro de auditoría, nunca el contenido
instruction revoke <id> <ver>retirar una versión; los consumidores conservan la que tenían

Iniciar sesión

instruction login abre tu navegador en la página de inicio de sesión de instruction.md. Inicia sesión, acepta lo que pide la línea de comandos, y el navegador muestra «Has iniciado sesión»: vuelve a la terminal. Tu navegador devuelve el inicio de sesión al comando solo en tu propio ordenador (una dirección en 127.0.0.1, abierta para este único inicio de sesión), y el comando demuestra que fue él quien lo empezó (PKCE), así que un inicio de sesión que termina en cualquier otro lugar se rechaza. Si no vuelve nada en 5 minutos, se detiene y lo dice.

Para instruction.md, el comando inicia sesión solo en la página de inicio de sesión propia de instruction.md; para el servidor que nombres con --url, solo en una que esté en la misma dirección que ese servidor. Un servidor que nombra la página de inicio de sesión de otro podría capturar tu inicio de sesión, así que se rechaza; --issuer anula esa regla, después de preguntarte (o con --trust-issuer donde no hay terminal en la que preguntar), salvo que el inicio de sesión propio de instruction.md nunca se usa para otro servidor. De cada token se comprueba que viene del servicio de inicio de sesión del que llegó y que es para el servidor al que va: el inicio de sesión de instruction.md ignora el parámetro resource de RFC 8707 que envía el comando, así que esa comprobación es la que liga el token al servidor.

¿No hay navegador en la máquina, como por SSH o en un contenedor? El comando imprime el enlace y sugiere instruction login --device: muestra un código corto y un enlace para abrir en cualquier dispositivo, también tu teléfono. El código es válido durante 5 minutos.

Administrar una organización (añadir o rotar claves de editor, crear o revocar agentes, el registro de auditoría) requiere un permiso más. instruction login --admin lo pide de entrada; si no, el primer comando que lo necesita te pregunta en la terminal y vuelve a iniciar tu sesión con él. Sin terminal no cambia nada y te indica que ejecutes instruction login --admin (--yes no inicia una sesión), y un inicio de sesión con otra cuenta se rechaza.

En CI

Define INSTRUCTION_MD_TOKEN para un token no interactivo y usa --json para obtener una salida legible por máquinas. Códigos de salida: 1 error, 2 uso incorrecto, 3 fallo de transporte o sesión no iniciada, 4 no encontrado, 5 prohibido, 6 nada aplicado, 7 no confirmado.

GitHub Actions
jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 22 }
      - run: npm i -g instruction.md
      - run: instruction validate RUNBOOK.md
      - run: instruction push RUNBOOK.md --to ${{ vars.INSTRUCTION_ID }} --publish --yes --message "${{ github.sha }}" --json
        env:
          INSTRUCTION_MD_URL: https://instruction.md/mcp
          INSTRUCTION_MD_TOKEN: ${{ secrets.INSTRUCTION_MD_TOKEN }}

Añade --sign-with key.json para publicar con tu propia clave en lugar de la de la plataforma. Consulta firma y confianza.