SkillsAdd

forcedotcom/sf-skills

integration-connectivity-generate

Salesforce integration architecture and runtime plumbing with 120-point scoring. Use this skill to set up Named Credentials, External Credentials, External Services, REST/SOAP callout patterns, Platform Events, and Change Data Capture. TRIGGER when: user sets up Named Credentials, External Services, REST/SOAP callouts, Platform Events, CDC, or touches .namedCredential-meta.xml files. DO NOT TRIGGER when: Connected App/OAuth config (use integration-connectivity-connected-app-configure), Apex-onl…

All-time #2718 Trending #6426 First seen Jun 26, 2026
8-week activity · all time api

Installation

$ npx skills add forcedotcom/sf-skills --skill integration-connectivity-generate
View on skills.sh ↗ GitHub repository ↗

Summary

  • Salesforce integration architecture and runtime plumbing with 120-point scoring.
  • Use this skill to set up Named Credentials, External Credentials, External Services, REST/SOAP callout patterns, Platform Events, and Change Data Capture.
  • TRIGGER when: user sets up Named Credentials, External Services, REST/SOAP callouts, Platform Events, CDC, or touches .namedCredential-meta.xml files.
  • DO NOT TRIGGER when: Connected App/OAuth config (use integration-connectivity-connected-app-configure), Apex-only logic (use platform-apex-generate), data import/export (use platform-data-manage), or CDC channel-membership metadata such as PlatformEventChannel, PlatformEventChannelMember, or EnrichedField (use integration-eventing-cdc-configure).

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

private-connectivity Similar name
grafana/skills

Set up private network connectivity to Grafana Cloud — AWS PrivateLink, Azure Private Link, GCP…

2.8K installs
sap-btp-connectivity Similar name
secondsky/sap-skills

SAP BTP Connectivity skill covering Destination Service, Connectivity Service, Cloud Connector,…

9 installs
exchange-connectivity Similar name
joellewis/finance_skills

Guide the design and management of trading venue connectivity and market data infrastructure. O…

535 installs

Also in this package

Other skills from forcedotcom/sf-skills · top by installs.

npx skills add forcedotcom/sf-skills
platform-apex-generate 6.1K platform-apex-test-generate 6K platform-apex-logs-debug 6K platform-apex-test-run 5.9K platform-docs-get 5.9K platform-custom-field-generate 5.8K platform-metadata-deploy 5.8K platform-soql-query 5.8K platform-metadata-retrieve 5.7K automation-flow-generate 5.6K

Browse all from forcedotcom/sf-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 972
License LICENSE.txt
Default branch main
Open issues 15
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.1
More metadata
version
1.1
domains
["Integration"]
minApiVersion
61.0
relatedSkills
["agentforce-generate","automation-flow-generate","integration-connectivity-connected-app-configure","integration-eventing-cdc-configure","platform-apex-generate","platform-data-manage","platform-metadata-deploy"]
cliTools
{"0":"tool: [\"jq\"]","semver":">=2.0.0","1":"tool: [\"npm\"]","2":"tool: [\"python3\"]","3":"tool: [\"sf\"]"}

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 9,260 B
  • docs README.md 3,575 B
  • docs SUMMARY.md 776 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 5,103 installs

SKILL.md

integration-connectivity-generate: Salesforce Integration Patterns Expert

Use this skill when the user needs integration architecture and runtime plumbing: Named Credentials, External Credentials, External Services, REST/SOAP callout patterns, Platform Events, CDC, and event-driven integration design.

When This Skill Owns the Task

Use integration-connectivity-generate when the work involves:

  • .namedCredential-meta.xml or External Credential metadata
  • outbound REST/SOAP callouts
  • External Service registration from OpenAPI specs
  • Platform Events, CDC, and event-driven architecture
  • choosing sync vs async integration patterns

Delegate elsewhere when the user is:

  • configuring the OAuth app itself → [integration-connectivity-connected-app-configure](../integration-connectivity-connected-app-configure/SKILL.md)
  • writing Apex-only business logic → [platform-apex-generate](../platform-apex-generate/SKILL.md)
  • deploying metadata → [platform-metadata-deploy](../platform-metadata-deploy/SKILL.md)
  • importing/exporting data → [platform-data-manage](../platform-data-manage/SKILL.md)

Required Context to Gather First

Ask for or infer:

  • integration style: outbound callout, inbound event, External Service, CDC, platform event
  • auth method
  • sync vs async requirement
  • system endpoint / spec details
  • rate limits, retry expectations, and failure tolerance
  • whether this is net-new design or repair of an existing integration

Recommended Workflow

1. Choose the integration pattern

Need Default pattern
authenticated outbound API call Named Credential / External Credential + Apex or Flow
spec-driven API client External Service
trigger-originated callout async callout pattern
decoupled event publishing Platform Events
change-stream consumption CDC

2. Choose the auth model

Prefer secure runtime-managed auth:

  • Named Credentials / External Credentials
  • OAuth or JWT via the right credential model
  • no hardcoded secrets in code

3. Generate from the right templates

