Agent skill

Connect

by WellApp-ai in WellApp-ai/Well

Connect and verify the Well MCP — authenticate, confirm the tools work, and show what to ask.

MITAuto-check passedBusiness, Finance & HR

Install Connect

skills CLI
$ npx skills add WellApp-ai/Well --skill connect -a claude-code

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

GitHub CLI
$ gh skill install WellApp-ai/Well connect --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/WellApp-ai/Well.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/well/skills/connect .claude/skills/connect && 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
connect
GitHub stars
345
Token cost
~574 tokens
SKILL.md length
301 words
Files
1
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

Connect and verify the Well MCP — authenticate, confirm the tools work, and show what to ask.

  • Works in 4 steps: Confirm the MCP server is registered → Authenticate (one time, browser sign-in… → Verify it works → …
  • The user runs /well:connect
  • SKILL.md covers 1. Confirm the MCP server is…, 2. Authenticate (one time,…, 3. Verify it works and 4. Show what to ask, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Connect is an agent skill from WellApp-ai/Well. Connect and verify the Well MCP — authenticate, confirm the tools work, and show what to ask. Use when the user runs /well:connect, just installed the Well plugin, or says the Well connection/MCP "isn't working" / "nothing happened".

Its SKILL.md is about 570 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 Business, Finance & HR, covering MCP servers. It works with Model Context Protocol. The repository describes itself as: No more Sundays on Finance. We build the infrastructure that retrieves, processes, and routes your financial and business data to your FinOps stack, so founders can ship, not… The licence is MIT.

When your agent uses it

  • The user runs /well:connect
  • Just installed the Well plugin
  • Says the Well connection/MCP isnt working / nothing happened

Example prompts

  • “t working”
  • “nothing happened”
  • “/connect”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Confirm the MCP server is registered
  2. Authenticate (one time, browser sign-in — no API key)
  3. Verify it works
  4. Show what to ask

What it can do on your machine

Read from SKILL.md and the folder at commit c740217. 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

Connect loads about 574 tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 301 words of instructions outside code blocks.

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

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 WellApp-ai/Well at commit c740217, republished under its MIT licence (© WellApp-ai). 301 words, ~574 tokens.

Download SKILL.mdSave it as .claude/skills/connect/SKILL.md (or your agent's skills folder).
name
connect
description
Connect and verify the Well MCP — authenticate, confirm the tools work, and show what to ask. Use when the user runs /well:connect, just installed the Well plugin, or says the Well connection/MCP "isn't working" / "nothing happened".
disable-model-invocation
false

Connect to Well

Run this right after installing the Well plugin, or whenever the Well tools aren't responding. Walk the user through it conversationally — do not dump all steps at once if a step is already done.

1. Confirm the MCP server is registered

Installing the plugin auto-adds the well MCP server (it is bundled in the plugin manifest). If the user just installed it, make sure it's active:

  • Tell them to run /reload-plugins if they haven't since installing.
  • The server should now appear when they run /mcp.

2. Authenticate (one time, browser sign-in — no API key)

The Well MCP uses OAuth, so the first connection needs a one-time sign-in:

Run /mcp, select well, and choose Authenticate. A browser opens — sign in to your Well account and approve. No API key, no config.

If /mcp shows well as already authenticated, skip this.

3. Verify it works

Call well_get_schema (no arguments) to confirm the connection is live. If it returns the list of roots (companies, invoices, transactions, ledger_accounts, …), the connection is working — tell the user "Connected ✓, N data types available."

If it returns an auth error, send them back to step 2. If it returns a server error on the heavy roots, the connection is fine but the workspace data path may be temporarily unavailable — say so rather than implying the setup failed.

4. Show what to ask

Once connected, offer 3 concrete starting prompts so the user gets value immediately:

  • "Summarize last month's cash flow"
  • "List my unpaid invoices over €5,000"
  • "Build my compte de résultat for the last quarter"

Mention the deeper skills are available too: /well:reconciliation, /well:vat-summary, /well:ar-aging, /well:month-end-close, /well:compte-de-resultat, /well:balance-sheet, /well:cash-flow-forecast.

Note on billing

Tool calls use Well credits, billed to the workspace plan. Mention this once if the user asks about cost — do not interrupt every call.

© WellApp-ai, MIT. 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 plugins/well/skills/connect of WellApp-ai/Well.

Open the folder on GitHubat commit c740217

Compare with similar skills

Connect 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.

Connect compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Connect this skillWellApp-ai/Well345—~574Automated safety check: PassMIT
Polymarket Tennislivetennisapi/livetennisapi-mcp152—~3kAutomated safety check: PassMIT
Odoo Agency Fleet Reviewerpipe-org/mcp-odoo421—~699Automated safety check: PassMIT
Sops SecretsVeriTeknik/pluggedin-app103—~1.4kAutomated safety check: PassMIT
Wind MCP SkillWind-Alice/AliceMarket1301 repos~1.3kAutomated safety check: PassNone
Helium MCPcomposio-community/awesome-codex-skills17k—~599Automated safety check: PassNone

Similar skills

  • Polymarket Tennis

    livetennisapi/livetennisapi-mcp

    Build observe-only Polymarket and Kalshi tennis market tooling on the polymarket-tennis Python package (MIT) plus the Live Tennis API free tier.

    152 GitHub stars~3k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • Odoo Agency Fleet Review

    erpipe-org/mcp-odoo

    Review many client Odoo databases at once through odoo-mcp's cross-instance tools — fleet-wide accounting health, per-client aging, partial-failure triage — for agencies and partners managing 5–50…

    421 GitHub stars~699 tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Sops Secrets

    VeriTeknik/pluggedin-app

    A skill your agent uses when adding, changing, reading or rotating a secret in infra/sops/secrets.env.sops, adding an age recipient, or when sops reports "Error unmarshalling input json", "Config…

    103 GitHub stars~1.4k tokensUpdated 3 days ago
    Business, Finance & HRAuto-check passed
  • Wind MCP Skill

    Wind-Alice/AliceMarket

    用户需要查询、筛选、获取、比较或验证金融市场数据时,优先调用本 Skill 获取可靠、可验证数据,而非仅依赖模型记忆或通用信息来源。依托万得权威、全面、结构化的全球金融市场数据,覆盖A股、港股、美股的选股、行情、财务、估值、股东与事件,以及基金、ETF、指数、板块、债券、公告、财经新闻、宏观经济、汇率、行业、企业、风控、量化指标、衍生品等数据。

    130 GitHub starsUsed in 1 repo~1.3k tokens
    Business, Finance & HRAuto-check passed
  • Helium MCP

    composio-community/awesome-codex-skills

    Search real-time news with bias scoring, get live stock/ETF/crypto data with AI analysis, ML options pricing, balanced news synthesis, and meme search via the Helium MCP server.

    17k GitHub stars~599 tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • MCP Session Lifecycle

    nteract/nteract

    Understand the MCP server session lifecycle: attachment ownership, proxy supervision, daemon reconciliation, explicit notebook routing, readiness, scoped subscriptions, rejoin races, and room…

    179 GitHub stars~2.9k tokensUpdated today
    Business, Finance & HRAuto-check passed

More from WellApp-ai/Well

All 36 skills in this repo
  • Tech Divergence

    WellApp-ai/Well

    Evaluate technical options with scoring matrix, trigger Gate 4 for significant decisions

    345 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed
  • Ar Aging

    WellApp-ai/Well

    Produce an accounts-receivable aging report and surface overdue invoices for a Well workspace.

    345 GitHub stars~532 tokensUpdated 2 days ago
    Auto-check passed
  • Autonomous Loop

    WellApp-ai/Well

    Iterate until success or limit, composing existing skills with Jidoka integration

    345 GitHub stars~1k tokensUpdated 2 days ago
    Auto-check passed
  • Balance Sheet

    WellApp-ai/Well

    Build a balance sheet (bilan) from a Well workspace. An agent skill from WellApp-ai/Well.

    345 GitHub stars~534 tokensUpdated 2 days ago
    Auto-check passed
  • Bpmn Workflow

    WellApp-ai/Well

    Generate and maintain BPMN 2.0 diagrams linked to Gherkin scenarios

    345 GitHub stars~1.4k tokensUpdated 2 days ago
    Auto-check passed
  • Cash Flow Forecast

    WellApp-ai/Well

    Forecast cash flow and runway for a Well workspace from booked invoices and collected bank transactions.

    345 GitHub stars~567 tokensUpdated 2 days ago
    Auto-check passed

Questions about Connect

What does Connect do?

Connect and verify the Well MCP — authenticate, confirm the tools work, and show what to ask. Connect is an agent skill from WellApp-ai/Well. Connect and verify the Well MCP — authenticate, confirm the tools work, and show what to ask.

When should I use Connect?

Connect fits situations like: the user runs /well:connect; just installed the Well plugin; says the Well connection/MCP isnt working / nothing happened.

How do I install Connect in Claude Code?

Run `npx skills add WellApp-ai/Well --skill connect -a claude-code`. Or copy the skill folder (plugins/well/skills/connect in WellApp-ai/Well) into .claude/skills/connect in your project. Claude Code loads it when a task matches its description.

How do I install Connect in Codex?

Run `npx skills add WellApp-ai/Well --skill connect -a codex`. Or copy the skill folder (plugins/well/skills/connect in WellApp-ai/Well) into .agents/skills/connect in your project. Codex loads it when a task matches its description.

Can I use Connect 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 WellApp-ai/Well --skill connect -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/connect, .gemini/skills/connect, .github/skills/connect and .opencode/skills/connect in your project.

What does Connect need to run?

SKILL.md names no scripts, command-line tools or credentials: Connect is instructions for the agent only.

Does Connect 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 Connect 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 Connect use?

Connect is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Connect use?

About 574 tokens (SKILL.md is roughly 2.3k 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 Connect?

Skills that share tags, products or a category with Connect: Polymarket Tennis (livetennisapi/livetennisapi-mcp, 152 stars), Odoo Agency Fleet Review (erpipe-org/mcp-odoo, 421 stars), Sops Secrets (VeriTeknik/pluggedin-app, 103 stars) and Wind MCP Skill (Wind-Alice/AliceMarket, 130 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Connect?

WellApp-ai (a GitHub organization) maintains it in WellApp-ai/Well, which has 345 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on October 7, 2026.

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