Aside 스킬 질문을 영상으로 바꾼 이유와 10명의 신호

2026년 6월 28일, 에르메스단 카카오톡방에서 Aside에 LazyCodex나 gjc를 어떻게 붙이냐는 질문을 봤다. 나는 그 질문을 그냥 답글로 넘기지 않고 영상으로 정리했다. 한 사람이 묻는 지점은 보통 열 명이 함께 멈추는 자리라고 생각했기 때문이다.

어떤 질문이 영상의 시작이 되었을까?

“Aside에 lazy codex나 gjc를 어떻게 붙이냐”

• 카카오톡방에서 Aside와 LazyCodex, gjc를 연결하는 방법을 묻는 질문이 나왔다.
• 나는 Aside 설정에서 Skills를 열고 OMO 스킬 폴더를 가져오는 흐름을 영상으로 만들었다.
• 프롬프트 앞에 $omo:ultraresearch를 붙이는 방법도 함께 정리했다.
• 댓글에는 “ASIDE에 ULW 넣으니 사긴데요ㄷㄷ”, “lazyaside 가능한가요”, “스킬 임포트로 돼요”라는 반응이 이어졌다.

왜 답글 대신 영상을 골랐을까?

원문에 적은 이유는 한 줄이었다.

누군가 한 번 물어본 건, 보통 열 명이 같은 지점에서 막혔다는 뜻이라서.

글을 올린 뒤에는 무슨 일이 이어졌을까?

영상 글은 6월 28일 밤 11시 27분에 올렸다. Aside를 만든 @sanghun_lee1344님과 LazyCodex를 만든 @yeon.gyu.kim님도 글에 태그했다.

이 글은 조회 14,632회, 좋아요 100개를 기록했다. 이틀 뒤 6월 30일에는 Aside 이름의 공식 발음을 바로잡는 글을 올렸고, 그 글의 답글에서 이 영상 글을 다시 연결했다.

스킬은 어떤 형식의 파일일까?

참고: 이 부분은 내 경험이 아니라 공개 규격을 옮긴 내용이다. 스킬은 SKILL.md 파일 하나를 중심으로 한 폴더다.

Anthropic이 처음 만들고 지금은 agentskills.io에서 공개 규격으로 정리하는 Agent Skills 형식에서는 스킬 하나가 폴더 하나다. 폴더 안에 SKILL.md가 반드시 있어야 하고, 필요하면 실행할 코드를 담는 scripts, 참고 문서를 담는 references, 서식 같은 자료를 담는 assets 폴더를 더 둘 수 있다.

항목	공개 규격에 적힌 조건
name	필수. 최대 64자. 영어 소문자, 숫자, 하이픈만 쓰고 폴더 이름과 같아야 함
description	필수. 최대 1,024자. 무엇을 하는 스킬인지와 언제 쓰는지를 함께 적음
license, compatibility, metadata	선택. 라이선스, 필요한 환경, 추가 정보

Anthropic 문서와 공개 규격은 이 구조를 단계적으로 읽는 방식이라고 설명한다. 이름과 설명 같은 메타데이터는 시작할 때 스킬마다 100토큰 안팎만 읽어 두고, SKILL.md 본문은 스킬이 필요해졌을 때 읽는다. 본문은 5,000토큰 아래를 권하고, SKILL.md 자체는 500줄 아래로 유지하라고 한다. scripts나 references 안의 파일은 실제로 필요할 때만 연다. 스킬을 여러 개 넣어 둬도 처음부터 전부 읽지 않는 이유가 여기에 있다.

Anthropic은 파워포인트, 엑셀, 워드, PDF 작업용 스킬을 미리 만들어 Claude 앱과 API에 제공하고, 사용자가 만든 스킬도 같은 방식으로 쓰인다고 안내한다. 다만 이 미리 만든 문서 스킬은 Claude Code에서는 쓸 수 없다고 따로 적혀 있다.

Aside가 스킬을 가져올 때 이 규격의 어느 항목까지 검사하는지는 공식 문서로 확인하지 못했다.

같은 질문이 또 나오면 무엇부터 보면 될까?

영상에 담은 순서는 세 단계였다. 설명은 짧게 하고, 화면 순서만 그대로 따라 할 수 있게 남겼다.

1. Aside 설정에서 Skills 화면을 연다.
2. 가져올 스킬 폴더를 불러온다. 영상에서는 OMO 스킬 폴더를 썼다.
3. 쓰고 싶은 스킬 이름을 프롬프트 앞에 붙인다. 영상의 예시는 $omo:ultraresearch였다.

따라 하다 막히면 SKILL.md가 폴더 바로 아래에 있는지, name 값이 폴더 이름과 같은지부터 보는 편이 빠르다고 생각한다. 공개 규격을 근거로 한 내 판단이니 의견으로 봐 주면 좋겠다.

자주 묻는 질문

스킬을 만들려면 코드를 꼭 짜야 하나요?

규격상 필수 파일은 SKILL.md 하나다. 메타데이터와 마크다운 지침만으로도 스킬이 되고, 코드는 scripts 폴더에 선택으로 넣는다.

description은 왜 공들여 써야 하나요?

에이전트가 이 설명을 보고 스킬을 쓸지 정하기 때문이다. 규격 문서는 "PDF를 도와줌"처럼 짧은 설명을 나쁜 예로, 하는 일과 쓰는 상황을 함께 적은 설명을 좋은 예로 든다.

같은 스킬 폴더를 다른 도구에서도 쓸 수 있나요?

Claude Code 공식 문서를 예로 들면, 개인 스킬은 ~/.claude/skills 아래에 스킬 이름의 폴더를 만들고 SKILL.md를 넣으면 모든 프로젝트에서 쓸 수 있다. 프로젝트 안의 .claude/skills에 두면 그 프로젝트에서만 쓰인다. 도구마다 스킬을 찾는 위치가 다르니 각 도구의 문서를 먼저 보는 편이 안전하다.

원문에는 누가 태그돼 있나요?

질문을 옮긴 첫 줄 아래에 @unclejobs.ai님이 있고, 본문 끝에는 Aside를 만든 @sanghun_lee1344님과 LazyCodex를 만든 @yeon.gyu.kim님이 있다.

참고한 자료

• Agent Skills - Specification
• Claude Code 문서 - Extend Claude with skills
• Claude 문서 - Agent Skills 개요

---

원문: 스레드 2026-06-28