Use the provided assets under:

  • assets/named-credentials/
  • assets/external-credentials/
  • assets/external-services/
  • assets/callouts/
  • assets/platform-events/
  • assets/cdc/
  • assets/soap/

4. Validate operational safety

Check:

  • timeout and retry handling
  • async strategy for trigger-originated work
  • logging / observability
  • event retention and subscriber implications

5. Hand off deployment or implementation details

Use:

  • [platform-metadata-deploy](../platform-metadata-deploy/SKILL.md) for deployment
  • [platform-apex-generate](../platform-apex-generate/SKILL.md) for deeper service / retry code
  • [automation-flow-generate](../automation-flow-generate/SKILL.md) for declarative HTTP callout orchestration

High-Signal Rules

  • never hardcode credentials
  • do not do synchronous callouts from triggers
  • define timeout behavior explicitly
  • plan retries for transient failures
  • use middleware / event-driven patterns when outbound volume is high
  • prefer External Credentials architecture for new development when supported

Common anti-patterns:

  • sync trigger callouts
  • no retry or dead-letter strategy
  • no request/response logging
  • mixing auth setup responsibilities with runtime integration design

Output Format

When finishing, report in this order:

  1. Integration pattern chosen
  2. Auth model chosen
  3. Files created or updated
  4. Operational safeguards
  5. Deployment / testing next step

Suggested shape:

Integration: <summary>
Pattern: <named credential / external service / event / cdc / callout>
Files: <paths>
Safety: <timeouts, retries, async, logging>
Next step: <deploy, register, test, or implement>

Cross-Skill Integration

Need Delegate to Reason
OAuth app setup [integration-connectivity-connected-app-configure](../integration-connectivity-connected-app-configure/SKILL.md) consumer key / cert / app config
advanced callout service code [platform-apex-generate](../platform-apex-generate/SKILL.md) Apex implementation
declarative HTTP callout / Flow wrapper [automation-flow-generate](../automation-flow-generate/SKILL.md) Flow orchestration
deploy integration metadata [platform-metadata-deploy](../platform-metadata-deploy/SKILL.md) validation and rollout
use integration from Agentforce [agentforce-generate](../agentforce-generate/SKILL.md) agent action composition

Reference Map

Start here

  • [references/named-credentials-guide.md](references/named-credentials-guide.md)
  • [references/external-services-guide.md](references/external-services-guide.md)
  • [references/callout-patterns.md](references/callout-patterns.md)
  • [references/rest-callout-patterns.md](references/rest-callout-patterns.md)
  • [references/security-best-practices.md](references/security-best-practices.md)

Event-driven / platform patterns

  • [references/event-patterns.md](references/event-patterns.md)
  • [references/platform-events-guide.md](references/platform-events-guide.md)
  • [references/cdc-guide.md](references/cdc-guide.md)
  • [references/event-driven-architecture-guide.md](references/event-driven-architecture-guide.md)
  • [references/messaging-api-v2.md](references/messaging-api-v2.md)

CLI / automation / scoring

  • [references/cli-reference.md](references/cli-reference.md)
  • [references/named-credentials-automation.md](references/named-credentials-automation.md)
  • [references/scoring-rubric.md](references/scoring-rubric.md)
  • [scripts/README.md](scripts/README.md) — automation scripts overview (configure-named-credential.sh, set-api-credential.sh)

Asset templates

  • assets/named-credentials/ — Named Credential XML templates (OAuth, JWT, Certificate, Custom auth)
  • assets/external-credentials/ — External Credential XML templates (OAuth, JWT)
  • assets/external-services/ — External Service registration template and operations guide
  • assets/callouts/ — REST sync, Queueable, retry handler, and HTTP response handler Apex templates
  • assets/platform-events/ — Platform Event definition, publisher, and subscriber templates
  • assets/cdc/ — CDC handler and subscriber trigger templates
  • assets/soap/ — SOAP callout service template and wsdl2apex guide
  • assets/endpoint-security/ — Remote Site Setting and CSP Trusted Site XML templates

Automation hooks

  • scripts/suggestcredentialsetup.py — auto-suggests credential configuration steps when integration files are detected
  • scripts/validate_integration.py — validates integration patterns before agent responses

Output Expectations

When this skill completes an integration task, it produces:

  1. Credential metadata — one or more files in assets/named-credentials/ or assets/external-credentials/ filled with org-specific values
  2. Callout Apex class — a .cls file using the Named Credential pattern, with async/sync pattern chosen based on context
  3. Event/CDC artifacts — Platform Event .object-meta.xml, subscriber trigger, or CDC config (when event-driven pattern is chosen)
  4. Endpoint security metadata — Remote Site Setting and/or CSP Trusted Site XML files
  5. Scoring report — 120-point score across 6 categories (Security, Error Handling, Bulkification, Architecture, Best Practices, Documentation)
  6. Next step — a deployment or testing instruction for the generated artifacts

Score Guide

Score Meaning
108+ strong production-ready integration design
90–107 good design with some hardening left
72–89 workable but needs architectural review
< 72 unsafe / incomplete for deployment

Pre-Delivery Checklist

  • Never hardcode credentials — all secrets stored in Named Credentials or External Credentials