hammer-build-validate

Automate SDL3 HammerEngine build validation with Debug builds, smoke tests, and reports.

14|2|Updated Mar 24, 2025
One-click install
npx skills add https://github.com/Ronin15/SDL3_HammerEngine_Template --skill hammer-build-validate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hammer-build-validate
Source: https://github.com/Ronin15/SDL3_HammerEngine_Template/tree/main/.claude/skills/hammer-build-validate
Command: npx skills add https://github.com/Ronin15/SDL3_HammerEngine_Template --skill hammer-build-validate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires cmake, ninja, timeout.

What problem does it solve?

Developers frequently need to verify their changes haven't broken the build or introduced crashes, a repetitive manual process that consumes valuable development time and can lead to unstable development environments.

Core Features & Use Cases

  • Clean Debug Build: Performs a full debug build, detecting and categorizing compilation warnings and errors to ensure a clean codebase.
  • Smoke Test for Crash Detection: Runs the application briefly to catch immediate crashes, segmentation faults, assertion failures, or critical SDL errors.
  • Core Test Suite Execution: Runs essential functional tests to ensure core systems are still working as expected after recent changes.
  • Summary Report: Generates a concise report detailing build status, warning counts, and test results, providing a quick overview of codebase health.
  • Use Case: After making a series of changes, run a "build validation pipeline" to quickly confirm that the codebase compiles cleanly, the application doesn't crash on startup, and core functionalities remain intact, ensuring a stable development environment.

Quick Start

Run the complete build validation pipeline for the HammerEngine.

Frequently Asked Questions about hammer-build-validate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate a build and catch crashes before submitting code?

Build validation automates compilation checks, crash detection, and test execution to verify your changes don't break the codebase. This Skill runs a debug build, smoke tests for crashes, core tests, and generates a summary report at /tmp/hammer_build_validation_report.md, catching issues before PR submission.

Can I detect crashes and segmentation faults during smoke testing?

Yes, smoke testing runs the application briefly to catch immediate crashes, segmentation faults, assertion failures, and critical SDL errors that occur on startup, ensuring the build is crash-free before proceeding to full testing.

What dependencies do I need to run build validation on HammerEngine?

Build validation requires cmake for compilation, ninja for parallel builds, and timeout to manage process execution. These tools orchestrate the complete validation pipeline from clean build through test execution.

How do I know if compilation warnings are blocking my build?

The validation pipeline detects and categorizes compilation warnings and errors during the debug build phase, providing a clean codebase assessment. Warnings are counted and included in the summary report so you can address them before integration.

Can I use build validation as part of my daily CI/CD workflow?

Yes, build validation applies to daily validation workflows and pre-PR checks. The complete pipeline—clean build, crash-free smoke testing, core test suite, and structured reporting—fits into automated CI/CD pipelines for continuous codebase health monitoring.