菜单
Guide for adding new external integrations (OAuth or API key-based) to seer. Use when implementing new service integrations like Google, GitHub, Slack, etc.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
use when creating or updating end-to-end tests for the Seer application. This skill provides guidance on how to structure and implement e2e tests effectively.
React Flow best practices for workflow canvas in seer-frontend. Use when modifying WorkflowCanvas, adding new block types, debugging node rendering issues, or optimizing React Flow performance.
Apply Seer design system patterns when creating or modifying UI components. Auto-triggers for badge, button, input, and form components in src/components/.
Use this when you are asked to debug production errors
Context about runtime credential resolution in seer. Use when understanding how OAuth tokens, resources, and secrets are resolved for tool execution.
Context about how integration metadata configures frontend display in seer. Use when understanding INTEGRATION_CONFIGS, icons, scopes, or how the dynamic UI system works.
| name | add-integration |
| description | Guide for adding new external integrations (OAuth or API key-based) to seer. Use when implementing new service integrations like Google, GitHub, Slack, etc. |
| allowed-tools | Read, Grep, Glob, Edit, Write, Bash(uv:*, pytest:*) |
The frontend is fully dynamic — adding backend metadata is sufficient for UI rendering. No frontend code changes needed.
Architecture: Metadata config → OAuth flow → IntegrationProvider → OAuthConnection → ResourceBrowser (optional) → Tools
Phase 1: Metadata — Add entry to INTEGRATION_CONFIGS in src/seer/services/integrations/metadata.py. Set display_name, oauth_provider, icon (Logo.dev URL), brand_color, default_scopes, available scopes, detection_patterns. Update get_oauth_provider() in auth/oauth.py.
Phase 2: Provider — Create provider class in src/seer/services/integrations/providers/myservice.py extending IntegrationProvider. Add OAuth config to config.py and env vars. Register OAuth client in auth/oauth.py. Register provider in providers/__init__.py.
Phase 3: Resource Browsing (optional) — Add resource type handlers in resource_providers/. Test listing endpoints.
Phase 4: Tools — Create src/seer/tools/myservice/ directory. Implement tool classes extending BaseTool with integration_type, provider, required_scopes, get_parameters_schema(), and execute(). Register in tools/__init__.py.
Phase 5: Testing — Verify GET /api/integrations/metadata, add OAuth + tool execution tests.
| File | Purpose |
|---|---|
src/seer/services/integrations/metadata.py | INTEGRATION_CONFIGS |
src/seer/services/integrations/providers/base.py | Base classes |
src/seer/services/integrations/providers/<provider>.py | Provider implementation |
src/seer/services/integrations/providers/__init__.py | Provider registration |
src/seer/services/integrations/auth/oauth.py | OAuth client config + provider mapping |
src/seer/tools/<provider>/ | Tool implementations |
src/seer/config.py | Env vars |
providers/google.py) — OpenID Connect, incremental authproviders/github.py) — OAuth with API profile fetchproviders/supabase.py) — API key + OAuth hybridproviders/discord.py) — Bot installation flowINTEGRATION_CONFIGS and icon URL accessibilityproviders/__init__.py and env varsrequired_scopes matches OAuth configaccess_type=offline and correct access_token_url/oauth-integration · /integration-providers · /integration-metadata · /resource-browser · /tools-creation · /credential-resolution