new-integration
/new-integration
Tworzy szkielet nowej integracji z manifestem, obsługą, przykładowymi danymi i testem według opisu w README.
- Autor
- asteroidai ↗
- Repozytorium
- headless-ops ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 30.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 30.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Tworzy szkielet nowej integracji z manifestem, obsługą, przykładowymi danymi i testem według opisu w README.
Wyzwalacze z opisu
Oryginalny opis (EN)
Scaffold a new integration folder (manifest, handler or pull or actions, fixture, test) from the contract in integrations/README.md. Triggers on `/new-integration <name>` or "add an integration for X".
Jak działa
- 1. Decide the kind
- 2. Find the real payload
- 3. Write the files
- 4. Verify
Podgląd SKILL.md
---
name: new-integration
description: Scaffold a new integration folder (manifest, handler or pull or actions, fixture, test) from the contract in integrations/README.md. Triggers on `/new-integration <name>` or "add an integration for X".
---
# new-integration
Read `integrations/README.md` first. Then read one existing integration of the same kind as a model: `cal-com` (signal), `github-stargazers` (pull), `exa` (tool), `slack` (write).
## 1. Decide the kind
Ask once if it is not clear: does the source call us (signal), do we fetch on a schedule (pull), do skills read from it (tool), or do we write to it (write)?
## 2. Find the real payload
Look up the source's webhook or API docs. Record one real-shaped example in `fixtures/`. Use made-up people and `example.com`-style domains. Note how the source authenticates (HMAC header, shared token, bearer).
## 3. Write the files
`integrations/<name>/manifest.json`: name equals the folder; kind; one-sentence description; every env var with where to get it; events as `<name>.<thing>.<verb>`; the skill the default route points at; `defaults.on`; for a pull, `schedule` and `defaults.settings`.
`integrations/<name>/index.ts`: default export `Integration`. Signals: `handle` returns `null` on a failed check (fail closed when the secret is unset) and `Signal[]` otherwise, built with `makeSignal(source, event, subject, payload, occurredAt)`; `sign(rawBody)` produces the same auth so `gtm webhook` and tests can replay. Pulls: `pull({ settings, state })` keeps a watermark in `state`. Tools and writes: `actions` with short input docs, compact outputs, `requireEnv` for keys, `fetchJson` for HTTP.
`integrations/<name>/<name>.test.ts`: vitest, `vi.stubGlobal("fetch", ...)`, replay the fixture, assert the signal or the request body. No live network.
If the integration needs a new skill, write `.claude/skills/<skill>/SKILL.md` in the shape of `research-company`: read payload, work, one completion POST.
## 4. Verify
Run `pnpm typecheck` and `pnpm test`. Then `pnpm -s gtm add <name>` and show the user the env vars to set. Keep the whole integration under 150 lines where you can.
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · asteroidai/headless-ops | 95 | MIT |
| emplio-app/emplio | 100 | AGPL-3.0 |
Migawka bazy z 13.11.2026 · wersja paczki 915844be0027 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100ha-integration-scaffold
Tworzy szkielet nowej integracji Home Assistant z poprawną strukturą plików, manifestem i kodem startowym. - 100add-service
Tworzy szkielet nowej integracji z usługą zewnętrzną albo moduł domenowy z własną inicjalizacją i stanem. - 100add-service
Tworzy szkielet nowej integracji usługi: zewnętrzne API albo wielokrotnego użytku moduł domenowy z własną inicjalizacją i stanem. - 91add-tool
Tworzy szkielet nowej definicji narzędzia MCP, gdy użytkownik chce dodać możliwość do serwera. - 100create-plugin-scaffold
Tworzy szkielet wtyczki Cursor z poprawnym manifestem, katalogami komponentów i podłączeniem do marketplace, także w repozytorium z wieloma wtyczkami. - 100wp-plugin-scaffold
Tworzy szkielet nowej wtyczki WordPress z autoloadingiem PSR-4, obsługą aktywacji i dezinstalacji, tłumaczeniami i testami.