nghyane/luma / .agents/skills/cross-platform
cross-platform
VerifiedGuidelines for writing platform-specific code in Luma. Use when adding or modifying code that behaves differently on Unix vs Windows, including shell commands, file paths, process spawning, or platform-specific tests.
Cross-Platform Code in Luma
Compile-time selection
Prefer compile-time platform selection over runtime branching:
// Preferred
#[cfg(unix)]
fn shell_command() -> &'static str { "sh" }
#[cfg(windows)]
fn shell_command() -> &'static str { "cmd" }
// Avoid
fn shell_command() -> &'static str {
if cfg!(windows) { "cmd" } else { "sh" }
}
Use #[cfg(unix)], #[cfg(windows)], or module-level #[cfg(...)] attributes.
Module layout
Platform-specific code lives in separate files:
src/tool/shell/
mod.rs ← public API, platform-agnostic
unix.rs ← #[cfg(unix)]
windows.rs ← #[cfg(windows)]
The parent module exposes a single unified API. Callers never import platform modules directly.
Tests
Guard platform-specific tests at compile time:
#[cfg(test)]
mod tests {
#[cfg(unix)]
#[test]
fn unix_specific_behavior() { ... }
#[cfg(windows)]
#[test]
fn windows_specific_behavior() { ... }
}
Do not duplicate test logic when expectations can be shared across platforms.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |