goldziher - Bindings are minimal glue: call the core library, convert types, convert errors — no business logic.
- Canonical surface: core API first, stable native ABI second, language bindings third.
- Keep integrations and framework adapters outside language bindings unless they are the binding's public purpose.
- Give each binding its own language-native test suite and run it in CI.
- Generated binding and e2e code must not be hand-edited. Change the source schema, generator, or core API instead.
- Error conversion must preserve context across every boundary: message, numeric code when available, and operation.
- Async boundaries must match host runtime conventions; do not block event loops, schedulers, or UI threads.
Bindings
Cross-language binding architecture rules: bindings as minimal glue, canonical API surface ordering (core, ABI, language), per-language test suites in CI, generated-code discipline, and error/async boundary preservation. Load when designing or reviewing polyglot language bindings for a shared core.
Bindings by goldziher · 54ecb79
npx skillmds@latest add goldziher/bindings File contents
---name: bindingsdescription: Cross-language binding architecture rules: bindings as minimal glue, canonical API surface ordering (core, ABI, language), per-language test suites in CI, generated-code discipline, and error/async boundary preservation. Load when designing or reviewing polyglot language bindings for a shared core.---- Bindings are minimal glue: call the core library, convert types, convert errors — no business logic.- Canonical surface: core API first, stable native ABI second, language bindings third.- Keep integrations and framework adapters outside language bindings unless they are the binding's public purpose.- Give each binding its own language-native test suite and run it in CI.- Generated binding and e2e code must not be hand-edited. Change the source schema, generator, or core API instead.- Error conversion must preserve context across every boundary: message, numeric code when available, and operation.- Async boundaries must match host runtime conventions; do not block event loops, schedulers, or UI threads.
goldziher/ai-rulez/tree/main/internal/builtins/universal/polyglot-bindings/skills/bindings commit 54ecb790d0
Frequently asked questions
Run npx skillmds@latest add goldziher/bindings in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Cross-language binding architecture rules: bindings as minimal glue, canonical API surface ordering (core, ABI, language), per-language test suites in CI, generated-code discipline, and error/async boundary preservation. Load when designing or reviewing polyglot language bindings for a shared core. It is listed under Integrations & APIs on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
goldziher (@goldziher) published this skill. Their other Agent Skills are listed on their SkillMD profile.