Skill

generating-makefile

Use when a project needs a root Makefile that delegates to Makefile.local and Makefile.deploy with a self-documenting help banner

npx claudepluginhub jugrajsingh/skillgarden --plugin makesmith

Tool Access

This skill is limited to using the following tools:

ReadWriteGlobBash(pwd)Bash(basename *)AskUserQuestion

Preview

Create a root Makefile that serves as the project entrypoint, delegating to Makefile.local (dev) and Makefile.deploy (ops).

Supporting Assets

references/root-makefile-template.makefile

SKILL.md

Similar Skills

design-system

167.4k

Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.

team-skills-platform

ui-demo

167.4k

Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.

team-skills-platform

kotlin-patterns

167.4k

Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.

team-skills-platform

Stats

Parent Repo Stars0

Parent Repo Forks0

Last CommitMar 26, 2026

Actions

View Source View Plugin View on GitHub View README

Generate Root Makefile

Create a root Makefile that serves as the project entrypoint, delegating to Makefile.local (dev) and Makefile.deploy (ops).

Philosophy

Root Makefile is the entrypoint - make help shows everything

Delegates to specialized files - Makefile.local, Makefile.deploy

Box-drawing help banner - Visual project identity

Project-specific targets - Quick-run commands for the app

Workflow

1. Detect Project Info

basename $(pwd)

2. Check Existing Files

Glob: Makefile, Makefile.local, Makefile.deploy

If Makefile exists, ask via AskUserQuestion:

"Merge targets" - Keep custom targets, add missing

"Overwrite" - Replace entirely

"Skip" - Don't modify

3. Generate Root Makefile

Read references/root-makefile-template.makefile and customize:

Replace {PROJECT_NAME} with detected project name

Adjust box-drawing banner width to fit project name

If no Makefile.deploy exists, remove Deployment section targets

If no Makefile.local exists, remove Development section targets

4. Report

Created root Makefile: Delegates to: Makefile.local - Development targets Makefile.deploy - Deployment targets Quick targets: make install -> make -f Makefile.local install-dev make test -> make -f Makefile.local test make lint -> make -f Makefile.local lint make build -> make -f Makefile.deploy build-image make deploy -> make -f Makefile.deploy deploy make ship -> build + push + deploy Usage: make help # Show all targets make # Same as make help

Customization

Users should add project-specific targets to the "Quick Run" section:

run-api: ## Run API server $(MAKE) -f Makefile.local run-api run-worker: ## Run background worker $(MAKE) -f Makefile.local run-worker

Generate Root Makefile

Create a root Makefile that serves as the project entrypoint, delegating to Makefile.local (dev) and Makefile.deploy (ops).

Philosophy

Root Makefile is the entrypoint - make help shows everything
Delegates to specialized files - Makefile.local, Makefile.deploy
Box-drawing help banner - Visual project identity
Project-specific targets - Quick-run commands for the app

Workflow

1. Detect Project Info

basename $(pwd)

2. Check Existing Files

Glob: Makefile, Makefile.local, Makefile.deploy

If Makefile exists, ask via AskUserQuestion:

"Merge targets" - Keep custom targets, add missing
"Overwrite" - Replace entirely
"Skip" - Don't modify

3. Generate Root Makefile

Read references/root-makefile-template.makefile and customize:

Replace {PROJECT_NAME} with detected project name
Adjust box-drawing banner width to fit project name
If no Makefile.deploy exists, remove Deployment section targets
If no Makefile.local exists, remove Development section targets

4. Report

Created root Makefile:

Delegates to:
  Makefile.local  - Development targets
  Makefile.deploy - Deployment targets

Quick targets:
  make install    -> make -f Makefile.local install-dev
  make test       -> make -f Makefile.local test
  make lint       -> make -f Makefile.local lint
  make build      -> make -f Makefile.deploy build-image
  make deploy     -> make -f Makefile.deploy deploy
  make ship       -> build + push + deploy

Usage:
  make help       # Show all targets
  make            # Same as make help

Customization

Users should add project-specific targets to the "Quick Run" section:

run-api:  ## Run API server
 $(MAKE) -f Makefile.local run-api

run-worker:  ## Run background worker
 $(MAKE) -f Makefile.local run-worker