kreuzberg-dev/.remote-cache/kreuzberg-shared-rules/.ai-rulez/skills/polyglot-bindings
.remote-cache/kreuzberg-shared-rules/.ai-rulez/skills/polyglot-bindings/SKILL.md
______________________________________________________________________ ## priority: medium # Polyglot Binding Architecture ## Language Binding Pattern Each binding crate (Python, TypeScript, Ruby, PHP, Go, Java, C#) follows: 1. **Minimal wrapper layer**: Call Rust functions directly, no business logic 1. **Type translation**: Convert host language types ↔ Rust types 1. **Error mapping**: Rust errors → language-native exceptions 1. **Documentation**: Link bindings to Rust docs, add language-
$ install --global
skillsauthnpx skillsauth add kreuzberg-dev/html-to-markdown .remote-cache/kreuzberg-shared-rules/.ai-rulez/skills/polyglot-bindingsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 6, 2026, 1:44 PM6.8s1 file scanned
SKILL.md
priority: medium
Polyglot Binding Architecture
Language Binding Pattern
Each binding crate (Python, TypeScript, Ruby, PHP, Go, Java, C#) follows:
- Minimal wrapper layer: Call Rust functions directly, no business logic
- Type translation: Convert host language types ↔ Rust types
- Error mapping: Rust errors → language-native exceptions
- Documentation: Link bindings to Rust docs, add language-specific examples
- Testing: Language-native test suite validating binding + integration
Binding Crates (crates/)
- html-to-markdown-py: PyO3 bindings → packages/python distribution
- html-to-markdown-node: NAPI-RS bindings → packages/typescript npm package
- html-to-markdown-rb: Magnus bindings → packages/ruby gem (Ruby 3.2+)
- html-to-markdown-php: ext-php-rs extension → packages/php Composer package
- html-to-markdown-wasm: wasm-bindgen → browser + Wasmtime targets
- html-to-markdown-ffi: C-compatible FFI library → Go, Java, C# consumers
- html-to-markdown-cli: Standalone CLI using core library
Distribution Packages (packages/)
- python/: PyPI package with Python wrappers + tests
- typescript/: npm package with TypeScript wrappers + CLI + tests
- ruby/: Ruby gem (RBS types in sig/, specs in spec/)
- php/: Composer package with PHP wrappers + PHPUnit tests
- php-ext/: PIE metadata for ext-php-rs distribution
- go/: Go module wrapping FFI library
- java/: Maven project wrapping FFI library with JNI
- csharp/: .NET project wrapping FFI library with P/Invoke
Related Skills
kreuzberg-dev/html-to-markdown
tools
VerifiedTrustedCommunity
Convert HTML to Markdown, Djot, or plain text with structured extraction. Use when writing code that calls html-to-markdown APIs in Rust, Python, TypeScript, Go, Ruby, PHP, Java, C#, Elixir, R, C, or WASM. Covers installation, conversion, configuration, metadata extraction, document structure, and CLI usage.
658SKILL.mdUpdated Apr 6, 2026
kreuzberg-dev/quick-start
development
VerifiedTrustedCommunity
Developer quick start guide with prerequisites, setup, and workflow commands
651SKILL.mdUpdated Apr 6, 2026
kreuzberg-dev/common-task-commands
development
VerifiedTrustedCommunity
Common task runner commands for build, test, lint, and format workflows
650SKILL.mdUpdated Apr 6, 2026
kreuzberg-dev/.remote-cache/kreuzberg-shared-rules/.ai-rulez/skills/workspace-structure-project-organization
tools
VerifiedTrustedCommunity
______________________________________________________________________ ## priority: high # Workspace Structure & Project Organization **Rust workspace** (Cargo.toml): crates/{kreuzberg,kreuzberg-py,kreuzberg-node,kreuzberg-ffi,kreuzberg-cli}, packages/ruby/ext/kreuzberg_rb/native, tools/{benchmark-harness,e2e-generator}, e2e/{rust,go}. **Language packages**: packages/{python,typescript,ruby,java,go} - thin wrappers around Rust core. **E2E tests**: Auto-generated from fixtures/ via tools/e2e
628SKILL.mdUpdated Apr 6, 2026