Floom

Comparte habilidades de agentes de IA con un enlace.

Una habilidad de Floom es cualquier cosa que compartas para mejorar el trabajo de un agente: conocimiento sobre la voz de marca, datos de la empresa, documentos de incorporación, flujos de trabajo de ventas, estándares de codificación y, más adelante, habilidades ejecutables.

npm install -g @floomhq/floom
floom login
floom publish pr-review-brief.md
# -> https://floom.dev/s/ffas93ud

floom add https://floom.dev/s/ffas93ud
# -> adds pr-review-brief.md locally

Publica conocimientos, instrucciones y flujos de trabajo desde tu terminal. Cualquiera puede añadirlos y usarlos en su agente.

Floom Versión 0 - El intercambio es intencionalmente limitado: publicación desde terminal, enlace compartido, adición local. Markdown es la interfaz de origen. Sin panel de control, sin mercado, sin ejecución alojada.

Floom Versión 1 - La sincronización comienza con una vista previa: floom sync, floom watch, escrituras locales con reconocimiento de carpetas y sincronización de inicio/sondeo MCP para tus propias habilidades publicadas. La versión 1 completa podrá más adelante promover la recarga en caliente, la propagación de actualizaciones, la gestión de dependencias, el seguimiento de instalaciones, el versionado semántico y la reversión.

Floom Versión 2 son Equipos y el primer bucle comprobable por la empresa: interfaz de usuario para creadores, interfaz de usuario para receptores, etiquetas de habilidades, invitaciones y entrega por correo electrónico, seguimiento de instalación/actualización y una incorporación clara a MCP.

Estructura

• cli/ — CLI de Node 22 TypeScript, publicada como @floomhq/floom

• mcp-sync/ — Vista previa del servidor MCP, publicada como @floomhq/floom-mcp-sync

• web/ — Aplicación Next.js 16 (página de inicio + rutas de API), se despliega en Vercel

• supabase/ — Migraciones SQL para el esquema skills_minimal existente

Related MCP server: IteraTools MCP

Código de prototipo de versiones posteriores

El repositorio todavía contiene código de prototipo de versiones posteriores. Esas rutas están inactivas hasta que una versión las promueva explícitamente.

Endpoints de la Versión 0

• POST /api/skills (requiere autenticación) — cuerpo { title?, description?, body_md, visibility?, asset_type?, source?, installs_as?, version? }

• DELETE /api/v1/skills/:slug (requiere autenticación) — eliminación lógica por parte del creador

• GET /s/:slug.md — markdown sin procesar público

• GET /s/:slug.json — registro completo público

• GET /api/me — usuario actual (requiere autenticación)

Esquema

skills_minimal.posts en el proyecto de Supabase existente. Los slugs son nanoid cortos (8 caracteres). RLS deniega lecturas directas desde anon; los endpoints públicos utilizan el rol de servicio para realizar la obtención.

V0 mantiene el sustantivo externo skill, mientras almacena metadatos genéricos debajo: asset_type (knowledge, instruction, workflow, skill), source (markdown) e installs_as (claude_skill, memory, rule, codex_instruction, etc.). V0 también almacena una etiqueta de version opcional desde el frontmatter o las banderas de la CLI. El historial de versiones, la reversión y la propagación de actualizaciones son características de versiones posteriores.

Despliegue

# Backend (web/)
cd web && vercel --prod

# CLI publish
cd cli && npm publish --access public

Alcance de la Versión 0

En el alcance:

• floom publish <file>

• Etiquetas de versión opcionales desde frontmatter o floom publish --version

• Enlaces de habilidades compartibles

• floom add <url-or-slug>

• floom info <url-or-slug>

• floom delete <url-or-slug>

• Endpoint de habilidad Markdown sin procesar

• Autenticación mínima

Fuera del alcance:

• Paneles de control de equipo

• Descubrimiento en mercado

• Carpetas y etiquetas

• Aprobaciones

• Ejecución alojada

• Extensión de navegador

Alcance de la vista previa de la Versión 1

En el alcance:

• floom sync

• floom watch

• Vista previa de sincronización de inicio y sondeo de MCP

• Escrituras solo para archivos faltantes para tus propias habilidades publicadas

• Protección contra conflictos locales

• Escrituras con reconocimiento de carpetas desde metadatos del servidor

Fuera del alcance:

• Paneles de control de creador y receptor

• Compartir y entrega por correo electrónico

• Bibliotecas de equipo

• Historial de versiones y reversión

• Eliminación automática de Markdown local

• Ejecución alojada

Versión 1 completa más adelante:

• Recarga en caliente a través de MCP donde sea compatible

• Propagación de actualizaciones

• Gestión de dependencias

• Seguimiento de instalaciones

• Versionado semántico

• Reversión