New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Square

by Anil-matcha in Anil-matcha/awesome-muse-connectors

Work with Square: list locations and payments, create orders, push Terminal checkouts, charge payment sources, and refund payments.

MITAuto-check passedBackend & APIs

Install Square

skills CLI
$ npx skills add Anil-matcha/awesome-muse-connectors --skill square -a claude-code

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

GitHub CLI
$ gh skill install Anil-matcha/awesome-muse-connectors square --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/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .claude/skills && cp -r skills-src/connectors/square .claude/skills/square && 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
square
GitHub stars
1.3k
Token cost
~1.2k tokens
SKILL.md length
416 words
Files
2
Skills in repo
153
Repo updated
First seen
Licence
MIT

At a glance

Work with Square: list locations and payments, create orders, push Terminal checkouts, charge payment sources, and refund payments.

  • Works in 6 steps: Sandbox is the default and is mandatory… → Terminal checkout and direct charges are… → Refunds are MEDIUM and move real money… → …
  • Phrases: square
  • SKILL.md covers Purpose, Tooling, Auth and Operating Rules, plus 2 more sections
  • Runs Python scripts from its folder; reaches connect.squareupsandbox.com

What it does

Square is an agent skill from Anil-matcha/awesome-muse-connectors. Work with Square: list locations and payments, create orders, push Terminal checkouts, charge payment sources, and refund payments. Trigger phrases: square, square terminal, process payment, refund payment, point of sale.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `bin/square.py`).

It sits in Backend & APIs. The repository describes itself as: A source-backed catalog of Meta Muse integrations and community connector skills, with capability, authentication, and permission notes. The licence is MIT.

When your agent uses it

  • Phrases: square
  • Square terminal
  • Process payment

Example prompts

  • “/square”

Requirements

  • Python 3

