Saltar al contenido
Todas las herramientas

recipe_import

Skills y recetas · macOS · Windows

Efecto: escritura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Instala una SKILL que alguien compartió contigo: pasa el skill_token de su recipe_export (o un manifiesto de receta en JSON sin procesar). La guarda en este Mac para que recipe_run pueda usarla. Importar solo almacena la skill. Al ejecutarla pide una confirmación cuando tiene pasos que cambian el estado (send/write/delete), y un paso no puede confirmarse a sí mismo: `confirm` en los argumentos de un paso se elimina aquí (confirm_removed_steps) y se ignora al ejecutar, de modo que un paso cuya herramienta pide confirmación responde con su vista previa en lugar de ejecutarse. Si ya existe una skill con el mismo nombre, la importación se guarda con un nombre que no colisione. La primera llamada muestra una vista previa; confirm: true la guarda. Devuelve {name, imported}.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — macOS
{
  "properties": {
    "confirm": {
      "description": "Must be true to save the skill. Without it the call returns a preview and saves nothing.",
      "type": "boolean"
    },
    "skill": {
      "description": "A skill_token from recipe_export, or a raw recipe manifest JSON string.",
      "type": "string"
    },
    "skill_token": {
      "description": "Alias for `skill` — the exact field name recipe_export returns.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para recipe_import. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "confirm": false,
  "skill": "{\"name\":\"Demo morning brief\",\"description\":\"Read the local date and time.\",\"steps\":[{\"tool\":\"get_datetime\",\"args\":{}}]}"
}

Windows

Propósito

Instala una SKILL que alguien compartió contigo: pasa el skill_token de su recipe_export (o un manifiesto de receta en JSON sin procesar). La guarda en este equipo para que recipe_run pueda usarla. Es segura: importar solo almacena la skill; un paso no puede confirmarse a sí mismo, así que cuando luego se ejecute, un paso cuya herramienta pide confirmación (para enviar, eliminar, reemplazar un archivo o ejecutar un comando) devuelve su vista previa y no cambia nada. Si ya existe una skill con el mismo nombre, la importación se guarda con un nombre que no colisione. La primera llamada devuelve una vista previa que nombra los pasos de la skill y no guarda nada; confirm=true la guarda. Devuelve {name, imported}.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — Windows
{
  "properties": {
    "confirm": {
      "description": "Must be true to save the skill. Without it, returns a preview naming its steps.",
      "type": "boolean"
    },
    "skill": {
      "description": "A skill_token from recipe_export, or a raw recipe manifest JSON string.",
      "type": "string"
    },
    "skill_token": {
      "description": "Alias for `skill` — the exact field name recipe_export returns.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para recipe_import. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "confirm": false,
  "skill": "{\"name\":\"Demo morning brief\",\"description\":\"Read the local date and time.\",\"steps\":[{\"tool\":\"get_datetime\",\"args\":{}}]}"
}