makefile-generation

athola's avatarfrom athola

Generate language-specific Makefile with common development targets

⭐83stars🔀11forks📁View on GitHub🕐Updated Jan 3, 2026

When & Why to Use This Skill

The Makefile Generation skill automates the creation of standardized, language-specific Makefiles for Python, Rust, and TypeScript projects. By detecting the project environment and applying best-practice templates, it provides a consistent interface for common development tasks like linting, testing, and building, significantly reducing manual configuration time and improving workflow consistency.

Use Cases

  • New Project Bootstrapping: Automatically generate a comprehensive Makefile immediately after project initialization to establish a professional build and test environment.
  • Workflow Standardization: Implement uniform command structures across multiple repositories, allowing team members to use familiar commands like 'make test' or 'make build' regardless of the underlying programming language.
  • Legacy Project Modernization: Quickly add modern development targets (such as 'uv' for Python or 'clippy' for Rust) to existing projects that lack a structured build automation system.
  • CI/CD Pipeline Integration: Use the generated Makefiles as a stable entry point for CI/CD scripts, ensuring that local development commands match the automated build environment.
namemakefile-generation
descriptionGenerate language-specific Makefile with common development targets
Triggerslanguage-specific, makefile, development, targets, generation
modelclaude-sonnet-4
tools[Read, Write, Bash]

Table of Contents

Makefile Generation Skill

Generate a Makefile with standard development targets for Python, Rust, or TypeScript projects.

Use When

  • Need a Makefile for a project without one
  • Want to update Makefile with new targets
  • Standardizing build automation across projects

Standard Targets

Python Makefile

Common targets:

  • help - Show available targets
  • install - Install dependencies with uv
  • lint - Run ruff linting
  • format - Format code with ruff
  • typecheck - Run mypy type checking
  • test - Run pytest
  • test-coverage - Run tests with coverage report
  • check-all - Run all quality checks
  • clean - Remove generated files and caches
  • build - Build distribution packages
  • publish - Publish to PyPI

Rust Makefile

Common targets:

  • help - Show available targets
  • fmt - Format with rustfmt
  • lint - Run clippy
  • check - Cargo check
  • test - Run tests
  • build - Build release binary
  • clean - Clean build artifacts

TypeScript Makefile

Common targets:

  • help - Show available targets
  • install - Install npm dependencies
  • lint - Run ESLint
  • format - Format with Prettier
  • typecheck - Run tsc type checking
  • test - Run Jest tests
  • build - Build for production
  • dev - Start development server

Workflow

1. Detect Language

# Check for language indicators
if [ -f "pyproject.toml" ]; then
    LANGUAGE="python"
elif [ -f "Cargo.toml" ]; then
    LANGUAGE="rust"
elif [ -f "package.json" ]; then
    LANGUAGE="typescript"
fi

Verification: Run the command with --help flag to verify availability.

2. Load Template

from pathlib import Path

template_path = Path("plugins/attune/templates") / language / "Makefile.template"

Verification: Run the command with --help flag to verify availability.

3. Collect Project Info

metadata = {
    "PROJECT_NAME": "my-project",
    "PROJECT_MODULE": "my_project",
    "PYTHON_VERSION": "3.10",
}

Verification: Run the command with --help flag to verify availability.

4. Render Template

from template_engine import TemplateEngine

engine = TemplateEngine(metadata)
engine.render_file(template_path, Path("Makefile"))

Verification: Run the command with --help flag to verify availability.

5. Verify

make help

Verification: Run make --dry-run to verify build configuration.

Customization

Users can add custom targets after the generated ones:

# ============================================================================
# CUSTOM TARGETS
# ============================================================================

deploy: build ## Deploy to production
	./scripts/deploy.sh

Verification: Run the command with --help flag to verify availability.

  • Skill(attune:project-init) - Full project initialization
  • Skill(abstract:makefile-dogfooder) - Makefile testing and validation

Troubleshooting

Common Issues

Command not found Ensure all dependencies are installed and in PATH

Permission errors Check file permissions and run with appropriate privileges

Unexpected behavior Enable verbose logging with --verbose flag