skills.rest
tunacosgun
tunacosgunCOMMUNITY
Explore all skills by this author →
Website𝕏@tunahan06GitHub

add-connector

Create and register a Sim knowledge connector with authentication and registry wiring.

Updated Apr 16, 2026
Search Tags:#oauth#validation#registry#connector#knowledge-base#api-key#external-source
One-click install
npx skills add https://github.com/tunacosgun/sim --skill add-connector-tunacosgun
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-connector
Source: https://github.com/tunacosgun/sim/tree/main/.agents/skills/add-connector
Command: npx skills add https://github.com/tunacosgun/sim --skill add-connector-tunacosgun

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams create and register a new Sim knowledge connector that syncs documents from external sources into the knowledge base, including authentication mode, field configuration, pagination handling, document metadata mapping, and registry wiring. Use when adding connectors inside apps/sim/connectors/{service}/ or when introducing a new external document source.

Core Features & Use Cases

  • Create and register a ConnectorConfig for a new service, with authentication (OAuth or API key) and configurable fields.
  • Wire the connector into the central registry so the knowledge base can discover and use it in workflows.
  • Validate connectivity and configuration to ensure the source can be accessed and documents can be retrieved safely.

Quick Start

Run the add-connector tool to create and register a new Sim knowledge connector for a service.

Frequently Asked Questions about add-connector

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create and register a Sim knowledge connector for an external document source?▼

To create and register a Sim knowledge connector, implement a ConnectorConfig with listDocuments, getDocument, validateConfig, and optional mapTags, then wire it into the CONNECTOR_REGISTRY inside the apps/sim/connectors directory.

What authentication methods can I use when adding a new knowledge connector?▼

Knowledge connectors support both OAuth-based and API key-based authentication modes for external document sources, allowing configurable fields to securely access and sync documents into the knowledge base.

How should I handle external API calls when building a connector?▼

External API calls in a knowledge connector must use fetchWithRetry for all requests, ensuring documents are retrieved safely and connectivity issues are handled without breaking the sync workflow.

Does a new connector require validation before it can sync documents?▼

Yes, a new connector requires validation through the validateConfig function to ensure the external source can be accessed and documents can be retrieved safely before the connector is used in workflows.

What is the purpose of mapping tags in a knowledge connector?▼

Mapping tags in a knowledge connector is an optional feature that translates external document metadata into internal tags, allowing the knowledge base to properly categorize and discover synced documents.

Can I update an existing connector instead of creating a new one?▼

Yes, this connector creation process is used when adding or updating connectors for external document sources, allowing you to modify existing authentication, field configuration, and pagination handling within the apps/sim/connectors directory.

Related Skills

Explore More Software Engineering Skills→
Orvanta-CloudOrvanta-Cloud

resources

Manage external service credentials and configurations for databases and APIs.

Official
Intermediate
patronus-aipatronus-ai
2

rag-implementation

Build RAG systems using vector databases and semantic search.

Official
Intermediate
jsagirjsagir
2

new-surface

Automates creation of command, agent, or skill surfaces in MindrianOS.

Community
Advanced
vana-comvana-com
9

create-connector

Scaffold, test, and validate new data connectors against platform APIs.

Official
Advanced