Skip to content

forcedotcom/sf-skills / skills/external-diagram-mermaid-generate

external-diagram-mermaid-generate

Unverified

Salesforce architecture diagrams using Mermaid with ASCII fallback. Use this skill when generating text-based diagrams for Salesforce architecture, OAuth flows, ERDs, integration sequences, or Agentforce structure. TRIGGER when: user says "diagram", "visualize", "ERD", or asks for sequence diagrams, flowcharts, class diagrams, or architecture visualizations in Mermaid. DO NOT TRIGGER when: user asks about non-Salesforce systems.

FileKindSize
README.mdmarkdown4.1 KB
SKILL.mdskill md10.7 KB
assets/agentforce/agent-flow.mdmarkdown15.6 KB
assets/architecture/system-landscape.mdmarkdown17.8 KB
assets/datamodel/b2b-commerce-erd.mdmarkdown11.8 KB
assets/datamodel/campaigns-erd.mdmarkdown8.4 KB
assets/datamodel/consent-erd.mdmarkdown10.2 KB
assets/datamodel/files-erd.mdmarkdown9.2 KB
assets/datamodel/forecasting-erd.mdmarkdown9.3 KB
assets/datamodel/fsl-erd.mdmarkdown11.7 KB
assets/datamodel/party-model-erd.mdmarkdown9.1 KB
assets/datamodel/quote-order-erd.mdmarkdown9.9 KB
assets/datamodel/revenue-cloud-erd.mdmarkdown12.8 KB
assets/datamodel/sales-cloud-erd.mdmarkdown7.4 KB
assets/datamodel/salesforce-erd.mdmarkdown6.8 KB
assets/datamodel/scheduler-erd.mdmarkdown10.7 KB
assets/datamodel/service-cloud-erd.mdmarkdown8.1 KB
assets/datamodel/territory-management-erd.mdmarkdown10.0 KB
assets/integration/api-sequence.mdmarkdown12.7 KB
assets/oauth/authorization-code-pkce.mdmarkdown8.5 KB
assets/oauth/authorization-code.mdmarkdown6.8 KB
assets/oauth/client-credentials.mdmarkdown7.6 KB
assets/oauth/device-authorization.mdmarkdown10.5 KB
assets/oauth/jwt-bearer.mdmarkdown8.2 KB
assets/oauth/refresh-token.mdmarkdown9.5 KB
assets/oauth/user-agent-social-sign-on.mdmarkdown13.7 KB
assets/role-hierarchy/user-hierarchy.mdmarkdown13.3 KB
references/color-palette.mdmarkdown19.5 KB
references/diagram-conventions.mdmarkdown8.1 KB
references/erd-conventions.mdmarkdown8.9 KB
references/mermaid-reference.mdmarkdown8.1 KB
references/mermaid-styling.mdmarkdown2.8 KB
references/preview-guide.mdmarkdown1.2 KB
references/usage-examples.mdmarkdown11.1 KB
scripts/README.mdmarkdown6.3 KB
scripts/mermaid_preview.pyexecutablescript20.1 KB
scripts/query-org-metadata.pyexecutablescript8.5 KB

assets/oauth/device-authorization.md

View on GitHub
# Device Authorization Flow Template

OAuth 2.0 Device Authorization Grant for input-constrained devices without browsers.

## When to Use
- CLI tools (like Salesforce CLI)
- Smart TVs and streaming devices
- IoT devices
- Gaming consoles
- Any device without a browser or limited input capability

## Mermaid Template

```mermaid
%%{init: {'theme': 'base', 'themeVariables': {
  'actorBkg': '#ddd6fe',
  'actorTextColor': '#1f2937',
  'actorBorder': '#6d28d9',
  'signalColor': '#334155',
  'signalTextColor': '#1f2937',
  'noteBkgColor': '#f8fafc',
  'noteTextColor': '#1f2937',
  'noteBorderColor': '#334155'
}}}%%
sequenceDiagram
    autonumber

    box rgba(165,243,252,0.3) USER
        participant U as πŸ‘€ User
        participant B as 🌐 Browser<br/>(on phone/computer)
    end

    box rgba(221,214,254,0.3) DEVICE
        participant D as πŸ“Ί Device<br/>(CLI, TV, IoT)
    end

    box rgba(167,243,208,0.3) SALESFORCE
        participant SF as ☁️ Salesforce<br/>Authorization Server
    end

    Note over D,SF: Device Authorization Flow (RFC 8628)

    U->>D: 1. Initiate Login

    D->>SF: 2. POST /services/oauth2/device/code
    Note over D,SF: client_id=CONSUMER_KEY<br/>scope=api refresh_token

    SF->>SF: 3. Generate Device & User Codes
    Note over SF: device_code = long random string<br/>user_code = short readable code

    SF->>D: 4. Return Codes
    Note over SF,D: {<br/>  device_code: "...",<br/>  user_code: "ABCD-1234",<br/>  verification_uri: "https://login...",<br/>  verification_uri_complete: "...",<br/>  expires_in: 600,<br/>  interval: 5<br/>}

    D->>U: 5. Display Instructions
    Note over D,U: "Visit: https://login.salesforce.com/..."<br/>"Enter code: ABCD-1234"

    U->>B: 6. Open Browser

    B->>SF: 7. Navigate to verification_uri

    SF->>B: 8. Display Code Entry Page
    U->>SF: 9. Enter user_code: ABCD-1234

    SF->>B: 10. Display Login Page
    U->>SF: 11. Enter Username & Password

    SF->>SF: 12. Authenticate User

    SF->>B: 13. Display Consent Screen
    U->>SF: 14. Grant Consent (Allow)

    SF->>B: 15. Display Success Message
    Note over SF,B: "You may close this window"

    loop Poll Every 5 Seconds
        D->>SF: 16. POST /services/oauth2/token
        Note over D,SF: grant_type=device<br/>client_id=CONSUMER_KEY<br/>code=DEVICE_CODE

        alt Authorization Pending
            SF->>D: authorization_pending
            Note over SF,D: User hasn't authorized yet
        else Slow Down
            SF->>D: slow_down
            Note over SF,D: Polling too fast, increase interval
        else Authorized
            SF->>D: 17. Return Tokens
        end
    end

    Note over SF,D: {<br/>  access_token: "...",<br/>  refresh_token: "...",<br/>  instance_url: "https://...",<br/>  token_type: "Bearer"<br/>}

    D->>U: 18. βœ… Successfully Logged In
```

## ASCII Fallback Template

```text
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  User    β”‚  β”‚  Browser  β”‚  β”‚   Device   β”‚  β”‚   Salesforce   β”‚
β”‚          β”‚  β”‚(phone/PC) β”‚  β”‚ (CLI/TV)   β”‚  β”‚  (Auth Server) β”‚
β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”˜
     β”‚              β”‚               β”‚                β”‚
     β”‚              β”‚  1. Start     β”‚                β”‚
     β”‚              β”‚     Login     β”‚                β”‚
     │──────────────────────────────>                β”‚
     β”‚              β”‚               β”‚                β”‚
     β”‚              β”‚               β”‚  2. Request    β”‚
     β”‚              β”‚               β”‚     device codeβ”‚
     β”‚              β”‚               │───────────────>β”‚
     β”‚              β”‚               β”‚                β”‚
     β”‚              β”‚               β”‚  3. device_codeβ”‚
     β”‚              β”‚               β”‚     user_code  β”‚
     β”‚              β”‚               β”‚     ABCD-1234  β”‚
     β”‚              β”‚               β”‚<───────────────│
     β”‚              β”‚               β”‚                β”‚
     β”‚     4. "Visit URL and enter: ABCD-1234"      β”‚
     β”‚<──────────────────────────────                β”‚
     β”‚              β”‚               β”‚                β”‚
     β”‚  5. Open browser             β”‚                β”‚
     │─────────────>β”‚               β”‚                β”‚
     β”‚              β”‚               β”‚                β”‚
     β”‚              β”‚  6. Visit verification URL     β”‚
     β”‚              │──────────────────────────────>β”‚
     β”‚              β”‚               β”‚                β”‚
     β”‚              β”‚  7. Enter code page           β”‚
     β”‚              β”‚<──────────────────────────────│
     β”‚              β”‚               β”‚                β”‚
     β”‚  8. Enter ABCD-1234          β”‚                β”‚
     │─────────────>│──────────────────────────────>β”‚
     β”‚              β”‚               β”‚                β”‚
     β”‚  9. Login + Consent          β”‚                β”‚
     │─────────────────────────────────────────────>β”‚
     β”‚              β”‚               β”‚                β”‚
     β”‚              β”‚               β”‚  10. Poll for  β”‚
     β”‚              β”‚               β”‚      token     β”‚
     β”‚              β”‚               β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€>β”‚
     β”‚              β”‚               β”‚  β”‚            β”‚
     β”‚              β”‚               β”‚  β”‚ (repeat)   β”‚
     β”‚              β”‚               β”‚  β”‚            β”‚
     β”‚              β”‚               β”‚  11. Tokens!  β”‚
     β”‚              β”‚               β”‚<─┴────────────│
     β”‚              β”‚               β”‚                β”‚
     β”‚ 12. Logged In βœ…             β”‚                β”‚
     β”‚<──────────────────────────────                β”‚
```

