add-integration

Scaffolds complete API integration skill structures from discovered REST API documentation.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill add-integration-fahadimdad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-integration
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/system/add-integration
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill add-integration-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve? Building a new API integration normally requires manually writing an API client, config validation, setup wizards, and per-endpoint scripts. This Skill automates that by discovering a service's API endpoints via web search, planning the architecture, and generating the full master/connect/specialized skill structure from templates. ## Core Features & Use Cases - API Discovery: Uses web search to find official API documentation, detect authentication type (OAuth2, API key, bearer), and enumerate available endpoints. - Interactive Planning: Presents categorized endpoints for user selection, gathers authentication details, and saves everything to a project with an implementation checklist. - Code Scaffolding: The scaffold_integration.py script generates an API client, config checker, setup wizard, reference docs, and one skill per endpoint from templates. - Use Case: Say you want to connect Nexus to HubSpot. The Skill finds HubSpot's API docs, lets you pick the contacts and deals endpoints, then generates a hubspot-master skill with a Python client plus individual skills like hubspot-list-contacts. ## Quick Start Say "add integration for HubSpot" and follow the prompts to select endpoints and confirm authentication details.

Frequently Asked Questions about add-integration

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

FAQPage Schema
How do I add a new API integration to Nexus?

Say "add integration" and provide the service name. The Skill searches for the official API documentation, presents discovered endpoints for selection, collects authentication details, and creates a project that scaffolds the full integration structure.

What authentication types does the integration scaffolding support?

The templates support three authentication types: OAuth2 with client credentials and automatic token refresh, bearer token authentication, and simple API key authentication passed in request headers. The type is detected from the API documentation or confirmed by the user.

What files does the integration scaffolding script generate?

It generates a master skill with an API client, config checker, setup wizard, and reference docs, plus a connect meta-skill for routing, and one specialized skill per selected endpoint with its own Python script and SKILL.md.

What happens if the API documentation search fails?

The Skill offers fallback options: you can provide the API docs URL directly, manually specify the base URL and authentication type, or try a different service name. Planning progress is only saved after a project is created.

Does the add-integration skill implement the endpoints immediately?

No. It handles discovery and planning, then creates a project with an implementation checklist. The actual scaffolding runs in a follow-up session via the execute-project skill, which calls scaffold_integration.py with the saved config.