К основному содержанию
скилл CX Codex

makefile — скилл для Claude Code: что делает и как установить

Скилл для Claude Code помогает агенту создавать и поддерживать Makefile: правила, переменные, рецепты, проверки и сборку. Автоматизирует команды проекта.

MIT 181 установок ★ 23 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add itechmeat/llm-code --skill makefile -a claude-code
Открыть на GitHub

Что делает makefile

Скилл даёт агенту руководство по GNU Make: как описывать цели, зависимости и рецепты, выбирать тип присваивания переменных, применять автоматические переменные и разделять файловые и .PHONY-цели. В нём есть практические схемы для цели справки, определения платформы, каталога сборки, экспорта переменных, проверок качества, очистки и Docker-команд.

Материал также разбирает выполнение рецептов, параллельный запуск через make -j4, условные конструкции, подключение config.mk и .env, неявные правила и типичные ошибки. Критичная деталь: строки рецептов должны начинаться с символа TAB, иначе Makefile не выполнится. Для сложной shell-логики скилл советует выносить команды во внешний скрипт.

Какие задачи решает

  • создать Makefile с целями сборки и очистки
  • описать зависимости и рецепты GNU Make
  • добавить команды тестирования, линтинга и форматирования
  • настроить параллельный запуск задач
  • исправить ошибки с TAB, .PHONY и переменными

Примеры запросов агенту

  • Создай Makefile с целями help, test, lint, format и clean для этого проекта.
  • Проверь рецепты в Makefile: найди ошибки с TAB, .PHONY, cd и расширением переменных.
  • Добавь цель сборки Docker-образа с версией из git describe --tags --always.

Как установить makefile

1Через Skills CLI (Vercel)

npx skills add itechmeat/llm-code --skill makefile -a claude-code

2Вручную: положить файлы

~/.claude/skills/makefile/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/makefile/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о makefile

Как установить makefile в Claude Code?

Выполните npx skills add itechmeat/llm-code --skill makefile -a claude-code, затем проверьте файл ~/.claude/skills/makefile/SKILL.md.

Что делает скилл makefile?

Он помогает создавать и поддерживать Makefile для GNU Make: описывать цели, зависимости, переменные, рецепты и типовые команды сборки.

Почему рецепты Makefile требуют TAB?

Строки команд внутри рецепта должны начинаться с символа TAB. Пробелы вместо TAB приводят к ошибке разбора Makefile.

Исходный текст

SKILL.md · MIT
---
name: makefile
description: "GNU Make automation and build system guidance. Use when creating or maintaining Makefiles, writing Make targets and recipes, or configuring GNU Make build automation. Keywords: Makefile, GNU Make, targets, recipes, build automation."
metadata:
  version: "2.0.0"
  release_date: "2023-02-26"
---

# Makefile Skill

Guidance for creating and maintaining GNU Make build automation.

## Quick Navigation

| Topic                         | Reference                               |
| ----------------------------- | --------------------------------------- |
| Rules, prerequisites, targets | [syntax.md](references/syntax.md)       |
| Variable types and assignment | [variables.md](references/variables.md) |
| Built-in functions            | [functions.md](references/functions.md) |
| Special and phony targets     | [targets.md](references/targets.md)     |
| Recipe execution, parallel    | [recipes.md](references/recipes.md)     |
| Implicit and pattern rules    | [implicit.md](references/implicit.md)   |
| Common practical patterns     | [patterns.md](references/patterns.md)   |

---

## Core Concepts

### Rule Structure

```makefile
target: prerequisites
        recipe
```

**Critical:** Recipe lines MUST start with TAB character.

### File vs Phony Targets

```makefile
# File target - creates/updates a file
build/app.o: src/app.c
        $(CC) -c $< -o $@

# Phony target - action, not a file
.PHONY: clean test install

clean:
        rm -rf build/
```

### Variable Assignment

| Operator | Name        | When Expanded           |
| -------- | ----------- | ----------------------- |
| `:=`     | Simple      | Once, at definition     |
| `?=`     | Conditional | If not already set      |
| `=`      | Recursive   | Each use (late binding) |
| `+=`     | Append      | Adds to existing value  |

