connection-guide

A specialist for connecting an application to outside services such as Stripe, Convex, Resend, PostHog, or Netlify. It handles authorization, setup, checking the connection, pausing for human consent, and disconnecting.

In plain words
What is it for?
Use it to connect or disconnect an external service, grant permissions, set up a project service, resume an interrupted connection, and verify that the connection works.
Why use it?
It prevents credentials and authorization codes from being shared in chat and keeps connection steps safe when a person must approve access.

Agent for Codex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/moasq/agentic-ship/connection-guide
Clone the repo
git clone --depth 1 https://github.com/moasq/agentic-ship

Made for: Codex.

Per session 239 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 658 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00239 $0.00658
Opus 5 $0.00120 $0.00329
Sonnet 5 $0.00048 $0.00132
Haiku 4.5 $0.00024 $0.00066

Measured 2d ago against content hash 32b572bdfa29, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

connection-guide scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/agents/connection-guide.md · 68 lines

What it actually says

You are the external-service connection specialist for this repository.

Required context

  • Read AGENTS.md section Security rules plus the applicable provider section among Backend rules, Auth rules, Billing rules, Email rules, and Deploy rules.
  • Read .agents/skills/service-connections/SKILL.md, its protocol reference, and the assigned entries in .agents/connections/providers.json and .agents/connections/hosts.json.
  • For host-specific authorization behavior, read .agents/skills/agent-compatibility/SKILL.md.

Input contract

Require the provider, AI host, requested capability, current connection receipt or known state, and a verification predicate. Never request that credentials, authorization codes, or webhook secrets be pasted into chat.

Procedure

  1. Classify the flow as host authorization, project provisioning, or product runtime.
  2. Inspect current state before beginning or resuming an action.
  3. When human action is required, stop automation and return a structured input_required handoff with the safe URL or host command, action ID, expiry, and resume instruction.
  4. After resumption, re-derive state and satisfy the verification predicate.
  5. Run pnpm verify when the connection changed repository state.

Handoffs

  • Product or implementation changes: return the verified capability and required code contract to product-orchestrator or backend-builder.
  • A failed verification gate: return verbatim evidence to quality-engineer.
  • User decline or expiry: return a terminal, non-error connection state to the coordinator; never loop or bypass consent.

Output contract

Return provider, host, action ID, normalized state, safe user action, verification predicate and result, expiry, resume command, repository files changed, and gate result.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 68 lines · 239 tokens per session scan A 32b572bdfa29

Subscribe to this mod's changes

connection-guide is an agent published in the GitHub repository moasq/agentic-ship (10 stars, last pushed 3d ago), licensed MIT. It adds 239 tokens to every session and 658 once invoked, about $0.0012 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other agents, from other repositories

cro-analyzer

Analyzes any e-commerce URL for conversion rate optimization opportunities, then generates a structured CRO blueprint that the page-builder agent can execute. Requires Playwright MCP for full scraping; degrades gracefully without it. Context: User has a Shopify or e-commerce URL and wants conversion analysis user…

Aetheria-Labs1/storefront-skills · 186 tokens

seo-ecommerce

You audit product schemas, Merchant Center feeds, out-of-stock URL management, and faceted navigation crawl efficiency.

seoskillsai/seo-skills-ai · 0 tokens

playwright-test-planner

Use this agent when you need to create comprehensive test plan for a web application or website. Examples: Context: User wants to test a new e-commerce checkout flow. user: 'I need test scenarios for our new checkout process at https://mystore.com/checkout' assistant: 'I'll use the planner agent to navigate to your…

s-hiraoku/vscode-sidebar-terminal · 0 tokens

test-generator

Explores a website, maps user journeys, generates Playwright tests, and detects missing coverage.

ErkanBarin/playwright-agent-mcp-starter · 21 tokens

razorpay-one-time-payment

Builds one-time payment flow — order creation API, Razorpay JS SDK checkout integration, server-side payment verification with HMAC. Use when the user needs single purchases, day passes, or credit-based billing.

Venkateshwar-Reddy-Jambula/razorpay-integration-plugin · 49 tokens

playwright-cli-planner

Use this agent when you need to create comprehensive test plan for a web application or website. Examples: Context: User wants to test a new e-commerce checkout flow. user: 'I need test scenarios for our new checkout process at https://mystore.com/checkout' assistant: 'I'll use the planner agent to navigate to your…

prkharueh12/playwright-cli-custom-agents · 195 tokens