Communitygithub.com

hugobowne/show-us-your-agent-skills

Aquí.Now permite a los agentes publicar sitios web y almacenar archivos privados en la nube. Usa Sites para publicar HTML, documentos, imágenes, PDFs, videos y archivos estáticos en URLs públicas en {slug}.here.now o con dominios personalizados. Usa Drives como carpetas privadas en la nube donde los agentes pueden guardar archivos (documentos, contexto, memoria, planes, activos, medios, investigación, código, etc.), compartirlos con otros agentes y continuar a través de sesiones y herramientas.

¿Qué es show-us-your-agent-skills?

Aquí.Now es una habilidad para agentes de IA que proporciona dos funcionalidades principales: Publicación de sitios web (Sites) y Almacenamiento privado en la nube (Drives). Con Sites, los agentes pueden publicar páginas HTML, imágenes, PDFs, videos y cualquier archivo estático en URLs vivas como `{slug}.here.now`. Con Drives, los agentes pueden almacenar archivos privados (documentos, código, planes, memoria, etc.) y compartirlos con otros agentes mediante tokens de alcance, permitiendo la continuidad entre sesiones y herramientas. La habilidad es compatible con plataformas como Claude Code, Cursor y otros entornos donde se ejecuten agentes de IA. Para usar la habilidad, se requiere instalar el skill mediante `npx skills add heredotnow/skill --skill here-now -g` y tener las herramientas `curl`, `file` y `jq` disponibles. Ofrece scripts auxiliares (`publish.sh` y `drive.sh`) que simplifican la publicación y el almacenamiento, y se integra perfectamente con la API de here.now para operaciones avanzadas como búsqueda, perfiles, dominios personalizados y más.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/hugobowne/show-us-your-agent-skills/tree/HEAD/skills/here-now

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Proyecto: heredotnow/skill, la habilidad pública del servicio here.now.

Licencia: MIT, según se declara en el README.md original. El repositorio original no incluye un archivo LICENSE separado, por lo que no se distribuye ninguno aquí.

Instantánea: Copia congelada de heredotnow/skill/here-now al 2026-05-22. La versión mantenida vive en el repositorio original y puede haber evolucionado desde esta instantánea.

here.now

Versión de la habilidad: 1.15.5

here.now permite a los agentes publicar sitios web y almacenar archivos privados en unidades de nube.

Usa here.now para dos tareas:

  • Sites: publica sitios web y archivos en {slug}.here.now.
  • Drives: almacena archivos privados de agentes en carpetas en la nube.

Para instalar o actualizar (recomendado): npx skills add heredotnow/skill --skill here-now -g

Para instalaciones fijas a un repositorio/proyecto, ejecuta el mismo comando sin -g.

Documentación actual

Antes de responder preguntas sobre las capacidades, funciones o flujos de trabajo de here.now, lee la documentación actual:

→ https://here.now/docs

Lee la documentación:

  • en la primera interacción relacionada con here.now en una conversación
  • cada vez que el usuario pregunte cómo hacer algo
  • cada vez que el usuario pregunte qué es posible, compatible o recomendado
  • antes de decirle al usuario que una característica no es compatible

Temas que requieren la documentación actual (no confíes solo en el texto local de la habilidad):

  • Drives y uso compartido de Drives
  • dominios personalizados
  • perfiles públicos
  • rutas proxy y variables de servicio
  • identificadores de subdominio y enlaces
  • límites y cuotas
  • enrutamiento SPA
  • búsqueda de Sites del propietario
  • manejo de errores y corrección
  • disponibilidad de funciones

Si la documentación y el comportamiento de la API en vivo discrepan, confía en el comportamiento de la API en vivo.

Si falla la obtención de la documentación o se agota el tiempo de espera, continúa con la habilidad local y la salida de la API/secuencia de comandos en vivo. Prefiere el comportamiento de la API en vivo para operaciones activas.

