How does this skill improve my Rust project structure?

It provides a standardized framework for organizing modules and using re-exports to create a clean, discoverable public API surface that reads like a user guide.

Does this handle internal vs. public visibility?

Yes, it provides specific guidance on using pub(crate) and private modules to protect implementation details while exposing only stable types.

Can it help with breaking change detection?

It integrates best practices for using tools like cargo-public-api to track and prevent unintended changes to your library's public interface during development.

Is it suitable for complex Rust projects?

Absolutely, the hierarchical patterns, feature-gate strategies, and module re-export patterns are designed to scale with large-scale libraries and multi-crate workspaces.

Rust Module & API Architect

Name: Rust Module & API Architect
Author: kreuzberg-dev

bykreuzberg-dev

•

480

API Development

Enforces best practices for Rust crate structure, module visibility, and stable public API design.

About

This skill provides domain-specific expertise to organize Rust projects using professional module hierarchies and robust public API patterns. It guides developers in separating internal implementation details from stable interfaces using explicit visibility controls, strategic re-exports in lib.rs, and Cargo feature gates. Ideal for library authors and system architects, it helps prevent breaking changes through API validation workflows and promotes documentation standards that ensure libraries are both intuitive and maintainable.

Key Features

Strategic re-exports for clean, guide-like API surfaces
Conditional compilation and API surface management with Cargo feature gates
Hierarchical module organization (internal vs. public boundaries)
Visibility control using pub(crate) and pub(super) keywords
480 GitHub stars
Public API stability tracking and breaking change validation

Use Cases

Designing a new Rust library with a clean, user-friendly entry point
Refactoring a messy crate into a logical module structure while maintaining compatibility
Implementing strict visibility boundaries to hide internal implementation details

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kreuzberg-dev/html-to-markdown rust-module-organization-public-api-design

For use in Claude.ai and ChatGPT

Download Skill

GitHub