Anthropic의 Skills System을 그대로 재현한 OpenSkills로 구현하는 AI 에이전트 통합 스킬 시스템

AI 코딩 에이전트를 사용할 때 가장 답답한 부분은 플랫폼마다 기능 지원 수준이 달라서 작업 흐름이 자주 끊긴다는 점입니다. 특히 Claude Code의 Skills System은 매우 유용하지만, Cursor나 Windsurf, Aider 같은 다른 에이전트에서는 동일한 방식으로 사용할 수 없어 아쉬움을 느낀 사용자가 많습니다. OpenSkills는 바로 이 문제를 해결하기 위해 만들어졌습니다. Anthropic의 Skills System을 그대로 재현해 모든 AI 코딩 에이전트에서 동일한 스킬 구조를 사용할 수 있도록 돕는 도구입니다. 이 글에서는 OpenSkills의 개념부터 설치 방법, 동작 방식, 멀티 에이전트 환경에서의 활용까지 핵심 내용을 상세하게 정리합니다.

반응형

---

OpenSkills란 무엇인가

OpenSkills는 Anthropic Claude Code의 Skills System을 그대로 다른 에이전트에서도 사용할 수 있도록 만들어진 도구입니다. Anthropic의 마켓플레이스 스킬, SKILL.md 포맷, progressive disclosure 방식까지 동일하게 구현하며, 차이점은 호출 방식이 Skill 도구가 아닌 CLI 기반이라는 점입니다. 이를 통해 개발자는 Claude Code에 국한되지 않고 원하는 에이전트에서 동일한 스킬 체계를 유지할 수 있습니다.
OpenSkills의 핵심 목적은 간단합니다. 모든 AI 코딩 에이전트가 동일한 스킬 구조를 공유하도록 하고, 사용자는 어디에서든 같은 스킬을 실행할 수 있도록 만드는 것입니다.

---

왜 OpenSkills가 필요한가

OpenSkills는 다음과 같은 실제 개발자들의 불편함과 요구를 해결합니다.

• AI 코딩 에이전트를 여러 개 사용할 때 스킬을 각각 따로 관리해야 하는 문제
• Claude Code에만 있는 스킬 생태계를 Cursor나 Windsurf에서도 쓰고 싶은 욕구
• 프로젝트별로 스킬을 버전 관리하고 싶지만 환경마다 구조가 달라 생기는 불편
• Anthropic의 Skills System을 그대로 활용하고 싶지만 플랫폼 종속적인 한계

결국 OpenSkills는 스킬의 설치·관리·로드까지 통합된 구조를 제공함으로써, 에이전트를 바꿔도 개발 흐름이 끊기지 않도록 돕습니다.

---

Claude Code Skills System과의 100% 호환성

OpenSkills는 Claude Code와 다음 부분에서 완전히 동일한 구조를 가집니다.

1. 동일한 <available_skills> XML 형식
2. Anthropic 마켓플레이스 스킬 설치 가능
3. 동일한 SKILL.md 포맷(YAML + markdown)
4. 동일한 폴더 구조(.claude/skills/)
5. progressive disclosure 방식 사용
6. 스킬 리소스 구조(references, scripts, assets)까지 동일

다만 호출 방식은 다릅니다.

• Claude Code: Skill("pdf")
• OpenSkills: openskills read pdf

호출 방식만 CLI 기반으로 다를 뿐, 내부에서 스킬을 불러오는 결과는 완전히 동일합니다.

---

OpenSkills 설치 방법

OpenSkills는 Node 패키지 형태로 제공되며, 설치는 단 한 줄로 시작됩니다.

npm i -g openskills

설치 후 다음 명령으로 스킬을 가져올 수 있습니다.

openskills install anthropics/skills

이 명령은 Anthropic 공식 스킬 마켓플레이스에서 설치할 스킬을 선택하도록 안내합니다. 원하는 스킬을 선택하면 .claude/skills/ 폴더에 구조가 자동으로 생성됩니다.
원한다면 GitHub의 다른 리포지토리에서도 스킬을 불러올 수 있습니다.

openskills install your-org/custom-skills

