native-api-connectors-plus

Built on affaan-m/ECC by @affaan-m (246,035 stars, MIT). All credit for the original idea to them. This fork improves and repackages it; upstream license preserved in UPSTREAM_LICENSE.

Build safe API connectors that match the design, tests, and rules of an existing codebase.

This Claude Code skill is for developers who add API providers, plugins, or connectors to active projects. It helps Claude study the repo first, follow its current patterns, and build only what the task needs.

💡 Why

API code can work and still feel wrong for the repo.

A new connector may use a different config shape, skip the registry, leak secrets, or handle errors in a new way. It may also copy old code that the project no longer uses.

This skill gives Claude Code a clear process for making the new connector feel native.

🚀 Install

Run one command:

mkdir -p ~/.claude/skills/api-connector-builder && curl -fsSL https://raw.githubusercontent.com/native-api-connectors-plus/native-api-connectors-plus/main/skill/SKILL.md -o ~/.claude/skills/api-connector-builder/SKILL.md

The skill is one file and has no extra packages.

🛠️ Usage

Ask Claude Code to add a connector:

Use the api-connector-builder skill to add a GitHub issues connector.

Support:
- List issues
- Get one issue
- Create one issue

Follow the repo's current config, auth, retry, error, test, and registry patterns.

Expected output:

Claude inspects the current connector code and tests.
It finds the shared config, HTTP, error, and registry tools.
It adds the smallest useful GitHub issues connector.
It maps API data into the repo's own types.
It adds tests for auth, pages, errors, timeouts, and rate limits.
It updates the same docs and sample config used by nearby connectors.

The skill also tells Claude to stop when the repo has no clear connector pattern. This keeps a small task from turning into a new integration system.

🔄 What we changed vs upstream

• Rewritten from Japanese into clearer, plain English, with explicit attribution to the original ECC author.
• Adds stronger safety rules for secrets, telemetry, hidden network calls, breaking changes, and preserving existing connector behavior.
• Expands repository discovery guidance, including fallbacks when only one or no existing connector is available.
• Adds substantially more scope and edge-case coverage for authentication, pagination, rate limits, webhooks, malformed responses, and partial failures.
• Strengthens implementation guidance around native data mapping, shared utilities, timeouts, safe retries, error preservation, and pagination-loop prevention.

📄 License

This project is released under the MIT License.

The upstream MIT license and author notice are preserved in UPSTREAM_LICENSE.