omi-plugin-development_skill

Overview

This skill guides developers through building Omi plugins and apps, covering webhook patterns, chat tools, OAuth flows, and prompt-based integrations. It focuses on practical patterns for FastAPI/Express endpoints, real-time transcription, chat tool registration, and secure OAuth setup. The guidance is focused on outcomes: reliable webhooks, reusable chat tools, and safe token handling.

How this skill works

The skill describes two primary plugin types: prompt-based apps that require no server and integration apps that expose webhook endpoints. It provides concrete webhook handlers for memory creation and live transcript segments, examples for registering chat tools, and OAuth flow snippets for common providers. It also outlines manifest configuration and testing approaches to validate behavior before production.

When to use it

• When creating a new Omi plugin or app
• When implementing webhook handlers for memories or transcripts
• When adding agentic chat tools for LangGraph-style agents
• When integrating third-party OAuth providers (Google, Apple, etc.)
• When building prompt-based experiences without a backend

Best practices

• Handle webhook errors and return clear HTTP statuses
• Design webhooks to be idempotent to avoid duplicate processing
• Verify webhook signatures and authenticate incoming requests
• Rate-limit processing paths and protect expensive operations
• Store OAuth tokens securely and rotate credentials when possible
• Document endpoints and test with webhook inspection tools before production

Example use cases

• Prompt-based assistant embedded in a wearable that customizes responses with no server
• Integration app that receives memory-created webhooks and triggers follow-up actions
• Real-time transcription webhook that listens for wake words and fires automations
• Chat tool providing a domain-specific search or data lookup for agentic conversations
• OAuth-enabled app that links user accounts to external providers and syncs data