omni-embed

Par exploreomni · omni-agent-skills

Skill officiel pour intégrer des dashboards Omni Analytics dans des applications externes via iframe signé, thèmes personnalisés, événements postMessage et workspaces d'entité.

npx skills add https://github.com/exploreomni/omni-agent-skills --skill omni-embed

omni-embed

Ce skill fait partie du repo officiel exploreomni/omni-agent-skills, qui regroupe l'ensemble des skills Omni Analytics pour les agents compatibles (Claude Code, Cursor, OpenAI Codex, Snowflake Cortex Code, etc.). Il couvre tout le périmètre de l'intégration embarquée (embedding) des dashboards Omni dans des applications tierces.

Ce que fait ce skill

Le skill omni-embed guide l'agent pour générer des URLs signées côté serveur via le SDK @omni-co/embed, charger le dashboard dans un iframe, et personnaliser l'apparence (thème de couleurs, polices, bordures, boutons). Il documente également la communication bidirectionnelle entre l'application parente et l'iframe via postMessage : écoute d'événements (dashboard:loaded, dashboard:tile-drill, page:changed, événements de visualisation personnalisés) et envoi de filtres vers le dashboard embarqué.

Il couvre aussi les entity workspaces — qui permettent aux utilisateurs embed de créer et sauvegarder leurs propres dashboards dans un dossier scopé — ainsi que la gestion des permissions : recherche d'un utilisateur embed via l'Omni CLI (omni scim), liste des documents accessibles par utilisateur, et mapping entre domaine embed (.embed-omniapp.co) et domaine API (.omniapp.co).

Comment l'utiliser

Une fois le plugin installé dans votre environnement agent, il se charge automatiquement dès que votre requête correspond à un cas d'usage d'embedding : "embed this dashboard", "sign an embed URL", "customize the iframe theme", "filter the embedded dashboard", "what dashboards can this user see", etc. Aucune invocation manuelle n'est nécessaire.

Pour les cas complémentaires, ce skill renvoie vers omni-content-explorer (trouver des dashboards à embarquer), omni-admin (gérer les permissions et attributs utilisateurs pour la sécurité au niveau des lignes), et omni-model-explorer (comprendre les champs disponibles dans les événements embed).

Skills similaires