How do I install the Run Integration skill?

Run npx skillmds@latest add open-metadata/run-integration in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Run Integration safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Run Integration?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Run Integration free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Run Integration?

open-metadata (@open-metadata) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Run Integration by open-metadata — Agent Skill

Name: Run Integration
Author: open-metadata

File contents

Run Integration Tests

Runs integration tests against a real Metadata instance. These tests use actual API calls.

Usage

/run-integration [sdk]

Where [sdk] is optional: python, typescript, java, cli, n8n, or all (default).

Prerequisites

Integration tests require environment variables:

AI_SDK_HOST - Base URL of the Metadata instance (e.g., https://your-instance.getcollate.io)
AI_SDK_TOKEN - Valid JWT token for authentication
AI_SDK_TEST_AGENT - (Optional) Name of agent to test with

Commands

Run All Integration Tests

AI_SDK_HOST=https://... AI_SDK_TOKEN=... make test-integration

Run Individual SDK Tests

Python:

cd python && AI_SDK_HOST=... AI_SDK_TOKEN=... pytest tests/integration/ -v

TypeScript:

cd typescript && AI_SDK_HOST=... AI_SDK_TOKEN=... npm run test:integration

Java:

cd java && AI_SDK_HOST=... AI_SDK_TOKEN=... mvn test -Dtest=IntegrationTest

Rust CLI:

cd cli && AI_SDK_HOST=... AI_SDK_TOKEN=... cargo test --test integration_test

n8n:

cd n8n-nodes-metadata && AI_SDK_HOST=... AI_SDK_TOKEN=... npm run test:integration

What Integration Tests Verify

Authentication - Token is valid and accepted
Agent Discovery - Can list available agents
Agent Invocation - Can invoke an agent and get response
Streaming - SSE streaming works correctly (if AI_SDK_RUN_CHAT_TESTS=true)
Error Handling - Proper errors for invalid requests

Troubleshooting

Error	Cause	Fix
401 Unauthorized	Invalid/expired token	Get fresh token from Metadata UI
404 Not Found	Agent doesn't exist	Check `AI_SDK_TEST_AGENT` value
Connection refused	Wrong host URL	Verify `AI_SDK_HOST`
Timeout	Network/firewall issue	Check connectivity

Notes

Integration tests are skipped in CI unless secrets are configured
Tests use real AI tokens when AI_SDK_RUN_CHAT_TESTS=true
Always test locally before pushing changes that affect API calls

---name: run-integrationdescription: Use when running integration tests against a real Metadata instance. Guides setup of environment variables (AI_SDK_HOST, AI_SDK_TOKEN) and runs tests that make actual API calls.---# Run Integration TestsRuns integration tests against a real Metadata instance. These tests use actual API calls.## Usage```/run-integration [sdk]```Where `[sdk]` is optional: `python`, `typescript`, `java`, `cli`, `n8n`, or `all` (default).## PrerequisitesIntegration tests require environment variables:- `AI_SDK_HOST` - Base URL of the Metadata instance (e.g., `https://your-instance.getcollate.io`)- `AI_SDK_TOKEN` - Valid JWT token for authentication- `AI_SDK_TEST_AGENT` - (Optional) Name of agent to test with## Commands### Run All Integration Tests```bashAI_SDK_HOST=https://... AI_SDK_TOKEN=... make test-integration```### Run Individual SDK Tests**Python:**```bashcd python && AI_SDK_HOST=... AI_SDK_TOKEN=... pytest tests/integration/ -v```**TypeScript:**```bashcd typescript && AI_SDK_HOST=... AI_SDK_TOKEN=... npm run test:integration```**Java:**```bashcd java && AI_SDK_HOST=... AI_SDK_TOKEN=... mvn test -Dtest=IntegrationTest```**Rust CLI:**```bashcd cli && AI_SDK_HOST=... AI_SDK_TOKEN=... cargo test --test integration_test```**n8n:**```bashcd n8n-nodes-metadata && AI_SDK_HOST=... AI_SDK_TOKEN=... npm run test:integration```## What Integration Tests Verify1. **Authentication** - Token is valid and accepted2. **Agent Discovery** - Can list available agents3. **Agent Invocation** - Can invoke an agent and get response4. **Streaming** - SSE streaming works correctly (if `AI_SDK_RUN_CHAT_TESTS=true`)5. **Error Handling** - Proper errors for invalid requests## Troubleshooting| Error | Cause | Fix ||-------|-------|-----|| 401 Unauthorized | Invalid/expired token | Get fresh token from Metadata UI || 404 Not Found | Agent doesn't exist | Check `AI_SDK_TEST_AGENT` value || Connection refused | Wrong host URL | Verify `AI_SDK_HOST` || Timeout | Network/firewall issue | Check connectivity |## Notes- Integration tests are **skipped in CI** unless secrets are configured- Tests use real AI tokens when `AI_SDK_RUN_CHAT_TESTS=true`- Always test locally before pushing changes that affect API calls

Frequently asked questions

Run Integration