.remote-cache/kreuzberg-shared-rules/.ai-rulez/skills/agent-selection-usage-guidelines/SKILL.md
______________________________________________________________________ ## priority: critical # Agent Selection & Usage Guidelines **When to use agents**: Use the Task tool to spawn specialized agents for focused, language-specific work. Agents provide domain expertise and follow language-specific conventions. **Agent selection rules**: - **Rust core work** → rust-core-engineer (core library, extraction logic, plugins) - **Python bindings** → python-bindings-engineer (PyO3 FFI, Python wrappe
npx skillsauth add kreuzberg-dev/html-to-markdown .remote-cache/kreuzberg-shared-rules/.ai-rulez/skills/agent-selection-usage-guidelinesInstall 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.
When to use agents: Use the Task tool to spawn specialized agents for focused, language-specific work. Agents provide domain expertise and follow language-specific conventions.
Agent selection rules:
Multi-language tasks: If work spans multiple languages (e.g., Rust core + bindings), spawn multiple agents in parallel when possible.
Performance: All implementation agents use haiku (fast, cost-effective). Only polyglot-architect uses sonnet for strategic planning.
Agent coordination: Rust-first principle - core logic goes in rust-core-engineer first, then binding engineers expose through language-idiomatic APIs. Binding engineers should coordinate with rust-core-engineer for shared logic.
When NOT to use agents: Simple edits, single-file changes, or tasks you can complete directly without specialized domain knowledge.
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