에이전트 스킬 130개를 동적 링커로 조립하는 방법 — html-publish 127.6KB를 11.2KB로

서소영 · 동적 링커 · ax-trend 이슈 #3605 · 2026-10-27 공개

130개 스킬, 줄이지 않고 링크로 조립 — call·include·pick 동적 링커
개요 — 스킬을 줄이는 대신 링크해서 조립하는 방식입니다

공개 내용

서소영은 2026년 10월 27일 개인 블로그에 에이전트 스킬 130개 시대를 위한 동적 링커 조립 방식을 공개했습니다. 기존 127개 스킬(총 686,236자)을 전수 조사해 132개 스킬과 11개 도메인 카탈로그 구조로 재편했습니다. 스킬 수가 늘었는데도 각 스킬 본문은 가벼워졌습니다. 비결은 본문에 자료를 복사해 넣지 않고 링크로 불러오는 데 있습니다.

스킬 본문에는 실행 순서와 검증 게이트만 남깁니다. 필요한 자료는 call, include, pick 세 가지 선언형 링크 블록으로 런타임에 불러옵니다. 작성자는 파이프라인 같은 새 계층을 만드는 대신, 마크다운 스킬 본문 안에 선언형 링크 블록을 직접 적는 방식을 택했습니다. 운영체제의 동적 링크 라이브러리 개념을 LLM 에이전트 스킬 관리에 적용한 셈입니다.

동적 링커 조립 흐름: 127개 스킬 전수 조사, 132개 스킬·11개 도메인 카탈로그, 본문엔 순서·게이트만, 3종 링크로 런타임 조립, pins로 조합 복원
조립 흐름 — 조사부터 카탈로그 재편, 링크 조립, pins 복원까지 이어집니다

세 가지 링크의 차이점

구분이 중요한 이유는 스킬 본문이 무거워지는 원인이 한 가지가 아니기 때문입니다. 항상 필요한 자료, 조건부로만 필요한 하위 스킬, 의도별로 갈리는 카탈로그를 같은 방식으로 본문에 넣으면 전부 상시 적재 비용이 됩니다. 세 가지 링크는 이 비용을 불러오는 시점과 조건으로 나눕니다.

수치 감소 폭

스킬 크기 감소율: html-publish 91%, skill-creator 65%, digest-post 61%
스킬별 크기 감소율 — 가장 컸던 html-publish의 감소폭이 가장 큽니다
스킬변화비고
html-publish127.6KB → 11.2KB, 91% 감소가장 컸던 스킬
skill-creator65% 감소작성자 보고
digest-post61% 감소작성자 보고

링크가 깨지지 않았는지도 정적 분석으로 확인했습니다. 정적 분석기 skill_lint.py가 78개 링크 블록을 전수 검사해 링크 오류 0건을 기록했습니다. 전체 린트 경고는 67건에서 5건으로, 문서 트리 UUID 하드코딩은 48건에서 0건으로 줄었습니다.

컨텍스트 압축 뒤에도 처음 고른 카탈로그 조합을 복원할 수 있게, 스킬 로더가 고른 카탈로그 이름 목록을 pins 배열로 함께 돌려줍니다. 압축 때문에 조합이 휘발되는 문제를 pins가 막는 구조입니다. 장시간 에이전트 운영에서는 같은 조합을 다시 맞추는 비용이 작지 않으므로, 이 부분은 실용적인 아이디어로 볼 수 있습니다.

MCP 대시보드 서버 구현도 함께 공개됐습니다

@eiaserinnys는 같은 call, include, pick 방식을 MCP 대시보드 서버로 구현했다고 10월 27일 X에 공개했습니다. 대시보드 서버는 위키에서 스킬 정의를 읽어 yaml 메타데이터에 따라 실시간으로 스킬을 조립합니다. 다만 동작 방식과 성능 수치는 포스트의 스크린샷 외에 확인된 자료가 없어 미확인입니다. 블로그 방식과 MCP 서버 방식이 같은 개념의 두 구현인지, 동작이 어느 수준까지 같은지는 원문만으로 단정하기 어렵습니다.

중요성

에이전트가 다루는 절차형 스킬이 100개를 넘으면 프론트매터 적재만으로 컨텍스트가 무거워집니다. 여러 스킬에 복사해 넣은 운영 절차가 서로 어긋나는 드리프트도 생깁니다. 스킬을 줄이는 대신 링크해서 조립한다는 해법은 두 문제를 동시에 겨냥합니다. 본문은 순서와 게이트만으로 얇게 유지하고, 자료는 필요할 때 불러오며, 조합은 pins로 고정합니다.

스킬 수가 수십 개를 넘는 팀과 개인에게는 컨텍스트 비용과 드리프트가 공통 문제입니다. 이 글은 그 문제를 수치와 함께 제시한 사례라는 점에서 참고 가치가 있습니다. 다만 소울스트림 내부 운영 사례라 외부 환경에서의 재현성은 미확인입니다. 자기 팀 스킬 구조에 바로 적용하기 전에, 링크 블록과 로더가 자기 환경에서 같은 방식으로 동작하는지 확인하는 단계가 필요합니다.

아직 확인되지 않은 점

91% 감소를 비롯한 수치는 작성자 자가 보고이며, 독립 검증 결과는 미확인입니다. skill_lint.py와 스킬 로더, MCP 대시보드 서버의 공개 저장소 링크는 글과 포스트에서 확인되지 않아 미확인입니다. MCP 대시보드 서버의 동작 방식과 성능 수치는 포스트의 스크린샷 외에 확인된 자료가 없어 미확인입니다. 소울스트림 내부 운영 사례라 외부 환경에서의 재현성은 미확인입니다.

실무 판단: 링크 종류부터 나누는 것이 순서입니다

실무 판단은 이렇게 정리됩니다. 스킬 본문을 다이어트하기 전에, 본문에 들어 있는 자료를 세 갈래로 먼저 나누는 것이 순서입니다. 매번 봐야 하는 자료는 include, 조건부로만 필요한 하위 스킬은 call, 의도별로 갈리는 카탈로그는 pick으로 두는 구분이 이 글의 핵심입니다. 구분 없이 본문을 줄이면 필요할 때 자료가 없어지고, 구분 없이 링크만 늘리면 링크 관리 비용이 새로 생깁니다. 91% 같은 수치를 도입 근거로 삼기 전에, 자기 스킬에서 링크 오류를 전수 검사하는 lint부터 갖추는 것이 좋습니다.

원문 이슈

AX TrendAI 코딩성능 최적화