review-makefile

Review Makefiles for anti-patterns and improvement opportunities.

1|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/datastx/Feather-Flow --skill review-makefile
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-makefile
Source: https://github.com/datastx/Feather-Flow/tree/main/.claude/skills/review-makefile
Command: npx skills add https://github.com/datastx/Feather-Flow --skill review-makefile

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams enforce Makefile best practices, making builds more maintainable, readable, and less error-prone by systematically reviewing common patterns and anti-patterns.

Core Features & Use Cases

  • Self-documenting help: Ensure targets include descriptive, auto-generated help text.
  • Safety & prologue checks: Verify prologue safety settings and consistent shell behavior.
  • PHONY declarations: Validate explicit PHONY targets and avoid accidental clashes with files.
  • Pattern consistency: Promote idiomatic variable usage, tab indentation, and clear organization.
  • Code reviews & refactoring: Provide guidance when reviewing or rewriting Makefiles in CI or PR reviews.

Quick Start

Run a Makefile review across your repository to surface maintainability issues and recommended improvements.

Frequently Asked Questions about review-makefile

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

FAQPage Schema
How do I check a Makefile for best practices and unsafe patterns?

To check a Makefile for best practices, review prologue safety settings, PHONY declarations, and variable conventions to identify anti-patterns and ensure clean, safe, maintainable builds across your repository.

How do I enforce PHONY declarations in a Makefile?

Enforce PHONY declarations by validating explicit target definitions to avoid accidental clashes with files, ensuring automated build safety and preventing Make from skipping tasks when same-named files exist.

What is a self-documenting Makefile help target?

A self-documenting Makefile help target auto-generates descriptive help text for build targets, improving readability and maintainability by ensuring developers understand available commands without manual documentation overhead.

Can I use a Makefile review for CI and PR code reviews?

Yes, you can use Makefile review for CI and PR code reviews to surface maintainability issues, enforce idiomatic variable usage, and provide refactoring guidance for build automation files.

What is the best way to organize sections and variables in a Makefile?

The best way to organize Makefile sections and variables is by promoting idiomatic variable usage, consistent tab indentation, and clear structural organization to maximize readability and maintainability.