```makefile
CC := gcc              # Immediate
CFLAGS ?= -O2          # Default, overridable
DEBUG = $(VERBOSE)     # Late binding
CFLAGS += -Wall        # Append
```

### Automatic Variables

| Variable | Meaning                         |
| -------- | ------------------------------- |
| `$@`     | Target                          |
| `$<`     | First prerequisite              |
| `$^`     | All prerequisites (unique)      |
| `$?`     | Prerequisites newer than target |
| `$*`     | Stem in pattern rules           |

---

## Essential Patterns

### Self-Documenting Help

```makefile
.DEFAULT_GOAL := help

help: ## Show available targets
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | \
		awk 'BEGIN {FS = ":.*?## "}; {printf "  %-15s %s\n", $$1, $$2}'

install: ## Install dependencies
	uv sync

test: ## Run tests
	uv run pytest
```

### Platform Detection

```makefile
UNAME_S := $(shell uname -s)

ifeq ($(UNAME_S),Darwin)
    OPEN := open
else ifeq ($(UNAME_S),Linux)
    OPEN := xdg-open
endif
```

### Build Directory

```makefile
BUILDDIR := build
SOURCES := $(wildcard src/*.c)
OBJECTS := $(patsubst src/%.c,$(BUILDDIR)/%.o,$(SOURCES))

$(BUILDDIR)/%.o: src/%.c | $(BUILDDIR)
	$(CC) -c $< -o $@

$(BUILDDIR):
	mkdir -p $@
```

### Environment Export

```makefile
export PYTHONPATH := $(PWD)/src
export DATABASE_URL

test:
	pytest tests/  # sees exported variables
```

---

## Common Targets

### Quality Checks

```makefile
.PHONY: lint format check test

lint: ## Run linters
	ruff check .
	mypy src/

format: ## Format code
	ruff format .

check: format lint test ## All quality checks
```

### Cleanup

```makefile
.PHONY: clean clean-all

clean: ## Remove build artifacts
	rm -rf build/ dist/ *.egg-info
	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true

clean-all: clean ## Remove all generated files
	rm -rf .venv .pytest_cache .mypy_cache
```

### Docker Integration

```makefile
IMAGE := myapp
VERSION := $(shell git describe --tags --always)

docker-build: ## Build Docker image
	docker build -t $(IMAGE):$(VERSION) .

docker-run: ## Run container
	docker run -d -p 8000:8000 $(IMAGE):$(VERSION)
```

---

## Recipe Execution

### Each Line = Separate Shell

```makefile
# Won't work - cd lost between lines
bad:
	cd subdir
	pwd           # Still in original dir!

# Correct - combine commands
good:
	cd subdir && pwd

# Or use line continuation
also-good:
	cd subdir && \
	pwd && \
	make
```

### Silent and Error Handling

```makefile
target:
	@echo "@ suppresses command echo"
	-rm -f maybe.txt    # - ignores errors
```

### Parallel Execution

```bash
make -j4              # 4 parallel jobs
make -j4 lint test    # Run lint and test in parallel
```

---

## Output Discipline

**One line in, one line out.** Avoid echo spam.

```makefile
# ❌ Too chatty
start:
	@echo "Starting services..."
	docker compose up -d
	@echo "Waiting..."
	@sleep 3
	@echo "Done!"

# ✅ Concise
start: ## Start services
	@echo "Starting at http://localhost:8000 ..."
	@docker compose up -d
	@echo "Logs: docker compose logs -f"
```

---

## Conditionals

```makefile
DEBUG ?= 0

ifeq ($(DEBUG),1)
    CFLAGS += -g -O0
else
    CFLAGS += -O2
endif

ifdef CI
    TEST_FLAGS := --ci
endif
```

---

## Including Files

```makefile
# Required include (error if missing)
include config.mk

# Optional include (silent if missing)
-include local.mk
-include .env
```

---

## Common Pitfalls

| Pitfall               | Problem                                 | Solution                 |
| --------------------- | --------------------------------------- | ------------------------ |
| Spaces in recipes     | Recipes need TAB                        | Use actual TAB character |
| Missing .PHONY        | `make test` fails if `test` file exists | Declare `.PHONY: test`   |
| cd in recipes         | Each line is new shell                  | Use `cd dir && command`  |
| `=` vs `:=` confusion | Unexpected late expansion               | Use `:=` by default      |
| Unexported vars       | Subprocesses don't see vars             | `export VAR`             |
| Complex shell in make | Hard to maintain                        | Move to external script  |

