makefile-generator_skill

Overview

This skill generates production-ready Makefiles following modern GNU Make conventions and language-specific patterns for C/C++, Go, Python, and Java. It produces secure, maintainable build scripts with standard targets (all, build, test, install, clean, help), sensible defaults, and hooks for CI/CD and Docker integration. Use it to create new Makefiles or convert ad-hoc build steps into a reproducible build system.

How this skill works

The skill collects project requirements (language, structure, sources, outputs, install paths, targets, toolchain and flags) and applies vetted Makefile patterns to generate a complete Makefile. It emits a modern GNU Make header, language-specific rules, standard variables, and documented targets, then validates and formats the output to meet production standards. When input is missing or ambiguous, the skill asks targeted questions to gather necessary details.

When to use it

• Creating a new Makefile from scratch
• Setting up build automation for C/C++, Go, Python, or Java projects
• Converting manual build steps into a repeatable Makefile
• Adding standard targets for CI/CD or Docker workflows
• When the user explicitly asks to "create", "generate", or "write" a Makefile

Best practices

• Ask required clarifying questions for language, project layout, install paths, and multi-binary decisions before generating
• Prefer the modern GNU Make header (.ONESHELL, SHELLFLAGS, .DELETE_ON_ERROR) for robust error handling
• Expose user-overridable variables (CC, CFLAGS, PREFIX) with ?= and keep project constants with :=
• Generate dependency-aware compilation rules (e.g., -MMD -MP for C/C++ and -include for .d files)
• Include .PHONY targets and install/uninstall safety checks; mark Docker targets .NOTPARALLEL if used

Example use cases

• Generate a Makefile for a single-directory C library with build, test, install, and packaging targets
• Create a Go project Makefile that builds a CLI binary and embeds version info via ldflags
• Produce a Python project Makefile that supports build, develop (editable install), and test targets for CI
• Create Java compile rules for mixed-source layouts with a build directory and classpath handling
• Add Docker build/push targets with serialized dependencies and push error handling