코딩 에이전트 스킬 113개, MCP로 꽂는다

코딩 에이전트용 스킬 113개를 묶은 오픈소스 라이브러리가 공개됐다. 이름은 코딩 에이전트 스킬 KG(Coding Agent Skills KG), 개발자는 mmccalla이고 아파치 2.0 라이선스로 배포된다. 이식 가능한 스킬 묶음이 본체이고, 여기에 선택 사항으로 로컬 네오4j(Neo4j) 기반 그래프RAG 서비스가 MCP·API·UI 형태로 붙는 구조다.

무슨 일인가 / 배경

스킬은 에이전트가 상황에 맞게 꺼내 쓰는 절차서다. 이 저장소에서는 SKILL.md라는 파일 하나가 하나의 운영 절차(operating procedure)에 대응한다. 여기까지는 익숙한 개념인데, 스킬이 100개를 넘어가면 새로운 문제가 생긴다. 무엇을 만들 것인가가 아니라 무엇을 언제 꺼낼 것인가가 병목이 된다. 스킬을 전부 컨텍스트에 밀어넣으면 토큰이 폭발하고, 아무것도 안 꺼내면 있으나 마나다.

이 프로젝트의 답은 스킬을 지식 그래프에 얹고 검색으로 라우팅하는 것이다. 저장소는 목적별 진입점을 표로 정리해 둘 만큼 이 부분에 공을 들였다. 에이전트에게 스킬을 쓰게 하려면 AGENTS.md에서 시작해 apply-laws-of-ai 스킬을 거쳐 HOW_TO_FIND_THE_RIGHT_SKILL.md를 읽으라고 안내한다. AGENTS.md가 규정하는 필수 시작 순서도 명확하다. 안전 관련 파일을 먼저 읽고, apply-laws-of-ai를 적용하고, 라우팅한 뒤, 가장 작은 SKILL.md 집합만 꺼낸다.

핵심 짚어보기

저장소 구성은 역할별로 갈려 있다. skills/에 이식 가능한 본체인 SKILL.md들이 있고, skills_docs/에 라우팅·런북·KRAG 계약·온톨로지가, schemas/에 온톨로지와 네오4j 스키마 원본 포인터가, scripts/에 graph·runtime·lib·validators 도메인 패키지가, skills-ui/에 점검과 에이전트 워크플로용 UI가 들어 있다. docker-compose.yml에는 네오4j, API, UI에 더해 프로메테우스(Prometheus)와 그라파나(Grafana)까지 묶여 있다.

로컬 실행은 cp .env.example .env 후 docker compose up --build -d 두 줄이다. 검증 경로는 좀 더 촘촘하다. python3 -m pip install -e ".[dev]"로 개발 의존성을 깔고, ./scripts/dev_workflow/install_git_hooks.sh로 훅을 설치하면 커밋할 때마다 시크릿 검사, markdownlint, validators, ruff, mypy, pytest가 자동으로 돈다. ./scripts/dev_workflow/ci_local.sh로 로컬 CI도 돌릴 수 있다. 문서도 용도별로 나뉘어 있어 커서를 MCP로 붙일지 파일시스템으로 붙일지는 CURSOR_IDE_SETUP.md, 다른 저장소로 스킬만 복사하려면 DROP_IN_BOOTSTRAP.md, 검색 품질 측정치는 skills_docs/krag/EVALUATION.md를 보라고 안내한다. 보안 문서만 세 종(AGENTIC_CODING_GLOBAL_SAFETY.md, SECURE_AGENTIC_DEVELOPMENT.md, SECURITY_HARDENING.md)이다. 커밋 97개, 스타 4개이며 템플릿 저장소로 공개됐다.

1인기업 실전 적용 포인트

• 반복 업무 하나가 스킬 하나다. 새 프레임워크를 배울 필요가 없다는 게 이 형식의 장점이다. 이미 머릿속이나 메모장에 있는 절차(예: 매주 하는 정산 정리, 고객 온보딩 순서)를 SKILL.md 형식의 마크다운으로 옮기는 것부터가 시작이다.
• DROP_IN_BOOTSTRAP 경로로 가볍게 시작하라. 스킬 파일을 내 저장소로 복사하는 방식이다. 네오4j와 그래프RAG는 스킬이 수십 개를 넘어 라우팅이 흔들릴 때 고민할 문제이지, 첫날부터 띄울 스택이 아니다.
• pre-commit 훅 구성을 그대로 훔쳐라. 시크릿 검사·ruff·mypy·pytest를 커밋 시점에 강제하는 설정은 이 프로젝트에서 가장 즉시 써먹을 수 있는 부분이다. 1인기업에는 리뷰어가 없으니 이 게이트가 리뷰어 역할을 한다. 에이전트가 쓴 코드의 최저 품질선을 사람 없이 지키는 장치다.
• 113개를 다 켜지 마라. 최소 집합만 꺼내는 게 이 프로젝트가 말하는 요지다. 스킬을 많이 가진 에이전트가 아니라 정확히 꺼내는 에이전트가 좋은 에이전트다.

전망 / 주의점

스타 4개의 템플릿 저장소이므로 검증된 표준으로 볼 단계는 아니다. 113개라는 숫자 역시 품질의 근거가 아니다. 스킬은 개수가 아니라 내 업무와의 적합도로 값이 매겨지고, 남이 만든 절차서 100개보다 내 손에 맞는 5개가 낫다. EVALUATION.md의 검색 품질 수치도 자체 측정치라는 점을 감안해야 한다.

네오4j에 프로메테우스와 그라파나까지 얹은 스택은 1인기업 환경에서 과할 수 있다. 관측 도구를 띄우는 순간 그 도구를 돌보는 일이 새 업무로 생긴다. 그럼에도 이 프로젝트가 가리키는 방향은 참고할 가치가 있다. 스킬을 파일 더미가 아니라 검색 가능한 서비스로 다루기 시작했다는 것이다. 에이전트에게 무엇을 시킬지 아는 것만큼, 아는 것을 어떻게 꺼내 줄지가 다음 단계의 실력이 된다.

출처: 깃허브·해커뉴스(Hacker News) (https://github.com/mmccalla/coding-agent-skill-library)