Claude Cursor Skill

ffi-and-language-interop

FFI and native interop rules: single documented pointer ownership, opaque handles, null-pointer checks, allocate/free pairs, unsafe-block invariants, generated C headers, stable C ABI, frozen struct layouts, and error/context conversion. Load when writing or reviewing FFI boundar

LLM Mart · 0 points · 0 0 0

Virus-scanned Reviewed automatically before listing.

Full trust report

Download goldziher-ai-rulez-internal_builtins_universal_polyglot-bindings_skills_ffi-and-language-interop-ca967ad.zip · 0 KB

goldziher/ai-rulez 162 16 forks MIT Updated 5h ago

Part of goldziher/ai-rulez — 151 skills

Install

skills CLI

npx skills add https://github.com/Goldziher/ai-rulez/tree/main/internal/builtins/universal/polyglot-bindings/skills/ffi-and-language-interop

Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install goldziher-ai-rulez@llmmart

Git git clone https://github.com/Goldziher/ai-rulez.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole goldziher/ai-rulez collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Every pointer has one owner, documented with SAFETY comments or host-language ownership docs.
Use opaque handles across native boundaries. Do not expose Rust, C++, or host-runtime internals directly.
Check all nullable pointers before use and return explicit errors for invalid handles or null inputs.
Provide allocate/free pairs for every caller-owned allocation and document which side frees each value.
Every unsafe block must state the invariant, why it holds, and what would make it invalid.
Generate C headers or native declarations from source when possible, and make CI verify generated files are current.
Treat the C ABI or equivalent native ABI as the stable contract for downstream bindings.
Freeze native struct layouts across compatible releases, and version breaking ABI changes deliberately.
Convert native errors to host exceptions, result objects, or idiomatic error values at every boundary.
Preserve diagnostic context across boundaries: message, numeric code when available, source operation, and cause chain.

Files (ai-rulez)

SKILL.md 1.4 KB

---
name: ffi-and-language-interop
description: "FFI and native interop rules: single documented pointer ownership, opaque handles, null-pointer checks, allocate/free pairs, unsafe-block invariants, generated C headers, stable C ABI, frozen struct layouts, and error/context conversion. Load when writing or reviewing FFI boundaries between native and host languages."
---

- Every pointer has one owner, documented with `SAFETY` comments or host-language ownership docs.
- Use opaque handles across native boundaries. Do not expose Rust, C++, or host-runtime internals directly.
- Check all nullable pointers before use and return explicit errors for invalid handles or null inputs.
- Provide allocate/free pairs for every caller-owned allocation and document which side frees each value.
- Every unsafe block must state the invariant, why it holds, and what would make it invalid.
- Generate C headers or native declarations from source when possible, and make CI verify generated files are current.
- Treat the C ABI or equivalent native ABI as the stable contract for downstream bindings.
- Freeze native struct layouts across compatible releases, and version breaking ABI changes deliberately.
- Convert native errors to host exceptions, result objects, or idiomatic error values at every boundary.
- Preserve diagnostic context across boundaries: message, numeric code when available, source operation, and cause chain.