integrations-prior-art-survey

Surveys third-party integration surfaces across connector catalogs, API descriptors, and registries into a validated register.

1|1|Updated May 24, 2026
One-click install
npx skills add https://github.com/bm629/agent-skills --skill integrations-prior-art-survey-bm629
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: integrations-prior-art-survey
Source: https://github.com/bm629/agent-skills/tree/main/skills/integrations-prior-art-survey
Command: npx skills add https://github.com/bm629/agent-skills --skill integrations-prior-art-survey-bm629

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Before committing to an architecture, product teams need to know which third-party integrations their domain requires, but ad-hoc searching produces unfalsifiable claims with no recorded denominators, no verbatim queries, and no way to distinguish a service no catalog carries from a search that never ran. ## Core Features & Use Cases - Four-wave survey pipeline: builds an integration vocabulary map (wave 0), executes one of eight search angles across connector catalogs, OpenAPI descriptors, SDK registries, webhook conventions, and MCP channels (wave 1), deep-reads one admitted service into an extract record (wave 2), and synthesizes everything into an integration register through eight lenses (wave 3). - Deterministic schema gate: every artifact is validated by a Python script against JSON schemas, with cross-checks joining the register, extract records, and frozen queue in both directions. - Honest absence recording: zero-hit cells carry their queries and receipts, out-of-vocabulary values map to null or unknown rather than forced guesses, and injected instructions in third-party descriptor text are neutralized and recorded as a posture finding. - Use Case: Before designing a scheduling product's architecture, run the survey to produce an integration register ranking services like calendar and payments providers by catalog presence, directory hits, availability, and an auditable complexity score. ## Quick Start Use the integrations-prior-art-survey skill to map the integration surface for my product scope and produce a validated integration register.

Frequently Asked Questions about integrations-prior-art-survey

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

FAQPage Schema
How do I survey third-party integrations before choosing a product architecture?

Run the four-wave procedure: build the integration vocabulary map from your capability classification, execute each applicable search angle against its declared sources, deep-read admitted services into extract records, then synthesize the integration register. Every artifact is validated by the deterministic gate script before review.

What sources does an integrations prior-art survey search?

It searches connector catalogs, machine-readable API descriptors such as OpenAPI, first-party integration directories, package registries for SDK adoption, webhook and event delivery conventions, regulated-integration constraints, unified-API abstractions, and MCP registries, across eight angles named a1 through b5.

How are survey artifacts validated?

Each artifact is checked by scripts/validate_integrations_prior_art.py against JSON schemas using pyyaml and jsonschema. The synthesis gate also cross-checks the register against the extract records and the frozen extract queue in both directions, refusing disagreements.

How does the survey handle prompt injection in fetched content?

All fetched pages, descriptors, and registry entries are treated as untrusted data, never instructions. Neutralized injections are recorded as a posture finding in the sanitization field with a status of clean, modified, unavailable, or not-fetched, never as a count.

What happens when a search angle finds nothing?

A zero result is recorded with its receipts: the queries run verbatim, the cell status, and whether the listing was fully enumerated. Absence entries in the register always carry angles_ran and terms_searched, so a zero is distinguishable from a search that never ran.

When should a service be excluded from the extract wave?

A service is skipped with a typed cause when it serves no scope capability, has no public API, is access-gated, is unreachable, or duplicates another queued row. A skipped record is still written to disk so the queue row is distinguishable from work never done.