Skip to content

forcedotcom/sf-skills / plugins/builder/integration/skills/integration-connectivity-generate

integration-connectivity-generate

Verified

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).

FileKindSize
README.mdmarkdown3.5 KB
SKILL.mdskill md8.8 KB
assets/callouts/callout-retry-handler.clsother6.0 KB
assets/callouts/http-response-handler.clsother8.5 KB
assets/callouts/rest-queueable-callout.clsother8.8 KB
assets/callouts/rest-sync-callout.clsother7.4 KB
assets/cdc/cdc-handler.clsother8.4 KB
assets/cdc/cdc-subscriber-trigger.triggerother5.3 KB
assets/endpoint-security/example.cspTrustedSite-meta.xmlconfig1.8 KB
assets/endpoint-security/example.remoteSite-meta.xmlconfig1.3 KB
assets/external-credentials/jwt-external-credential.externalCredential-meta.xmlconfig3.2 KB
assets/external-credentials/oauth-external-credential.externalCredential-meta.xmlconfig3.0 KB
assets/external-services/external-service-operations.mdmarkdown5.5 KB
assets/external-services/openapi-registration.externalServiceRegistration-meta.xmlconfig4.8 KB
assets/named-credentials/certificate-auth.namedCredential-meta.xmlconfig2.2 KB
assets/named-credentials/custom-auth.namedCredential-meta.xmlconfig2.2 KB
assets/named-credentials/oauth-client-credentials.namedCredential-meta.xmlconfig1.8 KB
assets/named-credentials/oauth-jwt-bearer.namedCredential-meta.xmlconfig2.2 KB
assets/platform-events/event-publisher.clsother6.4 KB
assets/platform-events/event-subscriber-action.clsother9.5 KB
assets/platform-events/event-subscriber-trigger.triggerother3.9 KB
assets/platform-events/platform-event-definition.object-meta.xmlconfig3.7 KB
assets/soap/soap-callout-service.clsother6.4 KB
assets/soap/wsdl2apex-guide.mdmarkdown6.2 KB
references/callout-patterns.mdmarkdown21.8 KB
references/cdc-guide.mdmarkdown8.2 KB
references/cli-reference.mdmarkdown2.9 KB
references/event-driven-architecture-guide.mdmarkdown10.1 KB
references/event-patterns.mdmarkdown27.2 KB
references/external-services-guide.mdmarkdown8.4 KB
references/messaging-api-v2.mdmarkdown17.9 KB
references/named-credentials-automation.mdmarkdown6.2 KB
references/named-credentials-guide.mdmarkdown7.1 KB
references/platform-events-guide.mdmarkdown6.6 KB
references/rest-callout-patterns.mdmarkdown8.8 KB
references/scoring-rubric.mdmarkdown2.4 KB
references/security-best-practices.mdmarkdown5.9 KB
scripts/README.mdmarkdown2.9 KB
scripts/configure-named-credential.shexecutablescript9.2 KB
scripts/set-api-credential.shexecutablescript4.9 KB
scripts/suggest_credential_setup.pyscript9.3 KB
scripts/templates/setup-credentials-with-csp.shexecutablescript5.9 KB
scripts/validate_integration.pyscript13.4 KB
# integration-connectivity-generate

Creates comprehensive Salesforce integrations with 120-point scoring. Build secure Named Credentials, External Services, REST/SOAP callouts, Platform Events, and Change Data Capture patterns.

## Features

- **Named Credentials**: OAuth 2.0, JWT Bearer, Certificate, API Key authentication patterns
- **External Credentials**: Modern API 61+ credential architecture with Named Principals
- **External Services**: Auto-generate Apex from OpenAPI/Swagger specs
- **Callout Patterns**: Synchronous and asynchronous REST/SOAP implementations
- **Event-Driven**: Platform Events and Change Data Capture subscribers
- **120-Point Scoring**: Automated validation across 6 categories
- **Automation Scripts**: Configure credentials without UI (ConnectApi)


## Quick Start

### 1. Invoke the skill

```text
Skill: integration-connectivity-generate
Request: "Create a Named Credential for Stripe API with OAuth"
```

### 2. Answer requirements questions

The skill will ask about:
- Integration type (REST, SOAP, Event-driven)
- Authentication method (OAuth, JWT, Certificate, API Key)
- External system details (URL, rate limits)
- Sync vs Async requirements

### 3. Deploy and configure

```bash
# Deploy credential metadata
sf project deploy start --metadata NamedCredential:StripeAPI --target-org MyOrg

# Run automation script to set API key
./scripts/configure-named-credential.sh MyOrg
```

## Scoring System (120 Points)

| Category | Points | Focus |
|----------|--------|-------|
| Security | 30 | Named Credentials, no hardcoded secrets, OAuth scopes |
| Error Handling | 25 | Retry logic, timeouts, specific exceptions |
| Bulkification | 20 | Batch callouts, event batching |
| Architecture | 20 | Async patterns, service separation |
| Best Practices | 15 | Governor limits, idempotency |
| Documentation | 10 | Clear intent, API versioning |

**Thresholds**: ⭐⭐⭐⭐⭐ 90+ | ⭐⭐⭐⭐ 80-89 | ⭐⭐⭐ 70-79 | Block: <45%

## Helper Scripts

Automate credential configuration without manual UI steps:

| Script | Purpose |
|--------|---------|
| `configure-named-credential.sh` | Set API keys via ConnectApi (Enhanced NC) |
| `set-api-credential.sh` | Store keys in Custom Settings (dev/test) |

**Auto-run**: When you create credential files, Claude suggests running these scripts.

```bash
# After deploying Named Credential metadata
./scripts/configure-named-credential.sh MyOrg
# Enter API key when prompted (secure, hidden input)
```

## Prerequisites

- **Salesforce CLI v2+**: `sf` command
- **Authenticated org**: `sf org login web -a <alias>`
- **API Version**: 62.0+ recommended for External Credentials

## Cross-Skill Integration

| Skill | Integration |
|-------|-------------|
| integration-connectivity-connected-app-configure | Create OAuth Connected App for Named Credential |
| platform-apex-generate | Custom callout services beyond templates |
| automation-flow-generate | HTTP Callout Flow for Agentforce |
| platform-metadata-deploy | Deploy credentials and callout code |
| agentforce-generate | Agent actions using External Services |

## Documentation

- [SKILL.md](SKILL.md) - Complete skill reference
- [references/named-credentials-automation.md](references/named-credentials-automation.md) - Script automation guide
- [references/named-credentials-guide.md](references/named-credentials-guide.md) - Template reference
- [references/callout-patterns.md](references/callout-patterns.md) - REST/SOAP patterns
- [references/event-patterns.md](references/event-patterns.md) - Platform Events & CDC
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall