{"id":"edbaa493-a657-4d8b-a14c-aeb2ad5ee6fa","shortId":"vdvQ4p","kind":"skill","title":"forge-connector","tagline":"Guides building and deploying Atlassian Forge Teamwork Graph connector apps that ingest external data into Atlassian's Teamwork Graph, making it searchable in Rovo Search and surfaced in Rovo Chat. Use when the user wants to build a Forge connector, ingest external data into Atla","description":"# Forge Connector\n\nBuilds a `graph:connector` Forge app that ingests external data into Atlassian's Teamwork Graph so it appears in **Rovo Search** and **Rovo Chat**.\n\n## Critical Rules\n\n1. **Must install in Jira** — Apps using Teamwork Graph modules must be installed on a Jira site. Confluence-only installs will not work.\n2. **Never ask for credentials in chat** — Direct users to run `forge login` in their own terminal.\n3. **Always run the scaffold script yourself** — Do not only give manual instructions; run `scripts/scaffold_connector.py` to generate the boilerplate.\n4. **Always ask the user for their Atlassian site URL** when install is needed — never discover or guess it.\n5. **Atlassian deletes data on disconnect** — When `action = 'DELETED'`, the app only needs to clean up local state; Atlassian removes the Teamwork Graph data automatically.\n6. **Handler arguments are passed directly** — Forge passes the request object as the first argument to handlers, NOT nested under `event.payload`. Config values are at `request.configProperties`, NOT `event.payload.config`. This is the most common source of `TypeError: Cannot destructure property of undefined` errors.\n7. **Use `@forge/kvs` for storage** — Import `kvs` from `@forge/kvs`. Do NOT use `@forge/storage` — its `storage` export is `undefined` at runtime in connector functions.\n8. **Use `graph` named export from `@forge/teamwork-graph`** — The correct import is `const { graph } = require('@forge/teamwork-graph')`. Call `graph.setObjects({ objects, connectionId })`. Do NOT import `setObjects` as a named export directly.\n9. **`validateConnectionHandler` must return `{ success, message }`** — Do NOT throw an Error. Return `{ success: false, message: '...' }` to reject, `{ success: true }` to accept.\n10. **`function` declarations belong under `modules`** — In `manifest.yml`, `function:` is a key under `modules:`, not a top-level key. Placing it at the top level causes a lint error.\n11. **`formConfiguration` uses `form` array with `type: header`** — Do NOT use `fields:` or `beforeYouBegin:`. The correct format uses `form: [{ key, type: header, title, description, properties: [...] }]`.\n12. **Scopes are `read/write/delete:object:jira`** — Use `read:object:jira`, `write:object:jira`, `delete:object:jira`. The scopes `read:graph:teamwork` and `write:graph:teamwork` are invalid and will fail `forge lint`.\n\n## MCP Prerequisites\n\n\n| MCP Server    | Purpose                                           |\n| ------------- | ------------------------------------------------- |\n| **Forge MCP** | Manifest syntax, module config, deployment guides |\n| **ADS MCP**   | Atlaskit components (only if adding Custom UI)    |\n\n\n---\n\n## Agent Workflow — Complete Steps 0–5 in Order\n\n### Step 0: Prerequisites\n\nCheck Node.js (`node -v`, requires 22+), Forge CLI (`forge --version`), and login (`forge whoami`). Install missing tools:\n\n```bash\nnpm install -g @forge/cli\n```\n\nTell the user to run `forge login` in their terminal if not authenticated.\n\n### Step 1: Discover Developer Spaces\n\n> **Note:** `forge developer-spaces list` does NOT exist in Forge CLI 12.x. You cannot list developer spaces non-interactively.\n\n`forge create` requires an interactive TTY to select a developer space. Ask the user to run it themselves:\n\n```\nTell the user:\n  cd <parent-directory>\n  forge create --template blank <app-name>\n\n  When prompted, select a Developer Space and let it complete.\n  Come back when done.\n```\n\nThe `--dev-space-id` flag in the scaffold script is optional and can be omitted — the script has been updated to skip it when not provided.\n\n### Step 2: Scaffold the Connector App\n\nRun from the **skill directory** (the directory containing this SKILL.md). `--dev-space-id` is optional:\n\n```bash\npython3 -m scripts.scaffold_connector \\\n  --name <app-name> \\\n  --connector-name \"<Human Readable Name>\" \\\n  --object-type atlassian:document \\\n  --directory <parent-directory>\n```\n\nAdd `--dev-space-id <id>` only if you have the ID from a previous step.\n\n**Object type selection** — pick the type that best matches the content being ingested (see Object Types table). For mixed content, use `atlassian:document` as the default.\n\n**Form config flag** — add `--has-form-config` if the admin must provide API credentials or connection details (typical for external systems). Omit it for apps that operate entirely within Atlassian (no external credentials needed).\n\n> **If scaffold fails because `forge create` needs a TTY:** The scaffold script will print a manual fallback command. Have the user run `forge create` interactively, then continue from Step 3 — the scaffold script only needs to write `manifest.yml` and `src/index.js` after the directory exists.\n\n### Step 3: Customize the Generated Code\n\nAfter scaffolding (or after the user runs `forge create` interactively):\n\n```bash\ncd <app-name>\nnpm install\n```\n\nThe blank template generates `src/index.js` (JavaScript, not TypeScript). Edit it to add your API calls. The scaffold generates working handler skeletons; fill in your business logic.\n\n#### Key files to edit\n\n| File           | What to change                                                          |\n| -------------- | ----------------------------------------------------------------------- |\n| `src/index.js` | `fetchExternalData()` — replace with your API calls                     |\n| `manifest.yml` | Add `permissions.external.fetch.backend` URLs for any external APIs     |\n| `package.json` | Add `@forge/api`, `@forge/kvs`, `@forge/teamwork-graph` as dependencies |\n\n\n#### setObjects — ingest data into Teamwork Graph\n\nUse the `graph` named export — do NOT destructure `setObjects` directly:\n\n```javascript\nconst { graph } = require('@forge/teamwork-graph');\n\nconst result = await graph.setObjects({\n  connectionId,          // required — the connectionId from the handler request\n  objects: [\n    {\n      schemaVersion: '1.0',\n      id: 'unique-id-from-source',      // unique per connectionId\n      updateSequenceNumber: 1,\n      displayName: 'My Document Title',\n      url: 'https://source-system.example.com/doc/123',\n      createdAt: '2024-01-15T10:00:00Z',        // ISO 8601\n      lastUpdatedAt: '2024-01-20T14:30:00Z',\n      permissions: [{\n        accessControls: [{\n          principals: [{ type: 'EVERYONE' }],   // or restrict to specific users\n        }],\n      }],\n      'atlassian:document': {\n        type: {\n          category: 'DOCUMENT',   // see Document Categories table below\n          mimeType: 'application/vnd.google-apps.document',\n        },\n        content: {\n          mimeType: 'application/vnd.google-apps.document',\n          text: 'document title or snippet for search indexing',\n        },\n      },\n    },\n  ],\n});\n\nif (!result.success) {\n  console.error('setObjects error:', result.error);\n}\n```\n\n- Max **100 objects per call** — batch large datasets with a loop\n- `id` must be unique per `connectionId`\n- `connectionId` is required in every `graph.setObjects()` call\n\n#### Document Categories (for `atlassian:document.type.category`)\n\n| MIME type | Category |\n|---|---|\n| `application/vnd.google-apps.document` | `DOCUMENT` |\n| `application/vnd.google-apps.spreadsheet` | `SPREADSHEET` |\n| `application/vnd.google-apps.presentation` | `PRESENTATION` |\n| `application/vnd.google-apps.folder` | `FOLDER` |\n| `application/pdf` | `PDF` |\n| `image/*` | `IMAGE` |\n| `video/*` | `VIDEO` |\n| `audio/*` | `AUDIO` |\n| Other | `OTHER` |\n\n#### getObjectByExternalId — look up a single object\n\n```javascript\nconst { graph } = require('@forge/teamwork-graph');\n\nconst data = await graph.getObjectByExternalId({\n  externalId: 'unique-id-from-source',\n  objectType: 'atlassian:document',\n  connectionId,\n});\nif (data.success) console.log(data.object);\n```\n\n### Step 4: Deploy and Install\n\n**You MUST run the deploy script** — do not only give the user manual `forge deploy` commands.\n\nThe deploy script lives in the **forge-app-builder** skill, not in this skill. Derive its directory from the path of this SKILL.md: go up two levels (`skills/forge-connector/` → `skills/`) then into `forge-app-builder/`. Run all commands below from that directory.\n\n```bash\n# Derive forge-app-builder skill dir from this SKILL.md's path:\n# e.g. if this file is at /path/to/skills/forge-connector/SKILL.md\n# then the deploy script dir is: /path/to/skills/forge-app-builder/\n\n# If you have the site URL:\npython3 -m scripts.deploy_forge_app \\\n  --app-dir <app-directory> \\\n  --site <site-url> \\\n  --product jira\n\n# If you don't have the site URL yet, deploy first then ask:\npython3 -m scripts.deploy_forge_app \\\n  --app-dir <app-directory> \\\n  --product jira \\\n  --deploy-only\n# Ask: \"What is your Atlassian site URL (e.g. yourcompany.atlassian.net)?\"\npython3 -m scripts.deploy_forge_app \\\n  --app-dir <app-directory> \\\n  --site <site-url> \\\n  --product jira \\\n  --skip-deps\n```\n\n### Step 5: Connect via Atlassian Administration\n\nAfter deployment, tell the user to:\n\n1. Go to **Atlassian Administration** → **Apps** → **[site]** → **Connected apps**\n2. Find the app → **View app details** → **Connections** tab\n3. Click **Connect** under the connector\n4. Fill in any configuration fields (if `formConfiguration` was defined)\n5. Click **Connect** — this triggers `onConnectionChange` with `action: CREATED` and starts data ingestion\n\n### Step 6: Monitor with forge tunnel\n\nUse `forge tunnel` during development to stream live logs directly to your terminal as the connector functions execute. This is the fastest way to catch errors in `onConnectionChangeHandler`, `validateConnectionHandler`, and `setObjects` calls without waiting for `forge logs`.\n\nTell the user to run this in their own terminal (it requires an interactive session):\n\n```bash\ncd <app-directory>\nforge tunnel\n```\n\nWith the tunnel active, any invocation of the connector functions (e.g. clicking \"Connect\" in Atlassian Admin, or triggering a scheduled re-ingestion) will stream output immediately. Look for:\n\n- `[connector] Fetched N items` — confirms `fetchExternalData()` ran\n- `[connector] Batch 1: N accepted, 0 rejected` — confirms `setObjects` succeeded\n- Any uncaught errors or thrown exceptions from `validateConnectionHandler`\n\nIf the tunnel is not running, use `forge logs` instead to inspect past invocations:\n\n```bash\n# Most recent 50 log lines from development environment\nforge logs -e development --limit 50\n\n# Production logs for a specific site\nforge logs -e production --site <your-site> --limit 50\n```\n\n**Tunnel vs logs — when to use which:**\n\n| Situation | Use |\n|---|---|\n| Actively developing / testing the connection flow | `forge tunnel` — live streaming |\n| Debugging a past invocation or production issue | `forge logs` |\n| Connector function timed out before tunnel caught it | `forge logs` with `--limit 100` |\n\n> **Note:** `forge tunnel` must be run by the user in an interactive terminal — do not attempt to run it via the agent.\n\n---\n\n## Manifest Reference\n\n> **Key rules:**\n> - Scopes are `read:object:jira`, `write:object:jira`, `delete:object:jira` — NOT `read:graph:teamwork` / `write:graph:teamwork` (those fail `forge lint`)\n> - `function:` is declared **under `modules:`**, not at the top level\n> - Egress uses `address:` not a bare string (run `forge lint --fix` to auto-correct)\n> - `formConfiguration` uses `form: [{ type: header, properties: [...] }]` — NOT `fields:` or `beforeYouBegin:`\n\n### Minimal connector (no admin config, no OAuth)\n\nUse when the app operates entirely within Atlassian — no external credentials needed.\n\n```yaml\napp:\n  id: <generated-by-forge-create>\n  runtime:\n    name: nodejs24.x\n    memoryMB: 256\n    architecture: arm64\n\npermissions:\n  scopes:\n    - read:object:jira\n    - write:object:jira\n    - delete:object:jira\n    - storage:app\n\nmodules:\n  graph:connector:\n    - key: my-connector\n      name: My Service\n      icons:\n        light: https://cdn.example.com/logo.png\n        dark: https://cdn.example.com/logo.png\n      objectTypes:\n        - atlassian:document\n      datasource:\n        onConnectionChange:\n          function: on-connection-change\n\n  function:\n    - key: on-connection-change\n      handler: index.onConnectionChangeHandler\n```\n\n### Connector with admin form config (API key / URL)\n\nUse when the admin must provide credentials to connect to an external system.\n\n```yaml\napp:\n  id: <generated-by-forge-create>\n  runtime:\n    name: nodejs24.x\n    memoryMB: 256\n    architecture: arm64\n\npermissions:\n  scopes:\n    - read:object:jira\n    - write:object:jira\n    - delete:object:jira\n    - storage:app\n  external:\n    fetch:\n      backend:\n        - address: 'https://api.your-service.com'   # note: address: not a bare string\n\nmodules:\n  graph:connector:\n    - key: my-connector\n      name: My Service\n      icons:\n        light: https://cdn.example.com/logo.png\n        dark: https://cdn.example.com/logo.png\n      objectTypes:\n        - atlassian:document\n      datasource:\n        formConfiguration:\n          form:                          # use form:, NOT fields: or beforeYouBegin:\n            - key: connectionDetails\n              type: header\n              title: Connection Details\n              description: >\n                Provide your My Service API credentials.\n                Find them in My Service → Settings → API.\n              properties:\n                - key: apiKey           # camelCase keys — accessed as request.configProperties.apiKey\n                  label: API Key\n                  type: string\n                  isRequired: true\n                - key: apiUrl\n                  label: API URL\n                  type: string\n                  isRequired: true\n          validateConnection:\n            function: validate-connection\n        onConnectionChange:\n          function: on-connection-change\n\n  function:                              # function: is under modules:, NOT top-level\n    - key: on-connection-change\n      handler: index.onConnectionChangeHandler\n    - key: validate-connection\n      handler: index.validateConnectionHandler\n```\n\n---\n\n## Handler Signatures\n\n> **Critical:** Forge passes the request **directly as the first argument** — it is NOT wrapped under `event.payload`. Config form values are at `request.configProperties`, not `event.payload.config`. Getting this wrong causes `TypeError: Cannot destructure property of undefined`.\n\n### onConnectionChange\n\n```javascript\nconst { kvs } = require('@forge/kvs');\nconst { graph } = require('@forge/teamwork-graph');\n\nexports.onConnectionChangeHandler = async (request) => {\n  // request.action, request.connectionId, request.configProperties\n  const { action, connectionId, configProperties } = request;\n\n  if (action === 'DELETED') {\n    // Atlassian removes Teamwork Graph data automatically on disconnect.\n    // Only clean up locally stored credentials.\n    await kvs.deleteSecret(connectionId);\n    return { success: true };\n  }\n\n  // CREATED or UPDATED — persist credentials and ingest data\n  await kvs.setSecret(connectionId, configProperties);\n  await ingestAllData(connectionId, configProperties);\n  return { success: true };\n};\n```\n\n### validateConnection\n\n```javascript\nconst { fetch } = require('@forge/api');\n\nexports.validateConnectionHandler = async (request) => {\n  // request.configProperties — NOT event.payload.config\n  const { configProperties } = request;\n\n  // Return { success: false, message } to reject — do NOT throw an Error.\n  // Return { success: true } to accept.\n  const response = await fetch(`${configProperties['apiUrl']}/health`);\n  if (!response.ok) {\n    return { success: false, message: 'Invalid API credentials. Please check your settings.' };\n  }\n  return { success: true, message: 'Connection validated successfully.' };\n};\n```\n\n### refreshIngestion (scheduled trigger)\n\n```javascript\nexports.refreshIngestionHandler = async () => {\n  const activeConnections = await kvs.get('active-connections') ?? [];\n  for (const connectionId of activeConnections) {\n    const config = await kvs.getSecret(connectionId);\n    if (config) await ingestAllData(connectionId, config);\n  }\n};\n```\n\n---\n\n## Object Types\n\nObjects in **bold** are indexed in Rovo Search and Rovo Chat.\n\n\n| Object Type                       | Indexed in Rovo | Best for                             |\n| --------------------------------- | --------------- | ------------------------------------ |\n| `atlassian:document`              | ✅               | Files, pages, wiki articles, reports |\n| `atlassian:message`               | ✅               | Chat messages, emails, comments      |\n| `atlassian:work-item`             | ✅               | Tasks, tickets, issues               |\n| `atlassian:project`               | ✅               | Projects, workspaces                 |\n| `atlassian:space`                 | ✅               | Team spaces, org units               |\n| `atlassian:design`                | ✅               | Design files (Figma, etc.)           |\n| `atlassian:repository`            | ✅               | Code repositories                    |\n| `atlassian:pull-request`          | ✅               | PRs, merge requests                  |\n| `atlassian:commit`                | ✅               | Git commits                          |\n| `atlassian:branch`                | ✅               | Git branches                         |\n| `atlassian:conversation`          | ✅               | Threads, channels                    |\n| `atlassian:video`                 | ✅               | Video recordings                     |\n| `atlassian:calendar-event`        | ✅               | Meetings, events                     |\n| `atlassian:comment`               | ✅               | Review comments                      |\n| `atlassian:customer-organization` | ✅               | Customer accounts, orgs              |\n| `atlassian:build`                 | ❌               | CI/CD builds                         |\n| `atlassian:deployment`            | ❌               | Deployments                          |\n| `atlassian:test`                  | ❌               | Test cases                           |\n\n\n---\n\n## Rovo Search / Rovo Chat Surfacing\n\nOnce ingested:\n\n- Objects appear in **Rovo Search** under a subfilter named after the connector's nickname (set by admin at connection time)\n- **Rovo Chat** can reference and cite connector objects in responses when queried about topics related to the ingested content\n- Data is not available immediately — allow a few minutes for indexing after `onConnectionChange` fires\n\nTo verify ingestion is working:\n\n1. Open Rovo Search on the Jira site\n2. Search for text that appears in an ingested object's `name` or `properties`\n3. Filter by the connector nickname to narrow results\n\n---\n\n## Batching Pattern for Large Datasets\n\n```javascript\nconst { graph } = require('@forge/teamwork-graph');\n\nconst BATCH_SIZE = 100;\n\nasync function ingestAllData(connectionId, config) {\n  const items = await fetchExternalData(config);\n\n  for (let i = 0; i < items.length; i += BATCH_SIZE) {\n    const batch = items.slice(i, i + BATCH_SIZE);\n    const result = await graph.setObjects({\n      connectionId,          // required in every call\n      objects: batch.map(item => ({\n        schemaVersion: '1.0',\n        id: item.id,                      // unique per connectionId\n        updateSequenceNumber: 1,\n        displayName: item.title,\n        url: item.url,\n        createdAt: item.createdAt,\n        lastUpdatedAt: item.updatedAt,\n        permissions: [{\n          accessControls: [{ principals: [{ type: 'EVERYONE' }] }],\n        }],\n        'atlassian:document': {\n          type: { category: 'DOCUMENT', mimeType: item.mimeType },\n          content: { mimeType: item.mimeType, text: item.title },\n        },\n      })),\n    });\n    if (!result.success) {\n      console.error(`[connector] setObjects error in batch ${Math.floor(i / BATCH_SIZE) + 1}:`, result.error);\n    }\n  }\n}\n```\n\n---\n\n## Scheduled Re-Ingestion (optional)\n\nTo keep data fresh, add a scheduled trigger that re-runs ingestion periodically:\n\n```yaml\n# In manifest.yml — under modules:\nscheduledTrigger:\n  - key: refresh-trigger\n    function: refresh-ingestion\n    interval: day   # prefer 'day' or 'hour'; avoid 'fiveMinutes'\n\n# Under function:\n  - key: refresh-ingestion\n    handler: index.refreshIngestionHandler\n```\n\n```javascript\nconst { kvs } = require('@forge/kvs');\n\n// Track active connections in onConnectionChangeHandler:\n//   await kvs.set('active-connections', [...activeConnections, connectionId]);\n//   await kvs.setSecret(connectionId, configProperties);  // store credentials securely\n\nexports.refreshIngestionHandler = async () => {\n  const activeConnections = await kvs.get('active-connections') ?? [];\n  for (const connectionId of activeConnections) {\n    const config = await kvs.getSecret(connectionId);  // retrieve stored credentials\n    if (config) await ingestAllData(connectionId, config);\n  }\n};\n```\n\n---\n\n## Scripts\n\n\n| Script                          | Skill directory                                   | Purpose                                                                                                                         |\n| ------------------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |\n| `scripts/scaffold_connector.py` | `skills/forge-connector/` (this skill)            | Scaffold a new connector app — generates manifest.yml, src/index.ts, installs SDK. Run: `python3 -m scripts.scaffold_connector` |\n| `scripts/deploy_forge_app.py`   | `skills/forge-app-builder/` (**different skill**) | Deploy and install on Jira. Run from the forge-app-builder directory: `python3 -m scripts.deploy_forge_app`                     |\n\n\nThe scaffold script is in this skill's directory. The deploy script is in the **forge-app-builder** skill directory — always `cd` there (or derive the path from this SKILL.md's location) before running it.\n\n---\n\n## Troubleshooting\n\n| Problem | Action |\n| --- | --- |\n| `graph:connector` not recognized in manifest | Run `forge lint` — it will identify the exact field causing the error |\n| `TypeError: Cannot destructure property 'config' of 'event.payload'` | Handler using `event.payload.config` — change to `request.configProperties`. Forge passes request directly, not nested under `event.payload` |\n| `TypeError: Cannot read properties of undefined (reading 'set')` | Using `storage` from `@forge/storage` — switch to `kvs` from `@forge/kvs` |\n| `graph.setObjects is not a function` | Wrong import — use `const { graph } = require('@forge/teamwork-graph')` then call `graph.setObjects({ objects, connectionId })` |\n| `forge lint`: invalid scopes `read/write:graph:teamwork` | Replace with `read:object:jira`, `write:object:jira`, `delete:object:jira` |\n| `forge lint`: `document should NOT have additional property 'function'` | `function:` is at the top level — move it inside `modules:` |\n| `forge lint`: `formConfiguration must have required property 'form'` | Replace `fields:` / `beforeYouBegin:` with `form: [{ type: header, properties: [...] }]` |\n| `forge lint` warning: deprecated egress entries | Run `forge lint --fix` to auto-convert bare URL strings to `{ address: 'url' }` |\n| `forge developer-spaces list` command not found | Does not exist in Forge CLI 12.x. Have user run `forge create` interactively to select a developer space |\n| `forge create` fails with non-TTY error | `forge create` needs an interactive terminal — ask the user to run it; then write manifest and source files into the created directory |\n| `onConnectionChange` not triggered | Verify admin clicked \"Connect\" in Atlassian Administration → Connected apps; run `forge tunnel` to confirm the function fires |\n| Objects not appearing in Rovo Search | Wait ~5 minutes for indexing; run `forge logs -e development --since 15m` to check for `setObjects` errors |\n| 403 on `@forge/teamwork-graph` calls | Ensure `read:object:jira`, `write:object:jira`, `delete:object:jira` are in manifest scopes, then redeploy and `forge install --upgrade` |\n| `forge login` required | Create API token at https://id.atlassian.com/manage/api-tokens, then run `forge login` |\n\n---\n\n---\n\n## Naming and Logo Guidelines\n\n- Use the **official service name** as the connector name (e.g. `Google Drive`, not `Drive Connector by Acme`)\n- Use the **official service logo** for icons — do not modify or combine with your own branding\n- These guidelines apply only to the `graph:connector` module; your Forge app itself may use your own branding","tags":["forge","connector","skills","atlassian","agent-skills","ai-agents","claude-code-plugin","claude-code-skills","gemini-cli-extension","mcp"],"capabilities":["skill","source-atlassian","skill-forge-connector","topic-agent-skills","topic-ai-agents","topic-claude-code-plugin","topic-claude-code-skills","topic-gemini-cli-extension","topic-mcp"],"categories":["forge-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/atlassian/forge-skills/forge-connector","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add atlassian/forge-skills","source_repo":"https://github.com/atlassian/forge-skills","install_from":"skills.sh"}},"qualityScore":"0.454","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 8 github stars · SKILL.md body (24,589 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:08:52.849Z","embedding":null,"createdAt":"2026-05-18T13:14:33.759Z","updatedAt":"2026-05-18T19:08:52.849Z","lastSeenAt":"2026-05-18T19:08:52.849Z","tsv":"'-01':834,843 '-15':835 '-20':844 '/doc/123'',':831 '/health':1843 '/logo.png':1520,1524,1612,1616 '/manage/api-tokens,':2665 '/path/to/skills/forge-app-builder':1056 '/path/to/skills/forge-connector/skill.md':1049 '0':408,413,1285,2127 '00':837 '00z':838,847 '1':77,451,823,1135,1282,2069,2160,2198 '1.0':812,2153 '10':295 '100':888,1380,2113 '11':325 '12':350,467,2546 '15m':2626 '2':101,545,1144,2077 '2024':833,842 '22':420 '256':1490,1571 '3':118,686,702,1153,2091 '30':846 '4':137,967,1159 '403':2632 '5':156,409,1124,1169,2616 '50':1315,1326,1339 '6':181,1183 '7':223 '8':246 '8601':840 '9':274 'accept':294,1284,1836 'access':1655 'accesscontrol':849,2170 'account':1991 'acm':2690 'action':163,1176,1760,1765,2385 'activ':1247,1349,1875,2255,2262,2280 'active-connect':1874,2261,2279 'activeconnect':1871,1881,2264,2276,2286 'ad':395,401 'add':581,625,732,763,771,2209 'addit':2483 'address':1441,1590,1593,2530 'admin':632,1259,1467,1545,1554,2027,2593 'administr':1128,1139,2598 'agent':404,1402 'allow':2055 'alway':119,138,2368 'api':635,734,760,769,1548,1641,1649,1659,1668,1851,2660 'api.your-service.com':1591 'apikey':1652 'apiurl':1666,1842 'app':13,56,82,166,549,647,995,1021,1034,1067,1069,1091,1093,1113,1115,1140,1143,1147,1149,1474,1484,1505,1565,1586,2314,2339,2346,2364,2600,2718 'app-dir':1068,1092,1114 'appear':68,2012,2082,2611 'appli':2709 'application/pdf':927 'application/vnd.google-apps.document':869,872,919 'application/vnd.google-apps.folder':925 'application/vnd.google-apps.presentation':923 'application/vnd.google-apps.spreadsheet':921 'architectur':1491,1572 'argument':183,195,1718 'arm64':1492,1573 'array':329 'articl':1918 'ask':103,139,488,1086,1100,2573 'async':1754,1813,1869,2114,2274 'atla':48 'atlaskit':397 'atlassian':8,19,62,144,157,174,578,617,652,858,914,959,1104,1127,1138,1258,1478,1526,1618,1767,1913,1920,1926,1933,1937,1943,1949,1953,1960,1964,1968,1972,1976,1982,1986,1993,1997,2000,2174,2597 'attempt':1396 'audio':933,934 'authent':449 'auto':1452,2524 'auto-convert':2523 'auto-correct':1451 'automat':180,1772 'avail':2053 'avoid':2239 'await':800,950,1781,1795,1799,1839,1872,1884,1889,2121,2142,2259,2266,2277,2289,2297 'back':514 'backend':1589 'bare':1444,1596,2526 'bash':432,566,717,1030,1240,1312 'batch':892,1281,2100,2111,2131,2134,2138,2193,2196 'batch.map':2150 'beforeyoubegin':338,1463,1628,2506 'belong':298 'best':603,1911 'blank':502,722 'boilerpl':136 'bold':1897 'branch':1965,1967 'brand':2706,2724 'build':5,40,51,1994,1996 'builder':996,1022,1035,2340,2365 'busi':745 'calendar':1978 'calendar-ev':1977 'call':261,735,761,891,910,1219,2148,2455,2635 'camelcas':1653 'cannot':217,470,1738,2405,2426 'case':2003 'catch':1212 'categori':861,865,912,918,2177 'caught':1374 'caus':321,1736,2401 'cd':498,718,1241,2369 'cdn.example.com':1519,1523,1611,1615 'cdn.example.com/logo.png':1518,1522,1610,1614 'chang':754,1534,1540,1684,1698,2414 'channel':1971 'chat':33,74,107,1905,1922,2007,2032 'check':415,1854,2628 'ci/cd':1995 'cite':2036 'clean':170,1776 'cli':422,466,2545 'click':1154,1170,1255,2594 'code':706,1951 'combin':2702 'come':513 'command':674,986,1025,2537 'comment':1925,1983,1985 'commit':1961,1963 'common':213 'complet':406,512 'compon':398 'config':202,392,623,629,1468,1547,1725,1883,1888,1892,2118,2123,2288,2296,2300,2408 'configproperti':1762,1798,1802,1819,1841,2269 'configur':1163 'confirm':1277,1287,2605 'confluenc':95 'confluence-on':94 'connect':638,1125,1142,1151,1155,1171,1256,1353,1533,1539,1559,1634,1678,1683,1697,1704,1861,1876,2029,2256,2263,2281,2595,2599 'connectiondetail':1630 'connectionid':264,802,805,821,903,904,961,1761,1783,1797,1801,1879,1886,1891,2117,2144,2158,2265,2268,2284,2291,2299,2458 'connector':3,12,43,50,54,244,548,570,573,1158,1203,1252,1273,1280,1368,1465,1508,1512,1543,1600,1604,2022,2037,2095,2189,2313,2324,2387,2681,2688,2714 'connector-nam':572 'console.error':883,2188 'console.log':964 'const':257,794,798,944,948,1745,1749,1759,1808,1818,1837,1870,1878,1882,2106,2110,2119,2133,2140,2250,2275,2283,2287,2450 'contain':557 'content':606,615,870,2049,2181 'continu':683 'convers':1969 'convert':2525 'correct':254,340,1453 'creat':478,500,662,680,715,1177,1787,2552,2560,2568,2587,2659 'createdat':832,2165 'credenti':105,636,655,1481,1557,1642,1780,1791,1852,2271,2294 'critic':75,1709 'custom':402,703,1988,1990 'customer-organ':1987 'dark':1521,1613 'data':17,46,60,159,179,779,949,1180,1771,1794,2050,2207 'data.object':965 'data.success':963 'dataset':894,2104 'datasourc':1528,1620 'day':2234,2236 'debug':1359 'declar':297,1431 'default':621 'defin':1168 'delet':158,164,363,1415,1501,1582,1766,2474,2643 'dep':1122 'depend':776 'deploy':7,393,968,975,985,988,1052,1083,1098,1130,1998,1999,2329,2357 'deploy-on':1097 'deprec':2515 'deriv':1002,1031,2372 'descript':348,1636 'design':1944,1945 'destructur':218,790,1739,2406 'detail':639,1150,1635 'dev':519,561,583 'dev-space-id':518,560,582 'develop':453,458,472,486,507,1192,1319,1324,1350,2534,2557,2624 'developer-spac':457,2533 'differ':2327 'dir':1037,1054,1070,1094,1116 'direct':108,186,273,792,1197,1714,2420 'directori':554,556,580,699,1004,1029,2304,2341,2355,2367,2588 'disconnect':161,1774 'discov':152,452 'displaynam':824,2161 'document':579,618,826,859,862,864,874,911,920,960,1527,1619,1914,2175,2178,2479 'document.type.category':915 'done':516 'drive':2685,2687 'e':1323,1335,2623 'e.g':1043,1107,1254,2683 'edit':729,750 'egress':1439,2516 'email':1924 'ensur':2636 'entir':650,1476 'entri':2517 'environ':1320 'error':222,284,324,885,1213,1292,1831,2191,2403,2566,2631 'etc':1948 'event':1979,1981 'event.payload':201,1724,2410,2424 'event.payload.config':208,1732,1817,2413 'everi':908,2147 'everyon':852,2173 'exact':2399 'except':1295 'execut':1205 'exist':463,700,2542 'export':238,250,272,787 'exports.onconnectionchangehandler':1753 'exports.refreshingestionhandler':1868,2273 'exports.validateconnectionhandler':1812 'extern':16,45,59,642,654,768,1480,1562,1587 'externalid':952 'fail':379,659,1426,2561 'fallback':673 'fals':287,1823,1848 'fastest':1209 'fetch':1274,1588,1809,1840 'fetchexternaldata':756,1278,2122 'field':336,1164,1461,1626,2400,2505 'figma':1947 'file':748,751,1046,1915,1946,2584 'fill':742,1160 'filter':2092 'find':1145,1643 'fire':2063,2608 'first':194,1084,1717 'fiveminut':2240 'fix':1449,2521 'flag':522,624 'flow':1354 'folder':926 'forg':2,9,42,49,55,112,187,380,387,421,423,427,442,456,465,477,499,661,679,714,984,994,1020,1033,1066,1090,1112,1186,1189,1223,1242,1305,1321,1333,1355,1366,1376,1382,1427,1447,1710,2338,2345,2363,2393,2417,2459,2477,2496,2512,2519,2532,2544,2551,2559,2567,2602,2621,2653,2656,2668,2717 'forge-app-build':993,1019,1032,2337,2362 'forge-connector':1 'forge/api':772,1811 'forge/cli':436 'forge/kvs':225,231,773,1748,2253,2441 'forge/storage':235,2436 'forge/teamwork-graph':252,260,774,797,947,1752,2109,2453,2634 'form':328,343,622,628,1456,1546,1622,1624,1726,2503,2508 'format':341 'formconfigur':326,1166,1454,1621,2498 'found':2539 'fresh':2208 'function':245,296,303,1204,1253,1369,1429,1530,1535,1675,1680,1685,1686,2115,2229,2242,2446,2485,2486,2607 'g':435 'generat':134,705,724,738,2315 'get':1733 'getobjectbyexternalid':937 'git':1962,1966 'give':128,980 'go':1011,1136 'googl':2684 'graph':11,22,53,65,85,178,248,258,369,373,782,785,795,945,1420,1423,1507,1599,1750,1770,2107,2386,2451,2464,2713 'graph.getobjectbyexternalid':951 'graph.setobjects':262,801,909,2143,2442,2456 'guess':154 'guid':4,394 'guidelin':2673,2708 'handler':182,197,740,808,1541,1699,1705,1707,2247,2411 'has-form-config':626 'header':332,346,1458,1632,2510 'hour':2238 'icon':1516,1608,2697 'id':521,563,585,591,813,816,898,955,1485,1566,2154 'id.atlassian.com':2664 'id.atlassian.com/manage/api-tokens,':2663 'identifi':2397 'imag':929,930 'immedi':1270,2054 'import':228,255,267,2448 'index':880,1899,1908,2060,2619 'index.onconnectionchangehandler':1542,1700 'index.refreshingestionhandler':2248 'index.validateconnectionhandler':1706 'ingest':15,44,58,608,778,1181,1266,1793,2010,2048,2066,2085,2203,2217,2232,2246 'ingestalldata':1800,1890,2116,2298 'insid':2494 'inspect':1309 'instal':79,89,97,148,429,434,720,970,2318,2331,2654 'instead':1307 'instruct':130 'interact':476,481,681,716,1238,1392,2553,2571 'interv':2233 'invalid':376,1850,2461 'invoc':1249,1311,1362 'iso':839 'isrequir':1663,1672 'issu':1365,1932 'item':1276,1929,2120,2151 'item.createdat':2166 'item.id':2155 'item.mimetype':2180,2183 'item.title':2162,2185 'item.updatedat':2168 'item.url':2164 'items.length':2129 'items.slice':2135 'javascript':726,793,943,1744,1807,1867,2105,2249 'jira':81,92,355,359,362,365,1073,1096,1119,1411,1414,1417,1497,1500,1503,1578,1581,1584,2075,2333,2470,2473,2476,2639,2642,2645 'keep':2206 'key':306,314,344,747,1405,1509,1536,1549,1601,1629,1651,1654,1660,1665,1694,1701,2225,2243 'kvs':229,1746,2251,2439 'kvs.deletesecret':1782 'kvs.get':1873,2278 'kvs.getsecret':1885,2290 'kvs.set':2260 'kvs.setsecret':1796,2267 'label':1658,1667 'larg':893,2103 'lastupdatedat':841,2167 'let':510,2125 'level':313,320,1014,1438,1693,2491 'light':1517,1609 'limit':1325,1338,1379 'line':1317 'lint':323,381,1428,1448,2394,2460,2478,2497,2513,2520 'list':460,471,2536 'live':990,1195,1357 'local':172,1778 'locat':2379 'log':1196,1224,1306,1316,1322,1328,1334,1342,1367,1377,2622 'logic':746 'login':113,426,443,2657,2669 'logo':2672,2695 'look':938,1271 'loop':897 'm':568,1064,1088,1110,2322,2343 'make':23 'manifest':389,1403,2391,2581,2648 'manifest.yml':302,694,762,2221,2316 'manual':129,672,983 'match':604 'math.floor':2194 'max':887 'may':2720 'mcp':382,384,388,396 'meet':1980 'memorymb':1489,1570 'merg':1958 'messag':279,288,1824,1849,1860,1921,1923 'mime':916 'mimetyp':868,871,2179,2182 'minim':1464 'minut':2058,2617 'miss':430 'mix':614 'modifi':2700 'modul':86,300,308,391,1433,1506,1598,1689,2223,2495,2715 'monitor':1184 'move':2492 'must':78,87,276,633,899,972,1384,1555,2499 'my-connector':1510,1602 'n':1275,1283 'name':249,271,571,574,786,1487,1513,1568,1605,2019,2088,2670,2678,2682 'narrow':2098 'need':150,168,656,663,691,1482,2569 'nest':199,2422 'never':102,151 'new':2312 'nicknam':2024,2096 'node':417 'node.js':416 'nodejs24.x':1488,1569 'non':475,2564 'non-interact':474 'non-tti':2563 'note':455,1381,1592 'npm':433,719 'oauth':1470 'object':191,263,354,358,361,364,576,596,610,810,889,942,1410,1413,1416,1496,1499,1502,1577,1580,1583,1893,1895,1906,2011,2038,2086,2149,2457,2469,2472,2475,2609,2638,2641,2644 'object-typ':575 'objecttyp':958,1525,1617 'offici':2676,2693 'omit':532,644 'on-connection-chang':1531,1537,1681,1695 'onconnectionchang':1174,1529,1679,1743,2062,2589 'onconnectionchangehandl':1215,2258 'open':2070 'oper':649,1475 'option':528,565,2204 'order':411 'org':1941,1992 'organ':1989 'output':1269 'package.json':770 'page':1916 'pass':185,188,1711,2418 'past':1310,1361 'path':1007,1042,2374 'pattern':2101 'pdf':928 'per':820,890,902,2157 'period':2218 'permiss':848,1493,1574,2169 'permissions.external.fetch.backend':764 'persist':1790 'pick':599 'place':315 'pleas':1853 'prefer':2235 'prerequisit':383,414 'present':924 'previous':594 'princip':850,2171 'print':670 'problem':2384 'product':1072,1095,1118,1327,1336,1364 'project':1934,1935 'prompt':504 'properti':219,349,1459,1650,1740,2090,2407,2428,2484,2502,2511 'provid':543,634,1556,1637 'prs':1957 'pull':1955 'pull-request':1954 'purpos':386,2305 'python3':567,1063,1087,1109,2321,2342 'queri':2042 'ran':1279 're':1265,2202,2215 're-ingest':1264,2201 're-run':2214 'read':357,368,1409,1419,1495,1576,2427,2431,2468,2637 'read/write':2463 'read/write/delete':353 'recent':1314 'recogn':2389 'record':1975 'redeploy':2651 'refer':1404,2034 'refresh':2227,2231,2245 'refresh-ingest':2230,2244 'refresh-trigg':2226 'refreshingest':1864 'reject':290,1286,1826 'relat':2045 'remov':175,1768 'replac':757,2466,2504 'report':1919 'repositori':1950,1952 'request':190,809,1713,1755,1763,1814,1820,1956,1959,2419 'request.action':1756 'request.configproperties':206,1730,1758,1815,2416 'request.configproperties.apikey':1657 'request.connectionid':1757 'requir':259,419,479,796,803,906,946,1236,1747,1751,1810,2108,2145,2252,2452,2501,2658 'respons':1838,2040 'response.ok':1845 'restrict':854 'result':799,2099,2141 'result.error':886,2199 'result.success':882,2187 'retriev':2292 'return':277,285,1784,1803,1821,1832,1846,1857 'review':1984 'rovo':27,32,70,73,1901,1904,1910,2004,2006,2014,2031,2071,2613 'rule':76,1406 'run':111,120,131,441,492,550,678,713,973,1023,1229,1303,1386,1398,1446,2216,2320,2334,2381,2392,2518,2550,2577,2601,2620,2667 'runtim':242,1486,1567 'scaffold':122,525,546,658,667,688,708,737,2310,2348 'schedul':1263,1865,2200,2211 'scheduledtrigg':2224 'schemavers':811,2152 'scope':351,367,1407,1494,1575,2462,2649 'script':123,526,534,668,689,976,989,1053,2301,2302,2349,2358 'scripts.deploy':1065,1089,1111,2344 'scripts.scaffold':569,2323 'scripts/deploy_forge_app.py':2325 'scripts/scaffold_connector.py':132,2306 'sdk':2319 'search':28,71,879,1902,2005,2015,2072,2078,2614 'searchabl':25 'secur':2272 'see':609,863 'select':484,505,598,2555 'server':385 'servic':1515,1607,1640,1647,2677,2694 'session':1239 'set':1648,1856,2025,2432 'setobject':268,777,791,884,1218,1288,2190,2630 'signatur':1708 'sinc':2625 'singl':941 'site':93,145,1061,1071,1080,1105,1117,1141,1332,1337,2076 'situat':1347 'size':2112,2132,2139,2197 'skeleton':741 'skill':553,997,1001,1016,1036,2303,2309,2328,2353,2366 'skill-forge-connector' 'skill.md':559,1010,1040,2377 'skills/forge-app-builder':2326 'skills/forge-connector':1015,2307 'skip':539,1121 'skip-dep':1120 'snippet':877 'sourc':214,818,957,2583 'source-atlassian' 'source-system.example.com':830 'source-system.example.com/doc/123'',':829 'space':454,459,473,487,508,520,562,584,1938,1940,2535,2558 'specif':856,1331 'spreadsheet':922 'src/index.js':696,725,755 'src/index.ts':2317 'start':1179 'state':173 'step':407,412,450,544,595,685,701,966,1123,1182 'storag':227,237,1504,1585,2434 'store':1779,2270,2293 'stream':1194,1268,1358 'string':1445,1597,1662,1671,2528 'subfilt':2018 'succeed':1289 'success':278,286,291,1785,1804,1822,1833,1847,1858,1863 'surfac':30,2008 'switch':2437 'syntax':390 'system':643,1563 't10':836 't14':845 'tab':1152 'tabl':612,866 'task':1930 'team':1939 'teamwork':10,21,64,84,177,370,374,781,1421,1424,1769,2465 'tell':437,495,1131,1225 'templat':501,723 'termin':117,446,1200,1234,1393,2572 'test':1351,2001,2002 'text':873,2080,2184 'thread':1970 'throw':282,1829 'thrown':1294 'ticket':1931 'time':1370,2030 'titl':347,827,875,1633 'token':2661 'tool':431 'top':312,319,1437,1692,2490 'top-level':311,1691 'topic':2044 'topic-agent-skills' 'topic-ai-agents' 'topic-claude-code-plugin' 'topic-claude-code-skills' 'topic-gemini-cli-extension' 'topic-mcp' 'track':2254 'trigger':1173,1261,1866,2212,2228,2591 'troubleshoot':2383 'true':292,1664,1673,1786,1805,1834,1859 'tti':482,665,2565 'tunnel':1187,1190,1243,1246,1300,1340,1356,1373,1383,2603 'two':1013 'type':331,345,577,597,601,611,851,860,917,1457,1631,1661,1670,1894,1907,2172,2176,2509 'typeerror':216,1737,2404,2425 'typescript':728 'typic':640 'ui':403 'uncaught':1291 'undefin':221,240,1742,2430 'uniqu':815,819,901,954,2156 'unique-id-from-sourc':814,953 'unit':1942 'updat':537,1789 'updatesequencenumb':822,2159 'upgrad':2655 'url':146,765,828,1062,1081,1106,1550,1669,2163,2527,2531 'use':34,83,224,234,247,327,335,342,356,616,783,1188,1304,1345,1348,1440,1455,1471,1551,1623,2412,2433,2449,2674,2691,2721 'user':37,109,141,439,490,497,677,712,857,982,1133,1227,1389,2549,2575 'v':418 'valid':1677,1703,1862 'validate-connect':1676,1702 'validateconnect':1674,1806 'validateconnectionhandl':275,1216,1297 'valu':203,1727 'verifi':2065,2592 'version':424 'via':1126,1400 'video':931,932,1973,1974 'view':1148 'vs':1341 'wait':1221,2615 'want':38 'warn':2514 'way':1210 'whoami':428 'wiki':1917 'within':651,1477 'without':1220 'work':100,739,1928,2068 'work-item':1927 'workflow':405 'workspac':1936 'wrap':1722 'write':360,372,693,1412,1422,1498,1579,2471,2580,2640 'wrong':1735,2447 'x':468,2547 'yaml':1483,1564,2219 'yet':1082 'yourcompany.atlassian.net':1108","prices":[{"id":"8fc2ba8d-d613-4ee8-b3dd-06e9597d7a37","listingId":"edbaa493-a657-4d8b-a14c-aeb2ad5ee6fa","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"atlassian","category":"forge-skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:14:33.759Z"}],"sources":[{"listingId":"edbaa493-a657-4d8b-a14c-aeb2ad5ee6fa","source":"github","sourceId":"atlassian/forge-skills/forge-connector","sourceUrl":"https://github.com/atlassian/forge-skills/tree/main/skills/forge-connector","isPrimary":false,"firstSeenAt":"2026-05-18T13:14:33.759Z","lastSeenAt":"2026-05-18T19:08:52.849Z"}],"details":{"listingId":"edbaa493-a657-4d8b-a14c-aeb2ad5ee6fa","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"atlassian","slug":"forge-connector","github":{"repo":"atlassian/forge-skills","stars":8,"topics":["agent-skills","ai-agents","claude-code-plugin","claude-code-skills","gemini-cli-extension","mcp"],"license":"apache-2.0","html_url":"https://github.com/atlassian/forge-skills","pushed_at":"2026-05-14T21:21:41Z","description":"The Forge Skills Plugin bundles several Forge-focused skills plus MCP-backed tooling so your agent can scaffold apps, review them before deploy, debug production issues, and stay current on Forge APIs and the Atlassian Design System.","skill_md_sha":"7ea548206d1caac2131ffa5ed0af02950c79f03d","skill_md_path":"skills/forge-connector/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/atlassian/forge-skills/tree/main/skills/forge-connector"},"layout":"multi","source":"github","category":"forge-skills","frontmatter":{"name":"forge-connector","license":"Apache-2.0","description":"Guides building and deploying Atlassian Forge Teamwork Graph connector apps that ingest external data into Atlassian's Teamwork Graph, making it searchable in Rovo Search and surfaced in Rovo Chat. Use when the user wants to build a Forge connector, ingest external data into Atlassian, connect a third-party tool (e.g. Google Drive, ServiceNow, Salesforce) to Atlassian, make external content searchable in Rovo, build a graph:connector module, use the @forge/teamwork-graph SDK, or implement onConnectionChange / validateConnection functions."},"skills_sh_url":"https://skills.sh/atlassian/forge-skills/forge-connector"},"updatedAt":"2026-05-18T19:08:52.849Z"}}