AI 에이전트가 쓰는 '스킬 매뉴얼'을 통째로 읽지 않고, 필요한 절만 골라 안전하게 압축해서 불러오는 방법
arXiv:2608.056042026-08-05
SkillZip: Contract-Preserving Graph Compression for Scalable Agent Skill Libraries
AI 에이전트가 쓰는 '스킬 매뉴얼'을 통째로 읽지 않고, 필요한 절만 골라 안전하게 압축해서 불러오는 방법
AI 에이전트가 작업을 수행할 때 참고하는 절차 매뉴얼(스킬 패키지)이 많아지면, 매번 전체 문서를 다 불러오는 방식은 비효율적이고 겹치는 내용도 많다. SkillZip은 스킬을 문단 단위로 쪼개 그래프로 만들고, 반복되는 절차를 실행 계약(입출력, 실행조건, 검증조건)을 그대로 유지한 채 매크로로 압축한 뒤, 작업에 필요한 만큼만 풀어서 보여준다. 기술형·로봇형 에이전트 벤치마크 실험에서 가장 강한 비교 대상보다 최대 12.2점 높은 성능을 내면서도 3.46배 압축, 99.2% 의존성 보존, 98.7% 검증 경로 도달성을 달성했다.
METAL MEDIA 해설 도표
SkillZip 파이프라인: 스킬 패키지에서 실행 가능한 압축 문맥까지
증거 상태측정 결과가 보고됨
Sec2Graph스킬 패키지를 의도·입력·조건·연산·검증·출력 등 역할이 다른 절 단위 노드로 쪼개 실행 가능한 그래프로 만든다.
MotifZip여러 스킬에서 반복되며 입출력 경계·의존성·검증 도달성이 동일한 부분 그래프만 골라 되돌릴 수 있는 매크로로 압축한다.
PathHydrate작업 질의가 들어오면 압축된 그래프에서 필요한 만큼만 풀어 예산 안에서 실행 가능한 문맥을 만든다.
ReZip새 스킬과 실행 결과(성공·실패 기록)를 반영해 새 매크로를 승격하거나 위험한 매크로를 되돌린다.
METAL MEDIA이 원문을 바탕으로 재구성한 해설 도표이며, 논문 저자의 원문 figure가 아닙니다.
무엇을 했나
문제 제기: 스킬 라이브러리가 커지면 스킬 패키지 전체를 통째로 불러오는 기존 방식은 겹치는 절차까지 중복해서 로드하고, 텍스트 압축은 실행에 필요한 계약(입력·출력·검증조건)을 훼손할 위험이 있으며, 실행 그래프는 검색 이후에만 만들어져 라이브러리 자체가 압축된 형태로 저장되지 않는다.
방법: SkillZip은 먼저 Sec2Graph로 스킬 패키지를 의도·입력·조건·연산·검증·출력 등 역할이 다른 절 단위 노드로 쪼개 그래프로 만들고, MotifZip이 여러 스킬에서 반복되면서 입출력 경계·의존성·검증 도달성이 동일하게 유지되는 부분 그래프만 골라 되돌릴 수 있는 매크로로 압축한다. PathHydrate는 질의 시점에 필요한 만큼의 압축 그래프만 풀어서 예산 안에서 실행 가능한 문맥을 만들고, ReZip은 새 스킬이나 실행 결과(성공/실패 로그)를 반영해 매크로를 새로 만들거나 위험한 매크로를 되돌린다.
실험: SkillsBench(기술형 소프트웨어 에이전트 벤치마크)와 ALFWorld(가정용 로봇 에이전트 벤치마크)에서 여러 LLM 백본에 걸쳐 평가했다.
결과: 가장 강력한 비교 대상(SkillDAG)보다 ALFWorld에서 최대 12.2점 높은 성능을 냈고, 3.46배 압축률, 99.2% 의존성 보존, 98.7% 검증 경로 도달성을 기록했으며, 200개에서 100,000개 스킬 규모까지 검색 성능이 유지됐다.
부가 결과: 1000개 스킬 라이브러리 기준 전체 작업의 51.7%가 2,000토큰 미만의 문맥만으로 처리됐고, 가장 흔한 구간은 1,000~1,500토큰이었다.
Figure 1. Representative skill-library workflows.
Table 1. Main results on SkillsBench and ALFWorld. R is task reward (%) on SkillsBench or episode success rate (%) on ALFWorld. Arrows report point changes from Vector Skills. The best comparable results are in bold.
Backbone
Method
SkillsBench (19)
ALFWorld (40)
R↑
Ret@1↑
Ret@5↑
MRR↑
R↑
Ret@1↑
Ret@5↑
MRR↑
MiniMax-M2.7
Vanilla Skills
17.2 ↑6.8
–
–
–
47.1 ↓3.6
–
–
–
Vector Skills
10.4
3.6
10.8
5.8
50.7
37.9
68.6
49.2
GoS (24)
18.7 ↑8.3
50.6 ↑47.0
65.5 ↑54.7
57.3 ↑51.5
54.3 ↑3.6
56.4 ↑18.5
86.4 ↑17.8
67.9 ↑18.7
SkillDAG (1)
27.3 ↑16.9
66.7 ↑63.1
78.2 ↑67.4
71.3 ↑65.5
67.1 ↑16.4
57.9 ↑20.0
92.1 ↑23.5
71.1 ↑21.9
SkillZip
33.3 ↑22.9
73.6 ↑70.0
92.0 ↑81.2
81.3 ↑75.5
79.3 ↑28.6
85.7 ↑47.8
98.6 ↑30.0
91.2 ↑42.0
gpt-5.2-codex
Vanilla Skills
27.4 ↑5.9
–
–
–
89.3 ↓3.6
–
–
–
Vector Skills
21.5
3.6
10.8
5.8
92.9
37.9
68.6
49.2
GoS (24)
34.4 ↑12.9
50.6 ↑47.0
65.5 ↑54.7
57.3 ↑51.5
93.6 ↑0.7
56.4 ↑18.5
86.4 ↑17.8
67.9 ↑18.7
SkillDAG (1)
36.8 ↑15.3
70.1 ↑66.5
75.9 ↑65.1
73.0 ↑67.2
93.6 ↑0.7
60.4 ↑22.5
85.1 ↑16.5
69.6 ↑20.4
SkillZip
43.0 ↑21.5
74.7 ↑71.1
88.5 ↑77.7
81.0 ↑75.2
96.4 ↑3.5
90.7 ↑52.8
99.3 ↑30.7
95.0 ↑45.8
Figure 2. Overview of the SkillZip framework. Sec2Graph retains occurrence-specific sections and links compatible ones through canonical prototypes; MotifZip rewrites recurring contract-valid subgraphs as reversible macros; PathHydrate compiles a budgeted executable context; and ReZip updates the compressed library from new skills and execution feedback.
Table 9. Measured local structural construction cost after cached contract extraction. Values report aggregate wall-clock time for graph construction and MotifZip. LLM inference is excluded.
Skills
Section nodes
Graph + MotifZip↓
100
6,441
274 ms
200
10,309
436 ms
500
24,333
1.06 s
1K
48,838
1.44 s
2K
96,739
2.90 s
5K
240,080
7.78 s
10K
477,681
16.1 s
100K
4.77 M
178 s
Figure 3. Contract-extraction quality on the annotated subset. Bars show field-level F1 and exact match; dashed lines denote macro averages.
Table 10. Local retrieval and rendering cost on SkillsBench after task anchors are available. Online excludes provider inference; Rendered Tok includes fixed rendering metadata and any indivisible selected unit.
Method
Online (ms)↓
Rendered Tok↓
Vector Skills
12.1
2,834
GoS
34.6
2,517
SkillDAG
41.2
3,103
SkillZip
27.9
1,941
Figure 4. Task reward of SkillZip as the procedural-content selection budget varies on SkillsBench with MiniMax-M2.7. The dashed line marks the default 3,000-token budget.
Table 11. End-to-end trajectory cost on the default 1K-skill SkillsBench setting with MiniMax-M2.7. Values are task averages. Prompt counters aggregate all agent turns; task time spans model inference, tool and container execution, and harness interaction.
Metric
Vanilla Skills
SkillDAG
SkillZip
Total prompt↓
2,429,237
2,782,696
1,473,532
Uncached prompt↓
78,081
76,880
62,526
Cached prompt↓
2,351,156
2,705,816
1,411,006
Completion↓
34,592
31,963
20,601
Tool calls↓
32.9
36.9
28.9
Task time (s)↓
464.7
429.7
339.0
Reward↑
17.2
27.3
33.3
Figure 5. Mean rendered context on the 1K-skill SkillsBench library. Whole-skill comparisons render each retrieved package in full, whereas SkillZip hydrates dependency-closed sections.
Table 15. Case Study 1 – Retrieval trace for header normalization with row-count verification. Skill-level retrieval exposes overlapping packages, whereas SkillZip selects the shared operation and its required verifier path.
Retrieval unit
Matching evidence
Selected context
Context consequence
Skill level
Package-level similarity to both skill descriptions
Full Clean CSV and Pivot Table packages
Includes the requested routine, but also exposes missing-value repair, pivot aggregation, and competing output rules.
Section level
Operation anchor (normalize headers) and verifier anchor (row count unchanged)
Mingest with file/schema dependencies and the row-count verifier
Closes the required dependencies and verifier path without loading unrelated downstream branches.
Figure 6. Task-level distribution of the context rendered by SkillZip. Overall, 51.7% of tasks use fewer than 2,000 tokens, and 1,000–1,500 tokens is the modal interval.
Table 16. Case Study 2 – Contract-aware comparison of three textually similar routines. MotifZip accepts the two CSV occurrences because their interfaces, execution requirements, and verifier boundaries agree, while keeping the workbook occurrence separate.
Occurrence
Interface
Execution
Verification
MotifZip decision
Clean CSV
CSV + delimiter → normalized table
Infer delimiter, parse rows, normalize headers, and preserve row identity
Schema report and reachable row-count hook
Accept into Mcsv-ingest
Pivot Table
CSV + delimiter → normalized table
Same ingest routine; pivot aggregation starts after the macro output port
Schema report; downstream total verifier remains occurrence-specific
Accept into Mcsv-ingest
Formula-Safe Workbook
XLSX → formula-preserving workbook
Use a formula-aware resource and preserve formulas during normalization
Formula-integrity and row-count verifiers
Reject from the CSV macro; retain separately
Reversible rewrite Mcsv-ingest keeps occurrence-specific source/port maps and downstream verifiers.
Figure 7. Failure attribution grouped by the earliest blocking stage.
Table 17. Case Study 3 – Illustrative ReZip trace. Repeated compatible occurrences promote a residual, while execution risk triggers controlled macro demotion.
Stage
Incoming signal
Contract evidence
ReZip update
Resulting library state
Insert
A new Merge Monthly Reports skill arrives
Ingest matches Mcsv-ingest; the align–merge–balance subgraph is unmatched
Reuse the ingest macro and buffer the residual
Known structure is compressed; novel steps remain explicit
Promote
The merge residual recurs in later skills
Ports, dependencies, resource family, and balance verifier remain stable
Promote Mperiod-merge
Later skills reuse one verified period-merge routine
Revise
Formula-bearing tasks repeatedly expand or fail the generic export macro
Failures localize to the XLSX resource and formula-integrity verifier
Split by resource family; require full source for XLSX
CSV export remains compact; workbook safeguards are restored
Reuse
A future CSV or workbook query arrives
Task anchors identify the required resource and verification contract
Select the macro and hydration level by task contract
Compact where stable; source-expanded where evidence indicates risk
실제로 확인된 결과
SkillsBench와 ALFWorld 실험에서 SkillZip이 가장 강력한 비교 대상(SkillDAG)보다 ALFWorld에서 최대 12.2점 높은 성능(에피소드 성공률 기준)을 기록했다.
스킬 라이브러리 규모를 200개에서 100,000개까지 늘려도 검색 성능의 우위가 유지되는 것으로 확인됐다.
1,000개 스킬 라이브러리 기준 전체 작업의 51.7%가 2,000토큰 미만의 문맥만으로 처리됐고, 1,000~1,500토큰 구간이 가장 흔했다.
여섯 개의 서로 다른 LLM 백본에 대해 별도의 미세조정 없이 SkillZip을 적용할 수 있음을 확인했다.
어디에 쓸 수 있나
문서화된 절차 매뉴얼(스프레드시트 정제, 검증, 로봇 조작 등)을 다수 보유한 AI 에이전트 시스템에서 문맥 예산을 절약하면서 겹치는 절차를 중복 로드하지 않도록 설계하는 데 참고할 수 있다.
스킬 라이브러리가 계속 늘어나고 실행 로그가 누적되는 서비스에서, 새 절차를 자동으로 매크로로 승격하거나 위험한 매크로를 되돌리는 유지보수 전략을 설계할 때 참고할 수 있다.
기술형 코딩·데이터 처리 에이전트와 가정용 로봇 에이전트처럼 서로 다른 도메인에 동일한 압축 프레임워크를 적용해 보는 실험 설계에 참고할 수 있다.
한계와 남은 검증
실험은 SkillsBench(기술형 소프트웨어 에이전트)와 ALFWorld(가정용 로봇 에이전트) 두 벤치마크에 한정되어 있어, 다른 도메인에서의 성능은 별도 검증이 필요하다.
매크로 선정과 압축 과정은 탐욕적(greedy) 정책을 따르며, 논문 스스로도 모든 겹치는 모티프에 대한 전역 최적성을 보장하지 않는다고 명시한다.
섹션 역할 분류와 계약 추출 일부는 모델 보조 파싱에 의존하므로, 파싱 경계나 역할 추론의 오류가 압축 품질에 영향을 줄 수 있는 부분은 상세히 검증되지 않았다.
ReZip의 매크로 재조정(승격·분할·폐기)이 장기간 운영되는 대규모 실서비스 환경에서 어떻게 동작하는지에 대한 장기 추적 실험은 본문에서 별도로 제시되지 않았다.
왜 중요한가
스킬 라이브러리가 수백에서 수만 개로 늘어날수록 매번 전체 문서를 불러오는 비용과 겹치는 내용으로 인한 혼란이 커지는데, SkillZip은 절 단위 압축으로 이 비용을 줄이면서도 실행에 필요한 계약(입출력·검증)을 잃지 않는 방법을 제시한다. 이는 대규모 에이전트 스킬 라이브러리를 운영하는 실무자에게 문맥 예산과 정확성을 동시에 관리할 실질적인 설계 방향을 제공한다.
이 논문의 용어
스킬 패키지 · 지침, 스크립트, 참고자료, 검증 규칙 등을 담아 AI 에이전트가 추론 시점에 불러 쓰는 절차 묶음
절차 계약(procedural contract) · 절차가 무엇을 입력받고 출력하며, 어떤 조건에서 실행되고 어떻게 검증되는지를 정의한 규약
매크로(macro node) · 반복되는 절차 부분 그래프를 압축해서 하나의 노드로 표현하되, 필요하면 원문으로 되돌릴 수 있게 만든 압축 단위
검증 도달성(verifier reachability) · 상태를 바꾸는 모든 연산에서 그 결과를 확인하는 검증 절차로 가는 경로가 실제로 존재하는지 여부
의존성 보존(dependency preservation) · 압축 후에도 절차 간의 입력·조건·자원 연결 관계가 원래대로 유지되는 정도
