.remote-cache/kreuzberg-shared-rules/.ai-rulez/skills/workspace-structure-project-organization/SKILL.md
______________________________________________________________________ ## 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
npx skillsauth add kreuzberg-dev/html-to-markdown .remote-cache/kreuzberg-shared-rules/.ai-rulez/skills/workspace-structure-project-organizationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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-generator. Located in e2e/{rust,python,typescript,ruby,java,go}.
Benchmarking: Rust harness in tools/benchmark-harness.
Install: uv sync --all-extras --all-packages --all-groups.
Version sync: task sync-versions (syncs from Cargo.toml to all manifests).
tools
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.
development
Developer quick start guide with prerequisites, setup, and workflow commands
development
Common task runner commands for build, test, lint, and format workflows
development
______________________________________________________________________ ## priority: critical # Workspace Dependency Management ## Cargo Workspace Fundamentals A workspace coordinates multiple crates under unified configuration. This is **critical** for polyglot projects with core library + language bindings. **workspace/Cargo.toml**: ```toml [workspace] members = [ "crates/html-to-markdown", # Core library "crates/html-to-markdown-py", # PyO3 bindings "crates/h