integration-connector-setup

Configure and verify Slack, Telegram, Signal, Notion, Spotify, and other connectors through guided setup flows.

609|81|Updated Nov 15, 2024
One-click install
npx skills add https://github.com/QuixiAI/Hexis --skill integration-connector-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: integration-connector-setup
Source: https://github.com/QuixiAI/Hexis/tree/main/skills/installed/integration-connector-setup
Command: npx skills add https://github.com/QuixiAI/Hexis --skill integration-connector-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Connecting external services like Slack, Telegram, or Spotify to an agent normally requires juggling tokens, OAuth flows, and config files by hand. This Skill turns connector setup into a guided in-conversation flow that reads the connector manifest, collects only environment variable references, and verifies each connection before recording it.

Core Features & Use Cases

  • Guided Channel Setup: Walks through Slack, Telegram, and Signal configuration using env var names for tokens, then verifies the channel worker config before recording the connection.
  • Life Integration Connectors: Connects Notion, Home Assistant, Weather, and Trello via connect_life_integration, and handles Spotify through a PKCE flow with loopback redirect registration.
  • History Backfill with Approval: Queues historical message imports only after explicit user approval, with status tracking and pause/resume/cancel controls.
  • Use Case: A user asks to connect their Slack workspace. The Skill checks setup status, starts the flow with minimal capabilities, accepts only env var names for the bot token, verifies the config, and only then tells the user to restart hexis-channels.

Quick Start

Ask the agent to connect your Slack workspace and follow the guided setup steps it provides.

Frequently Asked Questions about integration-connector-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Slack or Telegram to my agent?

Start by asking which connectors are available, then follow the guided setup flow. Provide channel settings using environment variable names for tokens rather than pasting secrets, and the connection is verified before being recorded.

How does Spotify connection work with PKCE?

Spotify uses a PKCE OAuth flow initiated by the connect tool. You register the exact loopback redirect URI returned during setup, since Spotify does not accept localhost, and a completion tool handles cases where the automatic callback fails.

Can I import my Slack or Telegram message history?

Yes, historical backfill is supported but requires your explicit approval since it ingests data into local memory. Slack needs a channel ID, while Telegram and Signal accept a local export or archive path.

Is it safe to provide API tokens during connector setup?

You never paste tokens or secrets into chat. Token fields accept only environment variable names, and the tools resolve the actual values from the environment at runtime.

How do I disconnect Notion or Home Assistant?

Use the revoke capability for life integrations when you want to disconnect providers like Notion, Home Assistant, Weather, or Trello. This removes the stored connection for that provider.