---

## Quick Reference

```makefile
# Makefile Template
.DEFAULT_GOAL := help
SHELL := /bin/bash
.SHELLFLAGS := -ec

.PHONY: help install test lint format clean

help: ## Show this help
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | \
		awk 'BEGIN {FS = ":.*?## "}; {printf "  %-15s %s\n", $$1, $$2}'

install: ## Install dependencies
	uv sync --extra dev

test: ## Run tests
	uv run pytest tests/ -v

lint: ## Run linters
	uv run ruff check .

format: ## Format code
	uv run ruff format .

clean: ## Clean artifacts
	rm -rf build/ dist/ .pytest_cache
```

---

## Links

- [Documentation](https://www.gnu.org/software/make/manual/make.html)

## See Also

- [patterns.md](references/patterns.md) - Extended patterns and recipes

© itechmeat · MIT · itechmeat/llm-code

Похожие скиллы

Все скиллы по теме «Автоматизация и no-code: n8n, Zapier, Make» →
makefile-generator akin-ozer Скилл makefile-generator для Claude Code собирает Makefile для проектов на C/C++, Python, Go и Java, а также без привязки к языку, и проверяет его через makefile-validator. CX Codex +1 686установок makefile-validator akin-ozer Скилл makefile-validator прогоняет Makefile и .mk файлы через синтаксическую проверку, линтер и набор проверок безопасности, а потом отдаёт отчёт с кодом выхода. CX Codex +1 700установок make mohitmishra786 Скилл ведёт агента по идиоматичным Makefile: pattern-правила, автоотслеживание зависимостей, разбор ошибок make. CX Codex +1 752установок discovering-make-commands streamlit Скилл discovering-make-commands показывает ИИ-агенту доступные цели Makefile для сборки, линтинга и тестов в репозитории Streamlit. CX Codex +1 ★ 46 474звёзд репо debugging-toolkit-dx-optimizer Seth Hobson Субагент debugging-toolkit-dx-optimizer находит узкие места в процессах разработки и ускоряет онбординг до пяти минут. Помогает при старте новых репозиториев и автоматизации рутины. CX Codex ★ 42 780звёзд репо Makefile taste f Промпт Makefile taste для ChatGPT задаёт правила организации Makefile. Он помогает оформить цели, зависимости и команды так, чтобы Makefile служил входной точкой проекта. GP ChatGPT ★ 178 201звёзд репо

Из того же набора16

Весь набор →
base-ui Скилл обучает ИИ-ассистента собирать доступные UI-компоненты на базе @base-ui/react, настраивать оверлеи и работать с паттерном render prop. CX Codex +1 238установок refine-dev Скилл refine-dev по Refine: агент знает, как связать data provider, ресурсы и хуки, чтобы собрать админку на React поверх REST, GraphQL, Supabase или Strapi. CX Codex +1 210установок vitest Помогает писать и настраивать тесты Vitest: моки, снимки, покрытие и браузерный режим. Работает с Vite- и TypeScript-проектами. CX Codex +1 202установок changelog Скилл задаёт структуру CHANGELOG.md по Keep a Changelog 1.1.0: разделы Added/Changed/Fixed, заголовки версий, даты ISO 8601 и ссылки на сравнения. CX Codex +1 192установок commits Помогает агенту оформлять Git-коммиты по Conventional Commits с учётом breaking changes. Формат используют для changelog и SemVer. CX Codex +1 178установок skill-master Скилл skill-master для Claude и других агентов: помогает писать, проверять и сравнивать Agent Skills по спецификации agentskills.io — от структуры папок до замеров срабатывания. CX Codex +1 161установок openapi Скилл подсказывает ИИ-агенту структуру документов OpenAPI 3.x: обязательные поля, операции, схемы, параметры и безопасность. CX Codex +1 125установок project-creator Скилл project-creator разворачивает структуру технической документации в папке .project/ и ведёт интервью, по шагам создавая спецификации, архитектуру и пользовательские истории. CX Codex +1 113установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой