AI 코딩 도구가 발전하면서 에이전트 스킬 규격이 코딩 자동화에서 전문 도메인 지식 쪽으로 넓어지고 있다. 프롬프트와 지침을 다루는 영역에서는 결정론적 연산 엔진과 LLM의 맥락 해석을 나누는 구조가 주된 아키텍처로 자리 잡는 중이다. 개발자들은 이 설계로 환각을 크게 줄이면서 여러 사상과 규칙 체계를 에이전트에 옮겨 심는 시도를 이어가고 있다.

코딩을 넘어 도메인 지식으로 확장하는 에이전트 스킬

AI 코딩 도구들은 SKILL.md 파일을 중심으로 지침, 스크립트, 참조 문서를 한데 묶는 에이전트 스킬 규격을 채택했다. 에이전트가 설치된 전체 스킬 목록에서 이름과 설명만 모으는 Level 1 단계에서는 약 100 토큰 안팎을 쓰고, 스킬이 호출되는 Level 2 단계에서 본문 지시사항을 불러올 때는 약 5,000 토큰 이하의 컨텍스트를 쓴다. 규격이 이렇게 가벼워서 스킬을 많이 설치해도 컨텍스트 부담이 크지 않다.

지금 에이전트 스킬은 CI/CD 구축이나 코드 리뷰 같은 개발 업무 자동화에만 머물지 않는다. 여러 도메인 지식을 에이전트에 직접 넣는 지식 전달 수단으로 쓰임새가 넓어지고 있다. 오픈소스 커뮤니티 추산으로는 GitHub에 올라온 오픈소스 Skill이 이미 10만 개를 넘으며 빠르게 늘고 있다.

에이전트 스킬 규격이 단순 코딩 자동화를 넘어 도메인 지식 체계와 통합되며 관련 생태계가 빠르게 확대되고 있다.

연산과 해석을 분리해 환각을 방지하는 MCP 구조

동양 전통 역학은 절기, 진태양시, 간지처럼 아주 정밀한 천문·역법 계산이 필요하다. 이런 계산을 일반 대형 언어 모델(LLM)에 그대로 맡기면 고질적인 수치 계산 환각이 생길 위험이 크다. 그래서 정밀 연산 로직은 로컬 스크립트나 모델 컨텍스트 프로토콜(MCP) 서버로 완전히 넘겨 결정론적으로 처리하고, LLM은 그 결과를 받아 맥락 해석과 상담만 맡는 역할 분리 구조를 쓴다.

예를 들어 사주명리학에서 시주를 계산할 때는 12지지를 2시간 간격으로 나누는 것을 기본으로 천간과 지지를 배정한다. 이렇게 정밀해야 하는 규칙과 수치는 MCP가 책임지므로, LLM은 넘겨받은 명반 구조와 파라미터를 바탕으로 환각 없이 문맥 해석에만 집중할 수 있다.

정밀 연산이 필요한 전통 역학 체계는 로컬 스크립트나 MCP 서버가 처리하고 LLM은 결과를 바탕으로 해석을 맡는다.

한국형 생활 및 업무 스킬을 집약한 K-Skill 저장소

NomaDamas/k-skill 저장소는 AI 에이전트에 한국 생활 환경과 한국식 작업 지침을 넣어 주는 한국 맞춤형 스킬 모음이다. 개발자 커뮤니티의 반응도 좋아서 OSSInsight 데이터 기준 스타 7,456개와 포크 905개, 프로필 기준으로는 스타 7,595개와 포크 923개를 기록하고 있다.

패키지에는 한국인 사용 환경에 맞춘 여러 작업 지침이 들어 있고, 사주 운세(saju-fortune)와 작명(naming-house) 스킬도 함께 묶여 있다. 전체 패키지를 설치하면 에이전트에 단위 스킬 44개가 한꺼번에 등록되어 업무와 생활 영역에서 바로 쓸 수 있다.

K-Skill 저장소는 한국인 사용 환경에 맞춘 44개 단위 스킬을 제공하며 많은 개발자 커뮤니티의 호응을 얻고 있다.

불교 인식론 원칙을 응용한 AI 작업 규율 설계

nai0om/buddhist-method 프로젝트는 불교의 인식론 원리를 AI의 디버깅과 작업 규율로 정리한 스킬이다. LLM이 코드 작업 중에 내는 오류와 환각을 줄이기 위해 근본 원인 분석과 심리적 안정을 꾀하는 6개 원칙을 작업 지침으로 준다.

GitHub에는 전통 사상과 형이상학 체계를 응용한 오픈소스 프로젝트가 꾸준히 올라오고 있다. 금강경이나 대장경 같은 원전에 기반한 RAG 기술과 윤리적 경계를 갖춘 xr843/Master-skill, dull-bird/diamond-sutra-skill 등이 그 예다. 이 스킬들은 철학적 인식론을 에이전트의 작업 틀로 바꿔 디버깅 능력을 끌어올린다.

불교의 인식론적 원리를 AI 디버깅 및 작업 규율로 정형화해 에러와 환각을 줄이는 프로젝트가 구동되고 있다.

결정론적 연산과 전문 도메인의 정밀한 결합

동양 전통 지식과 AI 에이전트를 결합한 사례들은 복잡한 규칙 기반 도메인을 연산 도구, 실무 지침과 정밀하게 엮는 아키텍처 패턴을 보여준다. 정밀 역법 계산과 형이상학적 틀이 MCP 서버와 SKILL.md 규격을 거쳐 대형 언어 모델과 맞물린다.

이번 사례들을 보면 에이전트 스킬 생태계는 코딩 자동화 도구에서 엄격한 규칙 기반의 전문 도메인 지식으로 빠르게 넓어지고 있다. 환각 없는 도구 실행을 맡는 MCP 연산 구조와 맥락 중심의 지침 해석을 나누는 방식은, 앞으로 복잡한 도메인에서 고성능 AI 시스템을 만들 때 주요 설계 기준이 될 것이다.

참고