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…
外部集成架构专家 Owner — 当任务涉及第三方 API、Webhook、OAuth、回调、provider/connector、配额、重试、降级、供应商锁定、外部故障或集成文档时使用；要求隔离外部边界并设计失败恢复。
Install External Integration Architecture
$ npx skills add devcodex-labs/devcodex --skill external-integration-architecture -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install devcodex-labs/devcodex external-integration-architecture --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/devcodex-labs/devcodex.git skills-src && mkdir -p .claude/skills && cp -r skills-src/content/skills/external-integration-architecture .claude/skills/external-integration-architecture && 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 "external-integration-architecture" agent skill from https://github.com/devcodex-labs/devcodex/tree/main/content/skills/external-integration-architecture into .claude/skills/external-integration-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "external-integration-architecture", 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/devcodex-labs/devcodex/tree/main/content/skills/external-integration-architectureType 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 devcodex-labs/devcodex --skill external-integration-architecture -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install devcodex-labs/devcodex external-integration-architecture --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/devcodex-labs/devcodex.git skills-src && mkdir -p .agents/skills && cp -r skills-src/content/skills/external-integration-architecture .agents/skills/external-integration-architecture && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "external-integration-architecture" agent skill from https://github.com/devcodex-labs/devcodex/tree/main/content/skills/external-integration-architecture into .agents/skills/external-integration-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "external-integration-architecture", 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 devcodex-labs/devcodex --skill external-integration-architecture -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install devcodex-labs/devcodex external-integration-architecture --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/devcodex-labs/devcodex.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/content/skills/external-integration-architecture .cursor/skills/external-integration-architecture && 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 "external-integration-architecture" agent skill from https://github.com/devcodex-labs/devcodex/tree/main/content/skills/external-integration-architecture into .cursor/skills/external-integration-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "external-integration-architecture", 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/devcodex-labs/devcodex.git --path content/skills/external-integration-architecture--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 devcodex-labs/devcodex --skill external-integration-architecture -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install devcodex-labs/devcodex external-integration-architecture --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/devcodex-labs/devcodex.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/content/skills/external-integration-architecture .gemini/skills/external-integration-architecture && 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 "external-integration-architecture" agent skill from https://github.com/devcodex-labs/devcodex/tree/main/content/skills/external-integration-architecture into .gemini/skills/external-integration-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "external-integration-architecture", 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 devcodex-labs/devcodex external-integration-architectureInstalls 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 devcodex-labs/devcodex --skill external-integration-architecture -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/devcodex-labs/devcodex.git skills-src && mkdir -p .github/skills && cp -r skills-src/content/skills/external-integration-architecture .github/skills/external-integration-architecture && 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 "external-integration-architecture" agent skill from https://github.com/devcodex-labs/devcodex/tree/main/content/skills/external-integration-architecture into .github/skills/external-integration-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "external-integration-architecture", 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 devcodex-labs/devcodex --skill external-integration-architecture -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install devcodex-labs/devcodex external-integration-architecture --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/devcodex-labs/devcodex.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/content/skills/external-integration-architecture .opencode/skills/external-integration-architecture && 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 "external-integration-architecture" agent skill from https://github.com/devcodex-labs/devcodex/tree/main/content/skills/external-integration-architecture into .opencode/skills/external-integration-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "external-integration-architecture", 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
external-integration-architecture- GitHub stars
- 439
- Token cost
- ~493 tokens
- SKILL.md length
- 95 words
- Files
- 2
- Skills in repo
- 70
- Repo updated
- First seen
- Licence
- AGPL-3.0
At a glance
外部集成架构专家 Owner — 当任务涉及第三方 API、Webhook、OAuth、回调、provider/connector、配额、重试、降级、供应商锁定、外部故障或集成文档时使用；要求隔离外部边界并设计失败恢复。
- Works in 5 steps: 区分业务契约、内部 provider adapter、外部 payload。 → 识别认证、签名、callback、webhook、重放、幂等和审计边界。 → 设计配额、限流、重试、退避、超时、降级和最终一致性。 → …
- Tasks that involve Webhooks
- SKILL.md covers 定位, 触发条件, 核心门禁 and 执行步骤, plus 3 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
External Integration Architecture is an agent skill from devcodex-labs/devcodex. 外部集成架构专家 Owner — 当任务涉及第三方 API、Webhook、OAuth、回调、provider/connector、配额、重试、降级、供应商锁定、外部故障或集成文档时使用；要求隔离外部边界并设计失败恢复。
Its SKILL.md is about 490 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `intent.json`).
It sits in Backend & APIs, covering Webhooks and OAuth and OpenID Connect. The repository describes itself as: Intent-driven AI coding workflow runtime for consistent context, skills, approvals, validation, and handoffs across six AI coding hosts. The licence is AGPL-3.0.
When your agent uses it
- Tasks that involve Webhooks
- Tasks that involve OAuth and OpenID Connect
Example prompts
- “/external-integration-architecture”
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- 区分业务契约、内部 provider adapter、外部 payload。
- 识别认证、签名、callback、webhook、重放、幂等和审计边界。
- 设计配额、限流、重试、退避、超时、降级和最终一致性。
- 记录供应商锁定、替换成本、兼容层和迁移路径。
- 为成功、失败、部分成功、重复回调和外部不可用建立验证。
What it can do on your machine
Read from SKILL.md and the folder at commit 1dd4525. 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 (its code samples are markdown).
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
External Integration Architecture loads about 493 tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 95 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 devcodex-labs/devcodex at commit 1dd4525, republished under its AGPL-3.0 licence (© devcodex-labs). 95 words, ~493 tokens.
Download SKILL.mdSave it as
.claude/skills/external-integration-architecture/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- external-integration-architecture
- description
- 外部集成架构专家 Owner — 当任务涉及第三方 API、Webhook、OAuth、回调、provider/connector、配额、重试、降级、供应商锁定、外部故障或集成文档时使用；要求隔离外部边界并设计失败恢复。
External Integration Architecture Skill
定位
本 Skill 负责外部集成 Owner 视角。它要求把第三方能力当作不稳定边界处理：认证、回调、配额、重试、降级、审计和退出策略都要可验证。
触发条件
| 场景 | 是否触发 |
|---|---|
| 第三方 API、OAuth、Webhook、callback、provider、connector、adapter、外部 SDK | 必须 |
| 任务涉及重试、超时、配额、限流、外部失败、降级、供应商锁定或回放 | 必须 |
| 文档或示例描述外部接入流程 | 必须 |
| 纯仓库内部逻辑且无外部系统边界 | N/A + skipReason |
核心门禁
| Gate | 要求 | 证据 |
|---|---|---|
ExternalIntegrationArchitectureGate | 外部边界、认证回调、配额重试、降级和锁定风险必须成矩阵 | providerBoundary、quotaRetryPolicy |
ProviderBoundaryGate | 外部 payload 不得污染公共业务契约 | adapter、mapper、contract |
AuthCallbackGate | OAuth、签名、回调、重放和状态校验必须设计 | authCallbackModel |
QuotaRetryDegradationGate | 配额、重试、幂等、超时、降级和失败恢复必须明确 | failureDegradation |
VendorLockInGate | 供应商锁定和替换成本必须说明 | lockInExitPlan |
执行步骤
- 区分业务契约、内部 provider adapter、外部 payload。
- 识别认证、签名、callback、webhook、重放、幂等和审计边界。
- 设计配额、限流、重试、退避、超时、降级和最终一致性。
- 记录供应商锁定、替换成本、兼容层和迁移路径。
- 为成功、失败、部分成功、重复回调和外部不可用建立验证。
输出字段
## ExternalIntegrationArchitectureGate
| 字段 | 内容 |
|------|------|
| providerBoundary | 业务契约 / adapter / 外部 payload 边界 |
| authCallbackModel | OAuth、签名、callback、webhook、重放防护 |
| quotaRetryPolicy | 配额、限流、超时、重试、退避 |
| webhookIdempotency | webhook 去重、幂等、顺序和重放 |
| failureDegradation | 外部失败、部分成功、降级、恢复 |
| lockInExitPlan | 供应商锁定、替换成本、迁移策略 |
| evidenceMatrix | 判断 -> 官方文档 / 代码 / 测试 / 日志 / 运行时证据 |反模式
| 反模式 | 修正 |
|---|---|
| 直接把 provider 字段暴露给业务 API | 使用 mapper 和标准 result |
| 只处理 200 响应 | 补配额、超时、重试、部分成功和失败恢复 |
| Webhook 不做幂等和重放处理 | 定义 event id、signature、dedupe、replay 策略 |
| 集成文档只写申请 key | 补 callback、权限、限制、错误和恢复 |
与其他 Skill 的关系
api-contract-architecture：外部 adapter 不能反向污染公共 API。security-threat-modeling：认证、签名、webhook 和密钥边界需要威胁建模。production-readiness-sre：外部故障、配额和降级进入运行风险矩阵。
© devcodex-labs, AGPL-3.0. 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 content/skills/external-integration-architecture of devcodex-labs/devcodex.
- SKILL.md
- intent.json
Open the folder on GitHubat commit 1dd4525
Compare with similar skills
External Integration Architecture 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 |
|---|---|---|---|---|---|---|
| External Integration Architecture this skilldevcodex-labs/devcodex | 439 | — | ~493 | Automated safety check: Pass | AGPL-3.0 | |
| Stripe Best Practiceskanchengw/cnllm | 175 | 3 repos | ~925 | Automated safety check: Pass | Apache-2.0 | |
| Discord Php Bot Securitydiscord-php/DiscordPHP | 1.1k | — | ~1.2k | Automated safety check: Notes | MIT | |
| GitHub OAuth Nango IntegrationAgentWorkforce/relay | 866 | 1 repos | ~3.4k | Automated safety check: Pass | Apache-2.0 | |
| Frappe Core APIImpertio-Studio/Frappe_Claude_Skill_Package | 187 | 1 repos | ~3.2k | Automated safety check: Pass | MIT | |
| Frappe Errors APIImpertio-Studio/Frappe_Claude_Skill_Package | 187 | 1 repos | ~4k | Automated safety check: Pass | MIT |
Similar skills
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
Frappe Core API
Impertio-Studio/Frappe_Claude_Skill_Package
A skill your agent uses when building ERPNext/Frappe API integrations (v14/v15/v16) including REST API, RPC API, authentication, webhooks, and rate limiting.
Frappe Errors API
Impertio-Studio/Frappe_Claude_Skill_Package
A skill your agent uses when debugging or handling API errors in Frappe/ERPNext v14/v15/v16.
Add OAuth Integration
rome-os/rome
Add a new Rome-managed OAuth integration for a third-party service so a user can delegate access by clicking Connect, and Rome can act on the service with the delegated token (the GitHub/Slack model…
More from devcodex-labs/devcodex
All 70 skills in this repoAccessibility I18n
devcodex-labs/devcodex
无障碍与国际化专家 Owner — 当任务涉及可访问性、键盘操作、焦点、屏幕阅读器、ARIA、语言地区、本地化、RTL、翻译资源、用户可见文案或多语言文档时使用；要求把包容性体验和本地化验证绑定到真实用户路径。
AI Agent System Architecture
devcodex-labs/devcodex
AI Agent 系统架构专家 Owner — 当任务涉及 Agent 路由、工具调用、上下文管理、记忆、状态机、权限、人机协作、可观测性、回放验证或模型辅助治理时使用；要求把 Agent 行为设计成可解释、可恢复、可审计。
API Contract Architecture
devcodex-labs/devcodex
API 契约架构专家 Owner — 当任务涉及 public API、HTTP/SDK/CLI 契约、版本兼容、错误模型、分页过滤、幂等、Schema、类型、迁移或消费者影响时使用；要求先冻结消费者契约，再设计实现与验证。
Architecture Design
devcodex-labs/devcodex
架构设计文档编排 Owner — 当用户要求架构设计、系统设计、技术架构或可指导开发、Review 与任务拆分的完整方案时使用；要求从业务流程反推节点、状态、数据、一致性、异常补偿、ADR 与实施任务。
Audit Common
devcodex-labs/devcodex
审查公共维度 G0~G5 + Profile Freshness Check — 所有 audit 子类型必先执行的基础维度层
Audit Session
devcodex-labs/devcodex
审计工作流的跨会话状态机 — 在 <audit-root/.audit-state/<session-id.json 持久化轮次/发现项/收敛状态，支持 Token 中断后精准恢复
Related
Categories
Questions about External Integration Architecture
What does External Integration Architecture do?
外部集成架构专家 Owner — 当任务涉及第三方 API、Webhook、OAuth、回调、provider/connector、配额、重试、降级、供应商锁定、外部故障或集成文档时使用；要求隔离外部边界并设计失败恢复。. External Integration Architecture is an agent skill from devcodex-labs/devcodex.
When should I use External Integration Architecture?
External Integration Architecture fits situations like: tasks that involve Webhooks; tasks that involve OAuth and OpenID Connect.
How do I install External Integration Architecture in Claude Code?
Run `npx skills add devcodex-labs/devcodex --skill external-integration-architecture -a claude-code`. Or copy the skill folder (content/skills/external-integration-architecture in devcodex-labs/devcodex) into .claude/skills/external-integration-architecture in your project. Claude Code loads it when a task matches its description.
How do I install External Integration Architecture in Codex?
Run `npx skills add devcodex-labs/devcodex --skill external-integration-architecture -a codex`. Or copy the skill folder (content/skills/external-integration-architecture in devcodex-labs/devcodex) into .agents/skills/external-integration-architecture in your project. Codex loads it when a task matches its description.
Can I use External Integration Architecture 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 devcodex-labs/devcodex --skill external-integration-architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/external-integration-architecture, .gemini/skills/external-integration-architecture, .github/skills/external-integration-architecture and .opencode/skills/external-integration-architecture in your project.
What does External Integration Architecture need to run?
SKILL.md names no scripts, command-line tools or credentials: External Integration Architecture is instructions for the agent only.
Does External Integration Architecture 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 External Integration Architecture 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 External Integration Architecture use?
External Integration Architecture is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does External Integration Architecture use?
About 493 tokens (SKILL.md is roughly 2k 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 External Integration Architecture?
Skills that share tags, products or a category with External Integration Architecture: Stripe Best Practices (kanchengw/cnllm, 175 stars), Discord Php Bot Security (discord-php/DiscordPHP, 1.1k stars), GitHub OAuth Nango Integration (AgentWorkforce/relay, 866 stars) and Frappe Core API (Impertio-Studio/Frappe_Claude_Skill_Package, 187 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains External Integration Architecture?
devcodex-labs (a GitHub organization) maintains it in devcodex-labs/devcodex, which has 439 GitHub stars. The repository holds 70 skills in this directory. The repository was last updated on September 17, 2026.
Source: devcodex-labs/devcodex on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.