AI 코딩 에이전트에게 '작업 매뉴얼'을 쥐여주는 레포

ok-skills — 다음 달 급부상할 것 같은 217스타의 조용한 레포

Claude Code를 처음 켜고 아무 지시 없이 코드를 맡겼을 때, 에이전트가 엉뚱한 방향으로 파일을 수정해서 30분을 날린 경험, 한 번쯤 있지 않은가.

Setting

요즘 AI 코딩 에이전트(Codex, Claude Code, Cursor 같이 코드를 대신 짜주는 AI 도구들)가 빠르게 보급되고 있다. 문제는 '도구가 있다'는 것과 '도구가 제대로 일한다'는 것 사이에 큰 간극이 있다는 점이다. 사람도 첫날 출근하면 팀의 코딩 규칙, 폴더 구조, 금지 사항을 누군가 알려줘야 제대로 일한다. AI 에이전트도 마찬가지다. mxyhi/ok-skills는 바로 그 '온보딩 매뉴얼'을 AI 에이전트용으로 정리해둔 레포다. 스타 217개, 마지막 업데이트 2025년 4월 — 아직 조용하지만 타이밍이 심상치 않다.

The Story

이 레포의 핵심은 두 가지다. SKILL.md 파일과 AGENTS.md 플레이북(playbook, 체계적인 작업 지침서). SKILL.md는 에이전트에게 '이 프로젝트에서는 이렇게 행동해라'를 사전에 알려주는 설정 파일이고, AGENTS.md는 반복 작업을 자동화할 때 쓰는 시나리오 모음이다.

예를 들어, Claude Code로 풀스택 프로젝트를 관리할 때 이 레포의 플레이북을 복사해 붙여넣으면 에이전트가 "테스트 먼저 작성 → 구현 → 커밋 메시지는 영어로" 같은 팀 규칙을 자동으로 따른다. 설정 없이 쓸 때 에이전트가 임의로 파일을 건드리던 상황과 비교하면 체감 차이가 크다. C# 기반으로 구현되어 있지만, 플레이북 자체는 텍스트 파일 형태라 어떤 언어 프로젝트에도 그대로 가져다 쓸 수 있다.

The Insight

내 예측을 솔직히 말하자면, 'AI 에이전트 표준화' 논의가 본격화되는 시점에 이 레포는 빠르게 레퍼런스가 될 가능성이 높다. 근거는 세 가지다. 첫째, Anthropic의 Claude Code와 OpenAI의 Codex가 동시에 기업용으로 밀리고 있고, 팀 단위 사용이 늘수록 '에이전트 행동 규칙 통일' 수요가 폭발한다. 둘째, GitHub 토픽 태그에 agents-md와 codex-skills가 함께 붙어 있다는 건 두 생태계를 동시에 겨냥했다는 신호다. 셋째, SKILL.md라는 포맷 자체가 아직 표준이 없는 상태 — 이 레포가 사실상 그 초안을 만들고 있다. 물론 틀릴 수 있다. 하지만 "에이전트 행동을 파일 하나로 정의한다"는 발상은 어떤 도구가 이기든 결국 필요해질 방향이다.

트렌드는 터지기 직전이 가장 조용하다. 이 레포가 그 시점에 있는 것 같다. 다음 달 기술 지도가 어떻게 바뀌는지 함께 지켜보려면 teum.io/stories를 팔로우해두길.

트렌드는 터지기 직전이 가장 조용하다. 이 레포가 그 시점에 있는 것 같다.