Workflow steps

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

  1. Sandbox is the default and is mandatory for testing. Never run a first-time flow against --env prod. Confirm the flow works in sandbox…
  2. Terminal checkout and direct charges are HIGH actuations. POST /v2/terminals/checkouts presents a charge on a physical Terminal; a…
  3. Refunds are MEDIUM and move real money back. POST /v2/refunds requires --confirm with the exact echoed string on every call (this is…
  4. Cancelling a pending Terminal checkout requires --confirm every time; it has no effect once the payment completed.
  5. Square charges processing fees per transaction; check squareup.com pricing for current rates. Every write uses an idempotency key so…
  6. Never exfiltrate the credential: the CLI only ever handles surrogates (see bin/square.py). Do not print, log, or transmit the token.

What it can do on your machine

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

    Ships script files (Python), which the agent can run.

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • connect.squareupsandbox.com

    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

Square loads about 1.2k tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 416 words of instructions outside code blocks.

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

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 Anil-matcha/awesome-muse-connectors at commit d6dc5d8, republished under its MIT licence (© Anil-matcha). 416 words, ~1,201 tokens.

Download SKILL.mdSave it as .claude/skills/square/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
square
description
Work with Square: list locations and payments, create orders, push Terminal checkouts, charge payment sources, and refund payments. Trigger phrases: square, square terminal, process payment, refund payment, point of sale.
metadata.includeInPrompt
true
tagline
Work with a Square seller account: list locations and payments, create orders, push a checkout to a physical Square Terminal for in-person payment, charge a…
catalog_auth
provider OAuth 2.0 or personal access token via the secure credential flow
catalog_hosts
connect.squareup.com, connect.squareupsandbox.com

Square

Purpose

Work with a Square seller account: list locations and payments, create orders, push a checkout to a physical Square Terminal for in-person payment, charge a payment source directly, cancel a pending Terminal checkout, and refund a payment. Reach for this when the user needs to take or return money through Square.

Tooling

All commands go through bin/square.py. Sandbox is the default (--env sandbox); sandbox never moves real money. Add --env prod for production:

bash
bin/square.py auth                                   # verify the token (sandbox)
bin/square.py locations                              # list seller locations
bin/square.py payments --limit 10                    # list payments
bin/square.py payment-get --payment-id PAY_ID        # one payment
bin/square.py order-create --file order.json         # create an order (moves no money)
bin/square.py checkout-create --device-id DEV_ID \
    --amount-cents 1200 --currency USD \
    --confirm "present $12.00 USD charge on terminal DEV_ID"   # push charge to a Terminal
bin/square.py checkout-get --checkout-id CO_ID       # Terminal checkout status
bin/square.py checkout-cancel --checkout-id CO_ID \
    --confirm "cancel terminal checkout CO_ID"        # cancel a pending checkout
bin/square.py charge --source-id SRC_ID \
    --amount-cents 1200 --currency USD \
    --confirm "charge $12.00 USD to payment source SRC_ID"     # charge a payment source
bin/square.py refund --payment-id PAY_ID \
    --amount-cents 1200 --currency USD \
    --confirm "refund $12.00 USD on payment PAY_ID"   # send money back

Amounts are in the currency's smallest unit (--amount-cents 1200 is $12.00). order-create takes a Square order object in JSON and creates an order record only; no money moves until a payment is attached.

Auth

  • Provider id: square (credential is collected as custom.square)
  • Collection: OAuth 2.0 bearer via the secure credential flow (credentials.request_api_access) for third-party apps, or a personal access token for a single account; the runtime performs the token exchange/refresh and hands the CLI a fresh Bearer token, same pattern as the slack and x connectors
  • Auth scheme: Authorization: Bearer <token> on every request
  • Allowed hosts: connect.squareup.com, connect.squareupsandbox.com
  • Sandbox is the CLI default and is mandatory for testing: https://connect.squareupsandbox.com. Switch to production only with --env prod on the command and a production credential stored.
  • Status check: bin/square.py auth
Show full SKILL.md (213 more words)Show less

Operating Rules

  1. Sandbox is the default and is mandatory for testing. Never run a first-time flow against --env prod. Confirm the flow works in sandbox, then switch.
  2. Terminal checkout and direct charges are HIGH actuations. POST /v2/terminals/checkouts presents a charge on a physical Terminal; a customer tapping or inserting a card captures real funds. POST /v2/payments charges a payment source immediately. Both require --confirm with the exact string the CLI echoes (it names the amount, the currency and the target) on every call, in sandbox and in production. Missing or mismatched confirmation refuses the call.
  3. Refunds are MEDIUM and move real money back. POST /v2/refunds requires --confirm with the exact echoed string on every call (this is stricter than the standing first-use-only rule, chosen because a mistaken refund is hard to take back).
  4. Cancelling a pending Terminal checkout requires --confirm every time; it has no effect once the payment completed.
  5. Square charges processing fees per transaction; check squareup.com pricing for current rates. Every write uses an idempotency key so retries cannot double-charge.
  6. Never exfiltrate the credential: the CLI only ever handles surrogates (see bin/square.py). Do not print, log, or transmit the token.

Files

  • SKILL.md
  • bin/square.py

Maturity

Draft: written from Square's public API docs; not yet live-tested end-to-end.

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

Files

SKILL.md and 1 other file in connectors/square of Anil-matcha/awesome-muse-connectors.

  • SKILL.md
  • bin/square.py

Open the folder on GitHubat commit d6dc5d8

Compare with similar skills

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

Square compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Square this skillAnil-matcha/awesome-muse-connectors1.3k—~1.2kAutomated safety check: PassMIT
Configuring Horizoncoollabsio/coolify63k4 repos~898Automated safety check: PassMIT
Nestjs Best Practicesrolling-scopes/rsschool-app10k6 repos~1.2kAutomated safety check: PassMIT
Sub2API AdminWei-Shaw/sub2api43k1 repos~717Automated safety check: PassLGPL-3.0
Firecrawl Build Onboardingfirecrawl/firecrawl190k1 repos~1.4kAutomated safety check: NotesISC
Obsidian BasesAtmosphere/atmosphere3.8k22 repos~3.2kAutomated safety check: PassApache-2.0

Similar skills

  • Configuring Horizon

    coollabsio/coolify

    A skill your agent uses whenever the user mentions Horizon by name in a Laravel context.

    63k GitHub starsUsed in 4 repos~898 tokens
    Backend & APIsAuto-check passed

  • Nestjs Best Practices

    rolling-scopes/rsschool-app

    NestJS best practices and architecture patterns for building production-ready applications.

    10k GitHub starsUsed in 6 repos~1.2k tokens
    Backend & APIsAuto-check passed

  • Sub2API Admin

    Wei-Shaw/sub2api

    Manages a Sub2API deployment from the command line: accounts, redeem and invitation codes, groups, proxies, imports, exports and raw admin API calls.

    43k GitHub starsUsed in 1 repo~717 tokens
    Backend & APIsAuto-check passed

  • Firecrawl Build Onboarding

    firecrawl/firecrawl

    Gets Firecrawl working in a project: signs you in through the browser, saves FIRECRAWL_API_KEY to .env and picks the first SDK or REST path.

    190k GitHub starsUsed in 1 repo~1.4k tokens
    Backend & APIsAuto-check: notes

  • Obsidian Bases

    Atmosphere/atmosphere

    Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.

    3.8k GitHub starsUsed in 22 repos~3.2k tokens
    Backend & APIsAuto-check passed

  • Fortify Development

    coollabsio/coolify

    ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 4 repos~1.9k tokens
    Backend & APIsAuto-check passed

More from Anil-matcha/awesome-muse-connectors

All 153 skills in this repo

  • Airtable

    Anil-matcha/awesome-muse-connectors

    List Airtable bases, read table records, and add records. An agent skill from Anil-matcha/awesome-muse-connectors.

    1.3k GitHub starsUsed in 1 repo~511 tokens
    Auto-check passed

  • Aqara

    Anil-matcha/awesome-muse-connectors

    Read and control Aqara smart home devices: plugs, switches, lights, AC, locks, curtains, scenes.

    1.3k GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed

  • Asana

    Anil-matcha/awesome-muse-connectors

    Read and manage Asana tasks: my tasks, task details, create tasks.

    1.3k GitHub starsUsed in 1 repo~481 tokens
    Auto-check passed

  • Attio

    Anil-matcha/awesome-muse-connectors

    Read and write Attio: list objects, query records, upsert records, add notes and tasks.

    1.3k GitHub starsUsed in 1 repo~621 tokens
    Auto-check passed

  • Beatoven

    Anil-matcha/awesome-muse-connectors

    Beatoven.ai royalty-free music generation: compose tracks, poll tasks, download audio, fetch individual stems.

    1.3k GitHub starsUsed in 1 repo~823 tokens
    Auto-check passed

  • Clickup

    Anil-matcha/awesome-muse-connectors

    List ClickUp workspaces and tasks, and create tasks. An agent skill from Anil-matcha/awesome-muse-connectors.

    1.3k GitHub starsUsed in 1 repo~515 tokens
    Auto-check passed

Categories

Questions about Square

What does Square do?

Work with Square: list locations and payments, create orders, push Terminal checkouts, charge payment sources, and refund payments. Square is an agent skill from Anil-matcha/awesome-muse-connectors. Work with Square: list locations and payments, create orders, push Terminal checkouts, charge payment sources, and refund payments.

When should I use Square?

Square fits situations like: phrases: square; square terminal; process payment.

How do I install Square in Claude Code?

Run `npx skills add Anil-matcha/awesome-muse-connectors --skill square -a claude-code`. Or copy the skill folder (connectors/square in Anil-matcha/awesome-muse-connectors) into .claude/skills/square in your project. Claude Code loads it when a task matches its description.

How do I install Square in Codex?

Run `npx skills add Anil-matcha/awesome-muse-connectors --skill square -a codex`. Or copy the skill folder (connectors/square in Anil-matcha/awesome-muse-connectors) into .agents/skills/square in your project. Codex loads it when a task matches its description.

Can I use Square 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 Anil-matcha/awesome-muse-connectors --skill square -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/square, .gemini/skills/square, .github/skills/square and .opencode/skills/square in your project.

What does Square need to run?

Going by SKILL.md and its folder, Square needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Square access the network?

SKILL.md names 1 domain. In commands or code: connect.squareupsandbox.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Square 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 Square use?

Square 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 Square use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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 Square?

Skills that share tags, products or a category with Square: Configuring Horizon (coollabsio/coolify, 63k stars), Nestjs Best Practices (rolling-scopes/rsschool-app, 10k stars), Sub2API Admin (Wei-Shaw/sub2api, 43k stars) and Firecrawl Build Onboarding (firecrawl/firecrawl, 190k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Square?

Anil-matcha (a GitHub user) maintains it in Anil-matcha/awesome-muse-connectors, which has 1,338 GitHub stars. The repository holds 153 skills in this directory. The repository was last updated on October 5, 2026.

Source: Anil-matcha/awesome-muse-connectors on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.