Coding agent setup

Let Claude Code, Cursor, Codex or another coding agent integrate Super Connect into your app. Two things make that work: a skill that teaches the agent the connection flow, and plain-text docs it can read on its own.

Skill

The skill covers the backend session endpoint, the connect modal, saving the connection ID, the proxy and typed actions, error codes, reauthorization and webhooks. It ships inside @super-connect/client, so the guidance matches the SDK version you installed. TanStack Intent finds it in node_modules and loads it when a task needs it.

1. Install the SDK and Intent

npm install @super-connect/client
npm install -D @tanstack/intent

2. Allow the skill

Intent only surfaces skills from sources you list in package.json:

{
  "intent": {
    "skills": ["@super-connect/client#integrate-super-connect"],
    "exclude": ["*#experimental-*"]
  }
}

skills is the allowlist. The package#skill entry permits this one skill; a bare @super-connect/client also permits skills added in later releases. exclude applies after the allowlist and always wins. Add entries with npx intent exclude add <package>[#<skill>].

Allowing a skill does not approve its text, which can change when you upgrade. Read the skill diff as part of the upgrade:

npm diff --diff=@super-connect/client@0.4.0 --diff=@super-connect/client@latest skills

3. Tell the agent to load it on demand

npx intent list
npx intent install

list shows the skills your policy permits. install writes an intent-skills block into AGENTS.md, or into an existing CLAUDE.md, .cursorrules or .github/copilot-instructions.md. The block tells the agent to run intent list before a substantial task and intent load only for a matching skill, so Super Connect guidance enters the context for connection work and stays out otherwise. Check what the agent receives:

npx intent load @super-connect/client#integrate-super-connect

Intent reads installed packages as files. It never imports or runs code from the packages it scans.

Optional: editor hooks

npx intent hooks install --agents claude

Hooks add a skill catalog at session start and block supported edit tools until the agent runs intent list or intent load. They are a convenience, not a security boundary: a hook sees that a command started, not that it succeeded or that the agent followed the skill, and other ways of changing files are not gated. Control what reaches the agent with intent.skills and intent.exclude, and review its changes as usual.

Without npm

The skills CLI copies the skill from the main branch, which can be ahead of the SDK version you run:

npx skills add mertdogar/super-connect --full-depth -s integrate-super-connect

Without the CLI, copy packages/client/skills/integrate-super-connect from https://github.com/mertdogar/super-connect into the path above.

API key

Create a key under Organization → API keys and store it as SUPER_CONNECT_API_KEY in your backend's secret store. Do not paste it into a prompt, an AGENTS.md or any file the agent commits.

Prompt the agent

Add at least one provider under Providers, then describe the feature:

Let signed-in users connect their GitHub account with Super Connect and list their repositories on the settings page.

The skill tells the agent to reuse your existing user model and HTTP framework, keep the key on the backend, and verify the flow end to end before finishing. Review the result against Getting started.

Docs for agents

Point an agent at llms-full.txt when you want it to answer questions about Super Connect without installing the skill.