Agent skill

Connector Setup

by katipally in katipally/openlive

A skill your agent uses when the user wants to add, connect, sign in to or fix an MCP connector (a server that gives you tools for an app such as GitHub, Linear or Notion).

Apache-2.0Auto-check passedMedia & Creative

Install Connector Setup

skills CLI
$ npx skills add katipally/openlive --skill connector-setup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install katipally/openlive connector-setup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/katipally/openlive.git skills-src && mkdir -p .claude/skills && cp -r skills-src/services/agent/skills/connector-setup .claude/skills/connector-setup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
connector-setup
GitHub stars
336
Token cost
~860 tokens
SKILL.md length
518 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when the user wants to add, connect, sign in to or fix an MCP connector (a server that gives you tools for an app such as GitHub, Linear or Notion).

  • Works in 2 steps: Find out which server. Most services… → The user is asked to approve the add.…
  • The user wants to add
  • SKILL.md covers Secrets, Adding one, Signing in and Fixing one
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Connector Setup is an agent skill from katipally/openlive. Use when the user wants to add, connect, sign in to or fix an MCP connector (a server that gives you tools for an app such as GitHub, Linear or Notion).

Its SKILL.md is about 860 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering App automation through connectors and Text to speech and voice. It works with GitHub and Notion. The repository describes itself as: Opensource, on-device voice + vision layer for AI agents. Bring any model or coding agent; the whole speech loop (VAD, STT, TTS, barge-in) runs locally. An open alternative to… The licence is Apache-2.0.

