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 시스템을 구축하는 주요한 설계 기준이 될 것이다.

참고