Requisitos

  • Binarios requeridos: curl, file, jq
  • Variable de entorno opcional: $HERENOW_API_KEY
  • Variable de token de Drive opcional: $HERENOW_DRIVE_TOKEN
  • Archivo de credenciales opcional: ~/.herenow/credentials
  • Ayudantes incluidos:
    • ./scripts/publish.sh para publicar sitios
    • ./scripts/drive.sh para almacenamiento privado en Drive

Crear un sitio

./scripts/publish.sh {archivo-o-directorio}

Muestra la URL en vivo (ej. https://bright-canvas-a7k2.here.now/).

Internamente, esto sigue un flujo de tres pasos: crear/actualizar -> subir archivos -> finalizar. Un sitio no está en vivo hasta que la finalización tenga éxito.

Sin una clave API, esto crea un sitio anónimo que caduca en 24 horas. Con una clave API guardada, el sitio es permanente.

Estructura de archivos: Para sitios HTML, coloca index.html en la raíz del directorio que publices, no dentro de un subdirectorio. El contenido del directorio se convierte en la raíz del sitio. Por ejemplo, publica mi-sitio/ donde exista mi-sitio/index.html — no publiques una carpeta superior que contenga mi-sitio/.

También puedes publicar archivos individuales sin HTML. Los archivos individuales obtienen un visor automático enriquecido (imágenes, PDF, video, audio). Varios archivos obtienen un listado de directorio generado automáticamente con navegación de carpetas y una galería de imágenes.

Actualizar un sitio existente

./scripts/publish.sh {archivo-o-directorio} --slug {slug}

El script carga automáticamente el claimToken desde .herenow/state.json al actualizar sitios anónimos. Pasa --claim-token {token} para sobrescribir.

Las actualizaciones autenticadas requieren una clave API guardada.

Los usuarios con sesión iniciada también tienen perfiles públicos. Los agentes pueden ayudar a los usuarios a mostrar u ocultar Sites en su perfil y administrar la configuración del perfil a través de la API documentada en https://here.now/docs#profile.

Usar un Drive

Usa un Drive cuando el usuario desee almacenamiento privado en la nube para archivos de agente: documentos, contexto, memoria, planes, activos, medios, investigación, código y cualquier otra cosa que deba persistir sin publicarse como un sitio web.

Cada cuenta con sesión iniciada tiene un Drive predeterminado llamado Mi Drive.

./scripts/drive.sh default
./scripts/drive.sh ls Mi Drive
./scripts/drive.sh put Mi Drive notas/hoy.md --from ./notas/hoy.md
./scripts/drive.sh cat Mi Drive notas/hoy.md
./scripts/drive.sh share Mi Drive --perms write --prefix notas/ --ttl 7d

Usa tokens de Drive con alcance para la transferencia entre agentes. Si recibes un bloque de recurso compartido herenow_drive, usa su token como Authorization: Bearer <token> contra api_base, respeta pathPrefix cuando esté presente y conserva los ETags en las escrituras. Un pathPrefix de null significa acceso completo al Drive. Si la habilidad está disponible, prefiere ./scripts/drive.sh; de lo contrario, llama a las operaciones de la API listadas directamente.

Atribución del cliente

Pasa --client para que here.now pueda rastrear la confiabilidad por agente:

./scripts/publish.sh {archivo-o-directorio} --client cursor

Esto envía X-HereNow-Client: cursor/publish-sh en las llamadas a la API de publicación. Si se omite, el script envía un valor de respaldo.

Almacenamiento de clave API

El script de publicación lee la clave API de estas fuentes (la primera coincidencia gana):

  1. Bandera --api-key {key} (solo para CI/secuencias de comandos — evita en uso interactivo)
  2. Variable de entorno $HERENOW_API_KEY
  3. Archivo ~/.herenow/credentials (recomendado para agentes)

Para almacenar una clave, escríbela en el archivo de credenciales:

mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials

IMPORTANTE: Después de recibir una clave API, guárdala inmediatamente — ejecuta el comando anterior tú mismo. No le pidas al usuario que lo ejecute manualmente. Evita pasar la clave mediante banderas de CLI (ej. --api-key) en sesiones interactivas; el archivo de credenciales es el método de almacenamiento preferido.

Nunca confirmes credenciales o archivos de estado local (~/.herenow/credentials, .herenow/state.json) en el control de versiones.

Obtener una clave API

Para actualizar de sitios anónimos (24h) a permanentes:

  1. Pide al usuario su dirección de correo electrónico.
  2. Solicita un código de inicio de sesión único:
curl -sS https://here.now/api/auth/agent/request-code \
  -H "content-type: application/json" \
  -d '{"email": "[email protected]"}'
  1. Dile al usuario: "Revisa tu bandeja de entrada para obtener un código de inicio de sesión de here.now y pégalo aquí."
  2. Verifica el código y obtén la clave API:
curl -sS https://here.now/api/auth/agent/verify-code \
  -H "content-type: application/json" \
  -d '{"email":"[email protected]","code":"ABCD-2345"}'
  1. Guarda la apiKey devuelta tú mismo (no le pidas al usuario que lo haga):
mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials

Archivo de estado

Después de cada creación/actualización de sitio, el script escribe en .herenow/state.json en el directorio de trabajo:

{
  "publishes": {
    "bright-canvas-a7k2": {
      "siteUrl": "https://bright-canvas-a7k2.here.now/",
      "claimToken": "abc123",
      "claimUrl": "https://here.now/claim?slug=bright-canvas-a7k2&token=abc123",
      "expiresAt": "2026-02-18T01:00:00.000Z"
    }
  }
}

Antes de crear o actualizar sitios, puedes verificar este archivo para encontrar slugs anteriores. Trata .herenow/state.json solo como caché interna. Nunca presentes esta ruta de archivo local como una URL, y nunca la uses como fuente de verdad para el modo de autenticación, la caducidad o la URL de reclamo.

Qué decirle al usuario

Para sitios publicados:

  • Comparte siempre la siteUrl de la ejecución actual del script.
  • Lee y sigue las líneas publish_result.* de stderr del script para determinar el modo de autenticación.
  • Cuando publish_result.auth_mode=authenticated: dile al usuario que el sitio es permanente y está guardado en su cuenta. No se necesita URL de reclamo.
  • Cuando publish_result.auth_mode=anonymous: dile al usuario que el sitio caduca en 24 horas. Comparte la URL de reclamo (si publish_result.claim_url no está vacío y comienza con https://) para que pueda conservarlo permanentemente. Adviérteles que los tokens de reclamo solo se devuelven una vez y no se pueden recuperar.
  • Nunca le digas al usuario que inspeccione .herenow/state.json para obtener URLs de reclamo o estado de autenticación.

Para Drives:

  • No describas los archivos de Drive como URLs públicas.
  • Dile al usuario que el contenido del Drive es privado a menos que se comparta con un token de alcance.
  • Al compartir acceso con otro agente, prefiere un token de alcance con un pathPrefix estrecho y un TTL corto.

Opciones de publish.sh

BanderaDescripción
--slug {slug}Actualizar un sitio existente en lugar de crear
--claim-token {token}Sobrescribir token de reclamo para actualizaciones anónimas
--title {text}Título del visor (sitios no HTML)
--description {text}Descripción del visor
--ttl {segundos}Establecer caducidad (solo autenticado)
--client {nombre}Nombre del agente para atribución (ej. cursor)
--base-url {url}URL base de la API (predeterminada: https://here.now)
--allow-nonherenow-base-urlPermitir enviar autenticación a --base-url no predeterminada
--api-key {key}Sobrescribir clave API (preferir archivo de credenciales)
--spaHabilitar enrutamiento SPA (servir index.html para rutas desconocidas)

Más allá de publish.sh

Para operaciones de Drive, usa ./scripts/drive.sh o la API de Drive. Para una gestión más amplia de cuentas y Sites (búsqueda, perfiles, eliminación, metadatos, contraseñas, dominios, identificadores de subdominio, enlaces, variables, rutas proxy, duplicación y más), consulta la documentación actual:

→ https://here.now/docs

Documentación completa: https://here.now/docs

Skills relacionados