.remote-cache/kreuzberg-shared-rules/.ai-rulez/skills/build-profiles/SKILL.md
______________________________________________________________________ ## priority: critical # Build Profiles **BUILD_PROFILE environment variable controls build mode** (default: "release"). **Available Profiles**: 1. **dev**: Fast iteration, debug symbols, no optimizations. Use for development/testing. - Cargo profile: debug - Optimization: -C opt-level=0 - Usage: `BUILD_PROFILE=dev task rust:build` or `task rust:build:dev` 1. **release**: Optimized production builds, minimal de
npx skillsauth add kreuzberg-dev/html-to-markdown .remote-cache/kreuzberg-shared-rules/.ai-rulez/skills/build-profilesInstall 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.
BUILD_PROFILE environment variable controls build mode (default: "release").
Available Profiles:
dev: Fast iteration, debug symbols, no optimizations. Use for development/testing.
BUILD_PROFILE=dev task rust:build or task rust:build:devrelease: Optimized production builds, minimal debug symbols. Use for production/benchmarking.
BUILD_PROFILE=release task rust:build or task rust:build:releaseci: Release optimizations + debug symbols for troubleshooting. Use in CI/CD pipelines.
BUILD_PROFILE=ci task rust:build (automatically set in GitHub Actions)Profile Mapping:
BUILD_PROFILE=dev → CARGO_PROFILE_DIR=debugBUILD_PROFILE=release → CARGO_PROFILE_DIR=releaseBUILD_PROFILE=ci → CARGO_PROFILE_DIR=release (but with debug info)Usage Examples:
# Dev builds (fast, debug symbols)
BUILD_PROFILE=dev task rust:build
BUILD_PROFILE=dev task build:all
# Release builds (optimized)
BUILD_PROFILE=release task rust:build
task build:all:release
# CI builds (optimized + debug)
BUILD_PROFILE=ci task build:all
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
tools
______________________________________________________________________ ## 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