{"id":"40b53446-8b1a-4c6b-8e5a-eb5c68bcabc5","shortId":"zhGBDw","kind":"skill","title":"square-automation","tagline":"Automate Square tasks via Rube MCP (Composio): payments, orders, invoices, locations. Always search tools first for current schemas.","description":"# Square Automation via Rube MCP\n\nAutomate Square payment processing, order management, and invoicing through Composio's Square toolkit via Rube MCP.\n\n## Prerequisites\n\n- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)\n- Active Square connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `square`\n- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas\n\n## Setup\n\n**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.\n\n\n1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds\n2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `square`\n3. If connection is not ACTIVE, follow the returned auth link to complete Square OAuth\n4. Confirm connection status shows ACTIVE before running any workflows\n\n## Core Workflows\n\n### 1. List and Monitor Payments\n\n**When to use**: User wants to view payment history or check payment status\n\n**Tool sequence**:\n1. `SQUARE_LIST_PAYMENTS` - Retrieve payments with optional filters [Required]\n2. `SQUARE_CANCEL_PAYMENT` - Cancel a pending payment if needed [Optional]\n\n**Key parameters**:\n- `begin_time` / `end_time`: RFC 3339 timestamps for date range filtering\n- `sort_order`: 'ASC' or 'DESC' for chronological ordering\n- `cursor`: Pagination cursor from previous response\n- `location_id`: Filter payments by specific location\n\n**Pitfalls**:\n- Timestamps must be RFC 3339 format (e.g., '2024-01-01T00:00:00Z')\n- Pagination required for large result sets; follow `cursor` until absent\n- Only pending payments can be cancelled; completed payments require refunds\n- `SQUARE_CANCEL_PAYMENT` requires exact `payment_id` from list results\n\n### 2. Search and Manage Orders\n\n**When to use**: User wants to find orders by criteria or update order details\n\n**Tool sequence**:\n1. `SQUARE_LIST_LOCATIONS` - Get location IDs for filtering [Prerequisite]\n2. `SQUARE_SEARCH_ORDERS` - Search orders with filters [Required]\n3. `SQUARE_RETRIEVE_ORDER` - Get full details of a specific order [Optional]\n4. `SQUARE_UPDATE_ORDER` - Modify order state or details [Optional]\n\n**Key parameters**:\n- `location_ids`: Array of location IDs to search within (required for search)\n- `query`: Search filter object with date ranges, states, fulfillment types\n- `order_id`: Specific order ID for retrieve/update operations\n- `cursor`: Pagination cursor for search results\n\n**Pitfalls**:\n- `location_ids` is required for SEARCH_ORDERS; get IDs from LIST_LOCATIONS first\n- Order states include: OPEN, COMPLETED, CANCELED, DRAFT\n- UPDATE_ORDER requires the current `version` field to prevent conflicts\n- Search results are paginated; follow `cursor` until absent\n\n### 3. Manage Locations\n\n**When to use**: User wants to view business locations or get location details\n\n**Tool sequence**:\n1. `SQUARE_LIST_LOCATIONS` - List all business locations [Required]\n\n**Key parameters**:\n- No required parameters; returns all accessible locations\n- Response includes `id`, `name`, `address`, `status`, `timezone`\n\n**Pitfalls**:\n- Location IDs are required for most other Square operations (orders, payments)\n- Always cache location IDs after first retrieval to avoid redundant calls\n- Inactive locations may still appear in results; check `status` field\n\n### 4. Invoice Management\n\n**When to use**: User wants to list, view, or cancel invoices\n\n**Tool sequence**:\n1. `SQUARE_LIST_LOCATIONS` - Get location ID for filtering [Prerequisite]\n2. `SQUARE_LIST_INVOICES` - List invoices for a location [Required]\n3. `SQUARE_GET_INVOICE` - Get detailed invoice information [Optional]\n4. `SQUARE_CANCEL_INVOICE` - Cancel a scheduled or unpaid invoice [Optional]\n\n**Key parameters**:\n- `location_id`: Required for listing invoices\n- `invoice_id`: Required for get/cancel operations\n- `cursor`: Pagination cursor for list results\n- `limit`: Number of results per page\n\n**Pitfalls**:\n- `location_id` is required for LIST_INVOICES; resolve via LIST_LOCATIONS first\n- Only SCHEDULED, UNPAID, or PARTIALLY_PAID invoices can be cancelled\n- CANCEL_INVOICE requires the invoice `version` to prevent race conditions\n- Cancelled invoices cannot be uncancelled\n\n## Common Patterns\n\n### ID Resolution\n\n**Location name -> Location ID**:\n```\n1. Call SQUARE_LIST_LOCATIONS\n2. Find location by name in response\n3. Extract id field (e.g., 'L1234ABCD')\n```\n\n**Order lookup**:\n```\n1. Call SQUARE_SEARCH_ORDERS with location_ids and query filters\n2. Extract order_id from results\n3. Use order_id for RETRIEVE_ORDER or UPDATE_ORDER\n```\n\n### Pagination\n\n- Check response for `cursor` field\n- Pass cursor value in next request's `cursor` parameter\n- Continue until `cursor` is absent or empty\n- Use `limit` to control page size\n\n### Date Range Filtering\n\n- Use RFC 3339 format: `2024-01-01T00:00:00Z`\n- For payments: `begin_time` and `end_time` parameters\n- For orders: Use query filter with date_time_filter\n- All timestamps are in UTC\n\n## Known Pitfalls\n\n**ID Formats**:\n- Location IDs are alphanumeric strings (e.g., 'L1234ABCD')\n- Payment IDs and Order IDs are longer alphanumeric strings\n- Always resolve location names to IDs before other operations\n\n**Versioning**:\n- UPDATE_ORDER and CANCEL_INVOICE require current `version` field\n- Fetch the resource first to get its current version\n- Version mismatch returns a 409 Conflict error\n\n**Rate Limits**:\n- Square API has per-endpoint rate limits\n- Implement backoff for bulk operations\n- Pagination should include brief delays for large datasets\n\n**Response Parsing**:\n- Responses may nest data under `data` key\n- Money amounts are in smallest currency unit (cents for USD)\n- Parse defensively with fallbacks for optional fields\n\n## Quick Reference\n\n| Task | Tool Slug | Key Params |\n|------|-----------|------------|\n| List payments | SQUARE_LIST_PAYMENTS | begin_time, end_time, location_id, cursor |\n| Cancel payment | SQUARE_CANCEL_PAYMENT | payment_id |\n| Search orders | SQUARE_SEARCH_ORDERS | location_ids, query, cursor |\n| Get order | SQUARE_RETRIEVE_ORDER | order_id |\n| Update order | SQUARE_UPDATE_ORDER | order_id, version |\n| List locations | SQUARE_LIST_LOCATIONS | (none) |\n| List invoices | SQUARE_LIST_INVOICES | location_id, cursor |\n| Get invoice | SQUARE_GET_INVOICE | invoice_id |\n| Cancel invoice | SQUARE_CANCEL_INVOICE | invoice_id, version |\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["square","automation","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows"],"capabilities":["skill","source-sickn33","skill-square-automation","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/square-automation","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34515 github stars · SKILL.md body (6,729 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T12:51:49.515Z","embedding":null,"createdAt":"2026-04-18T21:45:22.588Z","updatedAt":"2026-04-22T12:51:49.515Z","lastSeenAt":"2026-04-22T12:51:49.515Z","tsv":"'-01':232,233,693,694 '/mcp':81 '00':235,696 '00z':236,697 '1':101,148,168,288,424,498,610,630 '2':113,178,267,298,508,615,641 '2024':231,692 '3':121,307,406,518,622,647 '3339':196,228,690 '4':136,319,482,527 '409':772 'absent':246,405,676 'access':440 'action':915 'activ':53,126,141 'add':78,95 'address':446 'alphanumer':727,738 'alway':15,63,461,740 'amount':808 'api':91,778 'appear':476 'applic':909 'array':333 'asc':204 'ask':953 'auth':130 'autom':3,4,23,27 'avail':52,106 'avoid':469 'backoff':786 'begin':191,700,836 'boundari':961 'brief':793 'bulk':788 'busi':416,430 'cach':462 'call':64,114,471,611,631 'cancel':180,182,252,258,386,494,529,531,586,587,597,753,843,846,895,898 'cannot':599 'cent':814 'check':163,479,658 'chronolog':208 'clarif':955 'clear':928 'client':88 'common':602 'complet':133,253,385 'composio':10,36 'condit':596 'configur':89 'confirm':108,137 'conflict':397,773 'connect':48,55,59,117,123,138 'continu':672 'control':682 'core':146 'criteria':281,964 'currenc':812 'current':20,71,392,756,766 'cursor':210,212,244,361,363,403,552,554,661,664,670,674,842,858,887 'data':803,805 'dataset':797 'date':199,348,685,712 'defens':818 'delay':794 'desc':206 'describ':916,932 'detail':285,313,327,421,523 'draft':387 'e.g':230,626,729 'empti':678 'end':193,703,838 'endpoint':97,782 'environ':944 'environment-specif':943 'error':774 'exact':261 'execut':911 'expert':949 'extract':623,642 'fallback':820 'fetch':759 'field':394,481,625,662,758,823 'filter':176,201,218,296,305,345,506,640,687,710,714 'find':278,616 'first':18,68,380,466,576,762 'follow':127,243,402 'format':229,691,723 'fulfil':351 'full':312 'get':70,75,292,311,375,419,502,520,522,764,859,888,891 'get/cancel':550 'histori':161 'id':217,263,294,332,336,354,357,369,376,444,451,464,504,541,547,566,604,609,624,637,644,650,722,725,732,735,745,841,849,856,865,872,886,894,901 'implement':785 'inact':472 'includ':383,443,792 'inform':525 'input':958 'invoic':13,34,483,495,511,513,521,524,530,536,545,546,571,583,588,591,598,754,881,884,889,892,893,896,899,900 'key':92,189,329,433,538,806,829 'known':720 'l1234abcd':627,730 'larg':240,796 'limit':558,680,776,784,920 'link':131 'list':149,170,265,290,378,426,428,491,500,510,512,544,556,570,574,613,831,834,874,877,880,883 'locat':14,216,222,291,293,331,335,368,379,408,417,420,427,431,441,450,463,473,501,503,516,540,565,575,606,608,614,617,636,724,742,840,855,875,878,885 'longer':737 'lookup':629 'manag':32,58,116,270,407,484 'match':929 'may':474,801 'mcp':9,26,42,45,77,84,104 'mismatch':769 'miss':966 'modifi':323 'money':807 'monitor':151 'must':46,225 'name':445,607,619,743 'need':93,187 'nest':802 'next':667 'none':879 'number':559 'oauth':135 'object':346 'open':384 'oper':360,458,551,748,789 'option':175,188,318,328,526,537,822 'order':12,31,203,209,271,279,284,301,303,310,317,322,324,353,356,374,381,389,459,628,634,643,649,653,656,707,734,751,851,854,860,863,864,867,870,871 'output':938 'overview':919 'page':563,683 'pagin':211,237,362,401,553,657,790 'paid':582 'param':830 'paramet':190,330,434,437,539,671,705 'pars':799,817 'partial':581 'pass':663 'pattern':603 'payment':11,29,152,160,164,171,173,181,185,219,249,254,259,262,460,699,731,832,835,844,847,848 'pend':184,248 'per':562,781 'per-endpoint':780 'permiss':959 'pitfal':223,367,449,564,721 'prerequisit':43,297,507 'prevent':396,594 'previous':214 'process':30 'queri':343,639,709,857 'quick':824 'race':595 'rang':200,349,686 'rate':775,783 'redund':470 'refer':825 'refund':256 'request':668 'requir':177,238,255,260,306,340,371,390,432,436,453,517,542,548,568,589,755,957 'resolut':605 'resolv':572,741 'resourc':761 'respond':112 'respons':215,442,621,659,798,800 'result':241,266,366,399,478,557,561,646 'retriev':172,309,467,652,862 'retrieve/update':359 'return':129,438,770 'review':950 'rfc':195,227,689 'rube':8,25,41,44,49,57,65,76,103,109,115 'rube.app':80 'rube.app/mcp':79 'run':143 'safeti':960 'schedul':533,578 'schema':21,73 'scope':931 'search':16,50,66,110,268,300,302,338,342,344,365,373,398,633,850,853 'sequenc':167,287,423,497 'server':85 'set':242 'setup':74 'show':140 'size':684 'skill':907,923 'skill-square-automation' 'slug':828 'smallest':811 'sort':202 'source-sickn33' 'specif':221,316,355,945 'squar':2,5,22,28,38,54,62,120,134,169,179,257,289,299,308,320,425,457,499,509,519,528,612,632,777,833,845,852,861,868,876,882,890,897 'square-autom':1 'state':325,350,382 'status':139,165,447,480 'still':475 'stop':951 'string':728,739 'substitut':941 'success':963 't00':234,695 'task':6,826,927 'test':947 'time':192,194,701,704,713,837,839 'timestamp':197,224,716 'timezon':448 'tool':17,51,67,72,111,166,286,422,496,827 'toolkit':39,61,119 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'treat':936 'type':352 'uncancel':601 'unit':813 'unpaid':535,579 'updat':283,321,388,655,750,866,869 'usd':816 'use':155,274,411,487,648,679,688,708,905,921 'user':156,275,412,488 'utc':719 'valid':946 'valu':665 'verifi':102 'version':393,592,749,757,767,768,873,902 'via':7,24,40,56,573 'view':159,415,492 'want':157,276,413,489 'within':339 'work':100 'workflow':145,147,913","prices":[{"id":"25c213cd-a7ff-490c-be05-1f307a7dfa05","listingId":"40b53446-8b1a-4c6b-8e5a-eb5c68bcabc5","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:45:22.588Z"}],"sources":[{"listingId":"40b53446-8b1a-4c6b-8e5a-eb5c68bcabc5","source":"github","sourceId":"sickn33/antigravity-awesome-skills/square-automation","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/square-automation","isPrimary":false,"firstSeenAt":"2026-04-18T21:45:22.588Z","lastSeenAt":"2026-04-22T12:51:49.515Z"}],"details":{"listingId":"40b53446-8b1a-4c6b-8e5a-eb5c68bcabc5","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"square-automation","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34515,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-22T06:40:00Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"1cc4e20cc14f0e1ed5dfb9794059107d94da1028","skill_md_path":"skills/square-automation/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/square-automation"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","frontmatter":{"name":"square-automation","description":"Automate Square tasks via Rube MCP (Composio): payments, orders, invoices, locations. Always search tools first for current schemas."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/square-automation"},"updatedAt":"2026-04-22T12:51:49.515Z"}}