When your agent uses it

  • The user wants to add
  • Fix an MCP connector (a server that gives you tools for an app such as GitHub

Example prompts

  • “/connector-setup”

Requirements

  • Docker

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Find out which server. Most services document either
  2. The user is asked to approve the add. Then read the result

What it can do on your machine

Read from SKILL.md and the folder at commit c9121eb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Connector Setup loads about 860 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 518 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~860

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from katipally/openlive at commit c9121eb, republished under its Apache-2.0 licence (© katipally). 518 words, ~860 tokens.

Download SKILL.mdSave it as .claude/skills/connector-setup/SKILL.md (or your agent's skills folder).
name
connector-setup
description
Use when the user wants to add, connect, sign in to or fix an MCP connector (a server that gives you tools for an app such as GitHub, Linear or Notion).

Setting up connectors

A connector is an MCP server that gives every brain in OpenLive more tools. Its tools show up as <connector>__<tool> once it is connected. You help the user add one, sign in, and fix one that is not working.

Your tools: list_connectors, add_connector, connector_sign_in, reconnect_connector.

Secrets

  • Never ask the user to say an API key or token out loud, and never repeat one back. Suggest they paste it in Settings, Capabilities, Connectors, where it is stored encrypted.
  • If they paste one to you, pass it in headers (or inside json) and do not mention its value again. Tool results never show it.

Adding one

  1. Find out which server. Most services document either:
    • A URL (a remote server), as https://mcp.example.com/mcp. Call add_connector with url and a short name.
    • A JSON block in the mcpServers shape, with a command such as npx (a local server). Call add_connector with json set to that block, as text.
  2. The user is asked to approve the add. Then read the result:
    • connected: done. Say how many tools it offers.
    • needs sign-in: go to "Signing in".
    • waiting for the user to allow it to run: a local server runs a program on their computer, so only the user can allow it: Settings, Capabilities, Connectors, then Review and Allow on that connector. You cannot allow it, and no tool can. Tell them where to click, then check with list_connectors.
    • failed: go to "Fixing one".

If they do not know the URL or JSON, offer to look it up (the research skill) on the service's own documentation site.

Signing in

For a connector that needs sign-in, call connector_sign_in with its id. It opens the service's sign-in page in their browser, or gives you the address to pass on. Ask them to finish signing in there, then call list_connectors to confirm it is connected.

Only remote (URL) connectors sign in. A local one takes its keys as env values in Settings, Capabilities, Connectors.

Show full SKILL.md (190 more words)Show less

Fixing one

Start with list_connectors. Then by status:

  • switched off: they turned it off in Settings. Ask if they want it on; they switch it there.
  • waiting to be allowed: as above, only they can allow it, in Settings.
  • needs sign-in: connector_sign_in.
  • not connected yet: normal. It connects when one of its tools is first used, or call reconnect_connector.
  • failed: read the error, then reconnect_connector once. If it fails again, explain the likely cause in plain words:
    • "command not found" or ENOENT: the program (npx, uvx, docker) is not installed or not on the PATH.
    • 401 or 403: the key or sign-in is wrong or expired. Sign in again, or update the key in Settings.
    • 404 or a connection error: the URL is wrong or the server is down.
    • A crash right after starting: a missing env value the server needs.
  • connected but a tool is missing: tools can be switched off one by one in Settings, Capabilities, Connectors. A server that changed its tools shows them after reconnect_connector.

Never retry the same thing more than twice. Tell the user what you found and what they can do in Settings.

© katipally, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in services/agent/skills/connector-setup of katipally/openlive.

Open the folder on GitHubat commit c9121eb

Compare with similar skills

Connector Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Connector Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Connector Setup this skillkatipally/openlive336—~860Automated safety check: PassApache-2.0
ComposioComposioHQ/composio30k1 repos~1.7kAutomated safety check: PassMIT
Connect Apps with ComposioComposioHQ/awesome-claude-skills77k3 repos~557Automated safety check: PassNone
Composio Cloud Toolsquarqlabs/argus277—~543Automated safety check: PassApache-2.0
Superset Integration Toolssuperset-sh/superset15k—~1.6kAutomated safety check: WarnCustom licence
Bmad Install Agentvibespaulpreibisch/AgentVibes155—~557Automated safety check: PassApache-2.0

Similar skills

  • Composio

    ComposioHQ/composio

    Route and complete Composio work across Composio For You and Composio Platform.

    30k GitHub starsUsed in 1 repo~1.7k tokens
    Productivity & AutomationAuto-check passed
  • Connect Apps with Composio

    ComposioHQ/awesome-claude-skills

    Connects an agent to 1000+ external apps through the Composio Tool Router plugin, so it can actually send emails, create issues and post messages instead of only drafting them.

    77k GitHub starsUsed in 3 repos~557 tokens
    Productivity & AutomationAuto-check passed
  • Composio Cloud Tools

    quarqlabs/argus

    Routes requests to external SaaS apps such as GitHub, Gmail, Google Calendar, Slack, Notion and Linear through cloud tools, with safeguards on irreversible actions.

    277 GitHub stars~543 tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • Superset Integration Tools

    superset-sh/superset

    Lists and calls the tools of connected integrations such as Linear, GitHub, Sentry or Notion through the superset mcp command, without storing a token on the machine.

    15k GitHub stars~1.6k tokensUpdated today
    Agent WorkflowsAuto-check: warnings
  • Bmad Install Agentvibes

    paulpreibisch/AgentVibes

    Install AgentVibes TTS voice system for BMAD agents. An agent skill from paulpreibisch/AgentVibes.

    155 GitHub stars~557 tokensUpdated 21 days ago
    Media & CreativeAuto-check passed
  • Integrations

    butterbase-ai/butterbase-skills

    Use BEFORE recommending or installing any third-party SaaS SDK for email (Resend, SendGrid, Postmark, Mailgun), SMS (Twilio), messaging (Slack), calendar (Google Calendar), CRM (HubSpot…

    534 GitHub stars~832 tokensUpdated 2 days ago
    Sales & SupportAuto-check passed

More from katipally/openlive

  • Research

    katipally/openlive

    A skill your agent uses when the user asks you to research, compare, fact-check or find current information, and the answer should come with sources.

    336 GitHub stars~827 tokensUpdated today
    Auto-check passed
  • Skill Creator

    katipally/openlive

    A skill your agent uses when the user wants to teach you a workflow, save how they like something done, or make a new skill.

    336 GitHub stars~657 tokensUpdated today
    Auto-check passed
  • Computer Use

    katipally/openlive

    Use before operating an app on the user's computer, such as clicking, filling a field, reading a window or moving through a website in their browser.

    336 GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Works with

Questions about Connector Setup

What does Connector Setup do?

A skill your agent uses when the user wants to add, connect, sign in to or fix an MCP connector (a server that gives you tools for an app such as GitHub, Linear or Notion). Connector Setup is an agent skill from katipally/openlive. Use when the user wants to add, connect, sign in to or fix an MCP connector (a server that gives you tools for an app such as GitHub, Linear or Notion).

When should I use Connector Setup?

Connector Setup fits situations like: the user wants to add; fix an MCP connector (a server that gives you tools for an app such as GitHub.

How do I install Connector Setup in Claude Code?

Run `npx skills add katipally/openlive --skill connector-setup -a claude-code`. Or copy the skill folder (services/agent/skills/connector-setup in katipally/openlive) into .claude/skills/connector-setup in your project. Claude Code loads it when a task matches its description.

How do I install Connector Setup in Codex?

Run `npx skills add katipally/openlive --skill connector-setup -a codex`. Or copy the skill folder (services/agent/skills/connector-setup in katipally/openlive) into .agents/skills/connector-setup in your project. Codex loads it when a task matches its description.

Can I use Connector Setup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add katipally/openlive --skill connector-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/connector-setup, .gemini/skills/connector-setup, .github/skills/connector-setup and .opencode/skills/connector-setup in your project.

What does Connector Setup need to run?

SKILL.md names no scripts, command-line tools or credentials: Connector Setup is instructions for the agent only. Our summary lists: Docker.

Does Connector Setup access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Connector Setup safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Connector Setup use?

Connector Setup is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Connector Setup use?

About 860 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Connector Setup?

Skills that share tags, products or a category with Connector Setup: Composio (ComposioHQ/composio, 30k stars), Connect Apps with Composio (ComposioHQ/awesome-claude-skills, 77k stars), Composio Cloud Tools (quarqlabs/argus, 277 stars) and Superset Integration Tools (superset-sh/superset, 15k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Connector Setup?

katipally (a GitHub user) maintains it in katipally/openlive, which has 336 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 7, 2026.

Source: katipally/openlive on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.