Stripe Best Practices
kanchengw/cnllm
Guides Stripe integration decisions — API selection (Checkout Sessions vs PaymentIntents), Connect platform setup (Accounts v2, controller properties), billing/subscriptions, Treasury financial…
Classify Flexport REST, OAuth, webhook, and MCP failures into safe operator actions.
Install Flexport Common Errors
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill flexport-common-errors -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install jeremylongshore/tons-of-skills-marketplace flexport-common-errors --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/flexport-common-errors .claude/skills/flexport-common-errors && rm -rf skills-srcUse ~/.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/
Install the "flexport-common-errors" agent skill from https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/skills/.curated/flexport-common-errors into .claude/skills/flexport-common-errors/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flexport-common-errors", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/skills/.curated/flexport-common-errorsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill flexport-common-errors -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install jeremylongshore/tons-of-skills-marketplace flexport-common-errors --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/.curated/flexport-common-errors .agents/skills/flexport-common-errors && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "flexport-common-errors" agent skill from https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/skills/.curated/flexport-common-errors into .agents/skills/flexport-common-errors/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flexport-common-errors", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill flexport-common-errors -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install jeremylongshore/tons-of-skills-marketplace flexport-common-errors --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/.curated/flexport-common-errors .cursor/skills/flexport-common-errors && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "flexport-common-errors" agent skill from https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/skills/.curated/flexport-common-errors into .cursor/skills/flexport-common-errors/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flexport-common-errors", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace.git --path skills/.curated/flexport-common-errors--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill flexport-common-errors -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install jeremylongshore/tons-of-skills-marketplace flexport-common-errors --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/.curated/flexport-common-errors .gemini/skills/flexport-common-errors && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "flexport-common-errors" agent skill from https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/skills/.curated/flexport-common-errors into .gemini/skills/flexport-common-errors/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flexport-common-errors", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install jeremylongshore/tons-of-skills-marketplace flexport-common-errorsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill flexport-common-errors -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/.curated/flexport-common-errors .github/skills/flexport-common-errors && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "flexport-common-errors" agent skill from https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/skills/.curated/flexport-common-errors into .github/skills/flexport-common-errors/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flexport-common-errors", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill flexport-common-errors -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install jeremylongshore/tons-of-skills-marketplace flexport-common-errors --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/.curated/flexport-common-errors .opencode/skills/flexport-common-errors && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "flexport-common-errors" agent skill from https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/skills/.curated/flexport-common-errors into .opencode/skills/flexport-common-errors/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "flexport-common-errors", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
flexport-common-errors- GitHub stars
- 2.8k
- Token cost
- ~1.1k tokens
- SKILL.md length
- 422 words
- Files
- 2 (incl. references)
- Skills in repo
- 3,342
- Repo updated
- First seen
- Licence
- MIT
At a glance
Classify Flexport REST, OAuth, webhook, and MCP failures into safe operator actions.
- Works in 6 steps: Identify the surface → Protect evidence → Classify deterministically → …
- Triaging status/code/message errors
- SKILL.md covers Overview, Prerequisites, Instructions and Authentication, plus 5 more sections
- Reaches api.flexport.com and mcp.flexport.com
What it does
Flexport Common Errors is an agent skill from jeremylongshore/tons-of-skills-marketplace. Classify Flexport REST, OAuth, webhook, and MCP failures into safe operator actions. Use when triaging status/code/message errors, permission failures, validation problems, or ambiguous mutations. Trigger with: "debug Flexport error", "Flexport 422", "Flexport permission denied".
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/official-docs.md`). Compatibility notes: Requires a redacted response receipt with surface, operation, HTTP or JSON-RPC status, and correlation metadata.
It sits in Backend & APIs, covering Webhooks and OAuth and OpenID Connect. It works with Model Context Protocol. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.
When your agent uses it
- Triaging status/code/message errors
- Permission failures
- Validation problems
- Ambiguous mutations
Example prompts
- “debug Flexport error”
- “Flexport 422”
- “Flexport permission denied”
- “/flexport-common-errors”
Requirements
- Compatibility (from SKILL.md): Requires a redacted response receipt with surface, operation, HTTP or JSON-RPC status, and correlation metadata.
- Pre-approved tools (allowed-tools): Read, Grep, Write, Edit
Workflow steps
6 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 80f86df. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
ReadGrepWriteEdit
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are yaml).
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:
api.flexport.commcp.flexport.com
Also links to:
apidocs.flexport.comdevelopers.flexport.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.
Compatibility
Requires a redacted response receipt with surface, operation, HTTP or JSON-RPC status, and correlation metadata.
From compatibility in the SKILL.md frontmatter.
Context cost
Flexport Common Errors loads about 1.1k tokens when it runs, and up to ~1.3k if it reads all its reference files. Until then it costs about 76 tokens; SKILL.md has 422 words of instructions outside code blocks.
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 jeremylongshore/tons-of-skills-marketplace at commit 80f86df, republished under its MIT licence (© jeremylongshore). 422 words, ~1,077 tokens.
Download SKILL.mdSave it as
.claude/skills/flexport-common-errors/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- flexport-common-errors
- description
- Classify Flexport REST, OAuth, webhook, and MCP failures into safe operator actions. Use when triaging status/code/message errors, permission failures, validation problems, or ambiguous mutations. Trigger with: "debug Flexport error", "Flexport 422", "Flexport permission denied".
- allowed-tools
- Read, Grep, Write, Edit
- compatibility
- Requires a redacted response receipt with surface, operation, HTTP or JSON-RPC status, and correlation metadata.
- version
- 2.0.0
- argument-hint
- [redacted-failure-receipt]
- model
- inherit
- effort
- high
- license
- MIT
- author
- Jeremy Longshore <jeremy@intentsolutions.io>
- tags
- saas, flexport, errors, operations
Flexport Failure Classification
Overview
Do not convert every failure into a retry. First identify the surface and operation class, then distinguish authentication, authorization, validation, provider availability, and ambiguous mutation outcomes.
Prerequisites
- Redacted surface and operation name
- HTTP status or JSON-RPC error plus documented provider code/message
- Knowledge of whether the failed operation could mutate freight or trade records
Instructions
Step 1: Identify the surface
Label OAuth token, REST v3, MCP JSON-RPC, or webhook delivery; each has different failure semantics.
Step 2: Protect evidence
Capture timestamp, credential alias, version header, operation digest, status/code/message, and provider correlation metadata without payloads or secrets.
Step 3: Classify deterministically
Separate 401 authentication, 403 permission/scope, 404 resource or route, 400/422 request validation, throttling evidence, and 5xx/transport uncertainty.
Step 4: Choose retry eligibility
Retry only transient, idempotent work with bounded backoff. Never retry a create or booking until its prior outcome is reconciled.
Step 5: Correct the owner
Route credential issues to credential owners, schema issues to integration owners, business validation to data owners, and provider incidents to support.
Step 6: Close with a proof
Record the corrected contract or recovered result and add a regression fixture when the defect was local.
Authentication
REST calls authenticate with a cached OAuth 2.0 client-credentials Bearer token using audience https://api.flexport.com, or an explicitly accepted broad API key. Use distinct credentials per workload and never log credentials or tokens. MCP calls use the authenticated connection to https://mcp.flexport.com/mcp and remain subject to each tool's documented account permissions.
Show full SKILL.md (178 more words)Show less
Tool Discipline
Use Read and Grep for discovery and evidence. Use Write or Edit only for the approved artifact, code, configuration, test, or receipt described by this workflow; do not make an unapproved Flexport-side change.
Output
- Scoped decision or implementation artifact
- Redacted operation and validation receipt
- Failure, rollback, and follow-up ownership record
Return a machine-reviewable receipt in this shape; adapt the operation values, but never place credentials or provider payloads in it:
surface: rest-v3
operation: shipment-read
decision: approved
outcome: verified
evidence:
release_sha: recorded-out-of-band
provider_reference: redacted
rollback_owner: logistics-platformExamples
A document upload returns 422 with a provider message. The operator preserves the code/message, fixes the source document metadata, and submits a new approved operation rather than repeatedly sending the unchanged payload.
Error Handling
| Failure | Response |
|---|---|
| 401 persists after one cached-token refresh | Stop and inspect credential revocation, audience, and secret source. |
| 403 on one endpoint | Verify OAuth endpoint resources or MCP role permission; do not broaden silently. |
404 on /tools/... | Use the real MCP JSON-RPC endpoint rather than the synthetic docs path. |
| Timeout after mutation | Reconcile using known references before any retry. |
Resources
© jeremylongshore, 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 (references) in skills/.curated/flexport-common-errors of jeremylongshore/tons-of-skills-marketplace.
- SKILL.md
- references/official-docs.md
Open the folder on GitHubat commit 80f86df
Compare with similar skills
Flexport Common Errors 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Flexport Common Errors this skilljeremylongshore/tons-of-skills-marketplace | 2.8k | — | ~1.1k | Automated safety check: Pass | MIT | |
| Stripe Best Practiceskanchengw/cnllm | 175 | 2 repos | ~925 | Automated safety check: Pass | Apache-2.0 | |
| X Twitter ScraperXquik-dev/x-twitter-scraper | 210 | 1 repos | ~2.6k | Automated safety check: Pass | MIT | |
| Zalo AgentPhucMPham/zalo-agent-cli | 164 | — | ~2.3k | Automated safety check: Pass | MIT | |
| Xquik MCPXquik-dev/x-twitter-scraper | 210 | 1 repos | ~997 | Automated safety check: Pass | MIT | |
| Discord Php Bot Securitydiscord-php/DiscordPHP | 1.1k | — | ~1.2k | Automated safety check: Notes | MIT |
Similar skills
X Twitter Scraper
Xquik-dev/x-twitter-scraper
Use Xquik to fetch X (Twitter) data or act through a connected account: search, profiles, followers, replies, threads, timelines, media downloads, bulk exports, trends, monitors, signed webhooks…
Zalo Agent
PhucMPham/zalo-agent-cli
Automate Zalo messaging, Official Account (OA), and MCP server integration via zalo-agent-cli.
Xquik MCP
Xquik-dev/x-twitter-scraper
Connect, verify, and troubleshoot Xquik's remote MCP server.
Discord Php Bot Security
discord-php/DiscordPHP
Audit checklist for DiscordPHP bots and API libraries — stop the bot token leaking to third-party APIs or logs, keep secrets out of customids and exception messages, use constant-time comparison and…
GitHub OAuth Nango Integration
AgentWorkforce/relay
A skill your agent uses when implementing GitHub OAuth + GitHub App authentication with Nango - provides two-connection pattern for user login and repo access with webhook handling
More from jeremylongshore/tons-of-skills-marketplace
All 3,342 skills in this repoPerforming Security Code Review
jeremylongshore/tons-of-skills-marketplace
Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.
Adapting Transfer Learning Models
jeremylongshore/tons-of-skills-marketplace
Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.
Agent Context Loader
jeremylongshore/tons-of-skills-marketplace
Execute proactive auto-loading: automatically detects and loads agents.md files.
Aggregating Performance Metrics
jeremylongshore/tons-of-skills-marketplace
Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.
Analyzing Capacity Planning
jeremylongshore/tons-of-skills-marketplace
Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.
Analyzing Database Indexes
jeremylongshore/tons-of-skills-marketplace
Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.
Related
Works with
Categories
Questions about Flexport Common Errors
What does Flexport Common Errors do?
Classify Flexport REST, OAuth, webhook, and MCP failures into safe operator actions. Flexport Common Errors is an agent skill from jeremylongshore/tons-of-skills-marketplace. Classify Flexport REST, OAuth, webhook, and MCP failures into safe operator actions.
When should I use Flexport Common Errors?
Flexport Common Errors fits situations like: triaging status/code/message errors; permission failures; validation problems; ambiguous mutations.
How do I install Flexport Common Errors in Claude Code?
Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill flexport-common-errors -a claude-code`. Or copy the skill folder (skills/.curated/flexport-common-errors in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/flexport-common-errors in your project. Claude Code loads it when a task matches its description.
How do I install Flexport Common Errors in Codex?
Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill flexport-common-errors -a codex`. Or copy the skill folder (skills/.curated/flexport-common-errors in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/flexport-common-errors in your project. Codex loads it when a task matches its description.
Can I use Flexport Common Errors 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 jeremylongshore/tons-of-skills-marketplace --skill flexport-common-errors -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/flexport-common-errors, .gemini/skills/flexport-common-errors, .github/skills/flexport-common-errors and .opencode/skills/flexport-common-errors in your project.
What does Flexport Common Errors need to run?
SKILL.md names no scripts, command-line tools or credentials: Flexport Common Errors is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Grep, Write, Edit. Compatibility (from SKILL.md): Requires a redacted response receipt with surface, operation, HTTP or JSON-RPC status, and correlation metadata..
Does Flexport Common Errors access the network?
SKILL.md names 4 domains. In commands or code: api.flexport.com and mcp.flexport.com; the agent is likely to contact these when it follows the instructions. As links in the text: apidocs.flexport.com and developers.flexport.com. This is read from the text; nothing was executed.
Is Flexport Common Errors 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 Flexport Common Errors use?
Flexport Common Errors is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Flexport Common Errors use?
About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 213 tokens, read only when the agent opens those files.
What are the alternatives to Flexport Common Errors?
Skills that share tags, products or a category with Flexport Common Errors: Stripe Best Practices (kanchengw/cnllm, 175 stars), X Twitter Scraper (Xquik-dev/x-twitter-scraper, 210 stars), Zalo Agent (PhucMPham/zalo-agent-cli, 164 stars) and Xquik MCP (Xquik-dev/x-twitter-scraper, 210 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Flexport Common Errors?
jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,825 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 9, 2026.
Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.