SKILL.make: Makefile 스타일의 Skill 파일
발행: (2026년 5월 2일 PM 05:18 GMT+9)
5 분 소요
원문: Hacker News
Source: Hacker News
SKILL.make: Makefile 스타일 스킬 파일
Makefile‑스타일 에이전트 스킬에 대한 사양 및 참조 구현.
이것은 무엇인가?
SKILL.make는 Makefile의 선언적이며 의존성‑기반 패러다임을 Agent Skills 형식에 도입합니다. 모호한 문장을 구조화된 논리로 대체하여 SKILL.md를 재현 가능한 실행 그래프로 변환합니다.
왜 Makefile 스타일의 SKILL 파일인가?
- 토큰 효율성 – 최적화된 구문은 SKILL 파일 크기를 약 15 % 줄여 비용과 컨텍스트‑윈도우 공간을 절감합니다. 수동 최적화를 통해 컨텍스트 크기를 30 % 이상 줄일 수 있습니다.
- 의존성 해결 – 하네스가 DAG(Directed Acyclic Graph)를 자동으로 해결합니다. 이제 LLM이 다음 논리적 단계를 “추측”하도록 의존하지 않아도 됩니다. Target : Dependency + Recipe 모델을 사용해 에이전트가 단계를 건너뛰지 않고 엄격한 실행 순서를 따르도록 합니다.
- 높은 구성 가능성 – 서로 다른 파일의 타깃을 호출하여 스킬을 모듈화합니다—전문 빌드 시스템처럼.
- 감사 가능성 및 진화 – 감사 가능하고 진화 가능한 SKILL 구현을 위한 기반을 마련합니다.
규칙 정의
| Prefix | Type | Description |
|---|---|---|
VAR = val | Variable | 반복을 줄이기 위해 상수를 정의합니다. |
@ cmd | Shell | 실행을 위한 직접적인 명령줄 지시입니다. |
$ tool | Invocable | 에이전트가 정의한 도구/함수를 명시적으로 호출합니다. |
? prompt | Reasoning | 에이전트가 행동을 결정하는 자유 형식 프롬프트입니다. |
ifeq | Logic | 상태 또는 환경 변수에 기반한 조건 분기입니다. |
multi-line string | Code snippet | Makefile 구문에서 다중 행 문자열을 사용하여 코드 스니펫을 정의합니다. |
간단한 예시
아래는 SKILL.make 형식으로 작성된 일반적인 코드‑리뷰 스킬입니다:
# Variables
CODE_DIR = src/
# Target: review — run a full code review
review: lint test summary
lint:
@ cd $(CODE_DIR) && eslint . --format json
test:
@ cd $(CODE_DIR) && npm test
summary: lint test
? Based on lint errors and test failures, write a review summary.추가 정보도 괜찮습니다.
포맷 비교
우리는 잘 알려진 “실제 엔지니어를 위한 SKILL” 컬렉션 전체를 Makefile 포맷으로 테스트했습니다. 이는 논리 구조와 가독성을 향상시키며, SKILL.make 파일은 감사(깃 추적, 호출 통계)에 적합하고 Evolution Engineering을 위한 견고한 기반을 마련합니다.
convert.sh를 사용하여 이 변환을 재현할 수 있습니다. 비교 통계는 다음과 같습니다:
| File | SKILL.md | SKILL.make | Change |
|---|---|---|---|
| caveman | 1916 | 1714 | -10% |
| design‑an‑interface | 3366 | 2789 | -17% |
| domain‑model | 3512 | 3376 | -3% |
| edit‑article | 721 | 692 | -4% |
| git‑guardrails‑claude‑code | 2312 | 1861 | -19% |
| github‑triage | 10089 | 8697 | -13% |
| improve‑codebase‑architecture | 5509 | 4913 | -10% |
| migrate‑to‑shoehorn | 2795 | 1328 | -52% |
| obsidian‑vault | 1511 | 1233 | -18% |
| qa | 4965 | 4781 | -3% |
| request‑refactor‑plan | 2711 | 2626 | -3% |
| scaffold‑exercises | 3589 | 2744 | -23% |
| setup‑pre‑commit | 2261 | 1703 | -24% |
| tdd | 4211 | 3212 | -23% |
| to‑issues | 2737 | 2027 | -25% |
| to‑prd | 2460 | 2092 | -14% |
| triage‑issue | 3783 | 3160 | -16% |
| ubiquitous‑language | 4890 | 4560 | -6% |
| write‑a‑skill | 3056 | 2879 | -5% |
| TOTAL | 66394 | 56387 | -15% |
상태
이것은 개념 증명 사양입니다. 대부분의 Agent Harness 구현과 호환되도록 설계되었습니다.