kreuzberg-dev/.remote-cache/kreuzberg-shared-rules/.ai-rulez/skills/pyo3-performance-patterns
.remote-cache/kreuzberg-shared-rules/.ai-rulez/skills/pyo3-performance-patterns/SKILL.md
______________________________________________________________________ ## priority: high # PyO3 Performance Patterns Use `pyo3_async_runtimes` for async Python callbacks (~28x faster than spawn_blocking for fast ops). Pattern: Check `__await__` attribute, use `pyo3_async_runtimes::tokio::into_future()` for async, fallback to spawn_blocking for sync. Release GIL before awaiting. Use Python::attach() not with_gil(). spawn_blocking for long ops (OCR), block_in_place for quick ops (PostProcesso
$ install --global
skillsauthnpx skillsauth add kreuzberg-dev/html-to-markdown .remote-cache/kreuzberg-shared-rules/.ai-rulez/skills/pyo3-performance-patternsInstall 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 PM8.5s1 file scanned
SKILL.md
priority: high
PyO3 Performance Patterns
Use pyo3_async_runtimes for async Python callbacks (~28x faster than spawn_blocking for fast ops).
Pattern: Check __await__ attribute, use pyo3_async_runtimes::tokio::into_future() for async, fallback to spawn_blocking for sync. Release GIL before awaiting. Use Python::attach() not with_gil().
spawn_blocking for long ops (OCR), block_in_place for quick ops (PostProcessor/Validator). CRITICAL: spawn_blocking on PostProcessor/Validator causes GIL deadlocks.
Reference: crates/kreuzberg-py/README.md
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