---

스킬 로드 및 사용 방법

스킬 파일은 progressive disclosure 방식으로 로드됩니다. 즉, 필요할 때만 스킬 내용을 불러와 에이전트에게 전달합니다.
스킬 호출 예시는 다음과 같습니다.

openskills read pdf

이 명령을 실행하면 pdf 스킬의 SKILL.md 내용이 그대로 에이전트 context로 제공됩니다. 에이전트는 SKILL.md의 지침을 확인한 뒤 PDF 처리 작업을 수행할 수 있게 됩니다.
추가로 스킬 상태를 확인하거나 삭제할 때는 아래 명령을 사용합니다.

openskills list
openskills remove <name>
openskills manage

---

다양한 AI 코딩 에이전트에서의 활용

OpenSkills는 단일 환경에 국한되지 않고 여러 에이전트에서 동일하게 동작합니다.

• Claude Code: 기존 marketplace 스킬과 공존 가능
• Cursor: 원래 제공되지 않던 Skills System을 동일한 방식으로 구현
• Windsurf: SKILL.md 구조 유지
• Aider: CLI 기반 스킬 로드 가능

하나의 AGENTS.md 파일을 기반으로 모든 에이전트가 동일한 스킬 정보를 참조하게 만들 수 있습니다.

---

Universal 모드의 활용

여러 에이전트를 함께 사용하는 환경에서는 스킬 중복 생성이 가장 큰 문제입니다. Claude Code는 .claude/skills/ 폴더를 사용하지만, Cursor나 Windsurf는 같은 경로를 쓰지 않습니다. 이러한 충돌을 피하기 위해 OpenSkills는 Universal 모드를 제공합니다.

openskills install anthropics/skills --universal

이 모드를 쓰면 스킬이 .agent/skills/ 폴더에 설치됩니다.
이 방식의 장점은 다음과 같습니다.

• 여러 에이전트가 하나의 스킬 소스를 공유
• Claude Code의 marketplace 스킬과 충돌 없음
• 프로젝트 전체에서 일관된 스킬 관리 가능

Universal 모드는 다중 에이전트를 사용하는 개발자에게 가장 실용적인 설정입니다.

---

OpenSkills가 실제로 동작하는 방식

OpenSkills는 Anthropic의 Skills System 설계를 그대로 따릅니다.
내부 동작 순서는 다음과 같습니다.

1. 사용자가 스킬을 설치하면 SKILL.md와 리소스 폴더가 저장됨
2. AGENTS.md 파일에 <available_skills> 목록이 자동 업데이트됨
3. 스킬을 호출하면 CLI가 파일 내용을 읽어 에이전트에 전달
4. 에이전트는 SKILL.md 지침에 따라 사용자의 요청을 해결

중요한 점은 MCP 서버나 API 연동 없이도 Anthropic Skills System을 완전히 구현했다는 것입니다. 즉, 복잡한 서버 구성 없이 단순 파일 기반 스킬 관리가 가능합니다.

---

728x90

OpenSkills가 개발 워크플로우에 가져오는 변화

OpenSkills는 AI 코딩 에이전트 활용 방식에 큰 변화를 줍니다.
특정 플랫폼에 묶이지 않고, 원하는 에이전트 어디에서나 동일한 스킬 세트를 사용할 수 있게 만들기 때문입니다.
이를 통해 개발자는 다음과 같은 효과를 기대할 수 있습니다.

• 에이전트 변경 시 작업 흐름이 끊기지 않음
• 프로젝트별 스킬 버전 관리가 용이
• Anthropic 스킬 생태계를 그대로 확장
• 멀티 환경에서 스킬 중복 없이 일관된 작업 환경 유지

결국 OpenSkills는 개발자에게 더 유연한 환경과 더 강력한 통합된 워크플로우를 제공합니다. AI 코딩툴을 본격적으로 활용하려는 사용자라면 OpenSkills는 반드시 고려해야 할 핵심 도구입니다.

300x250

https://github.com/numman-ali/openskills

GitHub - numman-ali/openskills: Universal skills loader for AI coding agents - npm i -g openskills