kreuzberg-dev/.remote-cache/kreuzberg-shared-rules/.ai-rulez/skills/rust-core-arch
.remote-cache/kreuzberg-shared-rules/.ai-rulez/skills/rust-core-arch/SKILL.md
______________________________________________________________________ ## priority: medium # Rust Core Architecture ## Core Library Crate - **Library crate**: crates/core-library/ implements the core domain logic - **Domain focus**: Clear separation of concerns with focused business logic - **Error handling**: thiserror for ergonomic custom errors - **Processing pipeline**: Parse input → Transform data → Validate result → Format output - **Performance**: zero-copy where possible, streaming f
$ install --global
skillsauthnpx skillsauth add kreuzberg-dev/html-to-markdown .remote-cache/kreuzberg-shared-rules/.ai-rulez/skills/rust-core-archInstall 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 PM5.6s1 file scanned
SKILL.md
priority: medium
Rust Core Architecture
Core Library Crate
- Library crate: crates/core-library/ implements the core domain logic
- Domain focus: Clear separation of concerns with focused business logic
- Error handling: thiserror for ergonomic custom errors
- Processing pipeline: Parse input → Transform data → Validate result → Format output
- Performance: zero-copy where possible, streaming for large data structures
- Dependencies: Leverage the Rust ecosystem (serde, tracing, thiserror, etc.)
Integration Points
- PyO3 bindings: crates/core-library-py exports Rust API to Python
- NAPI-RS bindings: crates/core-library-node for Node.js/Bun
- Magnus bindings: Ruby gem uses Magnus for clean FFI
- ext-php-rs bindings: crates/core-library-php for PHP extension
- WASM: crates/core-library-wasm for browser/Wasmtime
- FFI library: crates/core-library-ffi for C-compatible exports (Go, Java, C#)
Testing Strategy
- Doc tests on public types with realistic domain examples
- Unit tests per module (core components, utilities, validators)
- Integration tests with actual data fixtures in crates/core-library/tests/
- Benchmarks in benches/ with criterium for performance-critical paths
- Coverage: cargo-llvm-cov with 95% threshold
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