## Step 1: Request Device Code

```bash
curl -X POST https://login.salesforce.com/services/oauth2/device/code \
  -d "client_id=YOUR_CONSUMER_KEY" \
  -d "scope=api refresh_token"
```

### Response
```json
{
  "device_code": "aDEvhqZjZ2FwcAA6y...",
  "user_code": "ABCD-1234",
  "verification_uri": "https://login.salesforce.com/setup/connect",
  "verification_uri_complete": "https://login.salesforce.com/setup/connect?user_code=ABCD-1234",
  "expires_in": 600,
  "interval": 5
}
```

## Step 2: Display to User

```text
═══════════════════════════════════════════════════════════════
  To authorize this device, please:

  1. Visit: https://login.salesforce.com/setup/connect
  2. Enter code: ABCD-1234

  Waiting for authorization...
═══════════════════════════════════════════════════════════════
```

## Step 3: Poll for Token

```bash
curl -X POST https://login.salesforce.com/services/oauth2/token \
  -d "grant_type=device" \
  -d "client_id=YOUR_CONSUMER_KEY" \
  -d "code=DEVICE_CODE"
```

### Possible Responses

**Authorization Pending:**
```json
{
  "error": "authorization_pending",
  "error_description": "User has not yet authorized"
}
```

**Slow Down (polling too fast):**
```json
{
  "error": "slow_down",
  "error_description": "Polling too fast"
}
```

**Success:**
```json
{
  "access_token": "00D5g000001ABC...!ARcAQNlBrLGj...",
  "refresh_token": "5Aep8617...",
  "instance_url": "https://mycompany.my.salesforce.com",
  "token_type": "Bearer",
  "issued_at": "1702123456789"
}
```

## Code Example (CLI Tool)

```python
import requests
import time

CLIENT_ID = 'YOUR_CONSUMER_KEY'

# Step 1: Request device code
device_response = requests.post(
    'https://login.salesforce.com/services/oauth2/device/code',
    data={'client_id': CLIENT_ID, 'scope': 'api refresh_token'}
).json()

device_code = device_response['device_code']
user_code = device_response['user_code']
verification_uri = device_response['verification_uri']
interval = device_response['interval']

# Step 2: Display to user
print(f"\nVisit: {verification_uri}")
print(f"Enter code: {user_code}\n")

# Step 3: Poll for token
while True:
    time.sleep(interval)

    token_response = requests.post(
        'https://login.salesforce.com/services/oauth2/token',
        data={
            'grant_type': 'device',
            'client_id': CLIENT_ID,
            'code': device_code
        }
    ).json()

    if 'access_token' in token_response:
        print("βœ… Authorization successful!")
        break
    elif token_response.get('error') == 'slow_down':
        interval += 5  # Increase polling interval
    elif token_response.get('error') != 'authorization_pending':
        print(f"Error: {token_response.get('error_description')}")
        break

access_token = token_response['access_token']
```

## Key Characteristics

| Aspect | Value |
|--------|-------|
| User Interaction | On separate device |
| Polling Required | Yes (every N seconds) |
| Refresh Token | Yes, returned |
| Best For | CLI tools, IoT, TVs |
| User Code Format | Short, human-readable |

## Timing Parameters

| Parameter | Value | Purpose |
|-----------|-------|---------|
| `expires_in` | 600 (10 min) | How long codes are valid |
| `interval` | 5 (seconds) | Minimum time between polls |

## Security Considerations

1. **Display user code clearly** - Use large font, easy to read
2. **Honor interval** - Don't poll faster than specified
3. **Handle expiration** - Codes expire after `expires_in` seconds
4. **Secure token storage** - Store tokens securely on device

## Customization Points

Replace these placeholders:
- `CONSUMER_KEY` β†’ Your Connected App's Consumer Key
- `DEVICE_CODE` β†’ Device code from initial response
- `login.salesforce.com` β†’ Or `test.salesforce.com` for sandbox
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