Claude Code 플러그인을 OpenCode용 스킬로 이식하는 방법

커뮤니티 반응

작성자가 공개한 GitHub 저장소와 로컬 모델 최적화 방식에 대해 긍정적인 관심이 예상되며, 특히 Claude Code의 폐쇄적 형식을 극복하려는 시도가 주목받고 있다.

주요 논점

01찬성다수

플랫폼 종속적인 에이전트 기능을 범용 마크다운 스킬로 변환하는 것은 에이전트 생태계의 호환성을 위해 필수적이다.

합의점 vs 논쟁점

합의점

SKILL.md 형식이 현재 에이전트 간 스킬 공유를 위한 가장 이식성 높은 표준이다.
로컬 모델은 고성능 상용 모델에 비해 더 구체적이고 강제적인 워크플로 지시가 필요하다.

논쟁점

모든 기능을 슬래시 커맨드에 인라이닝하는 방식이 프롬프트 길이를 늘려 컨텍스트 효율성을 저해할 수 있는지에 대한 여부

실용적 조언

로컬 모델을 에이전트로 사용할 때 지시를 무시한다면 메타 명령 대신 전체 워크플로를 직접 프롬프트에 삽입하라.
코드 리뷰 스킬 작성 시 '자신의 발견이 틀렸음을 증명하라'는 단계를 추가하여 오탐을 줄여라.

섹션별 상세

Claude Code의 전용 명령어와 에이전트 형식이 타 에이전트와의 호환성을 저해한다는 점을 확인했다. 작성자는 YAML 프론트매터가 포함된 마크다운 파일인 SKILL.md 형식이 가장 이식성이 높은 표준임을 파악하고 이를 기반으로 전환 작업을 수행했다. 이를 통해 특정 플랫폼에 종속되지 않고 여러 에이전트에서 동일한 지침을 실행할 수 있는 구조를 마련했다.

로컬 모델인 Qwen이나 Llama를 사용할 때 발생하는 메타 명령어 오작동 문제를 해결하기 위해 인라이닝 방식을 도입했다. 에이전트에게 스킬을 로드하라고 지시하는 대신 슬래시 커맨드 본문에 전체 워크플로를 직접 삽입하여 모델이 지시사항을 텍스트로 출력하는 대신 즉시 실행하도록 유도했다. 이 방식은 추론 능력이 상대적으로 낮은 로컬 모델에서도 복잡한 작업을 안정적으로 수행하게 한다.

javascript

config.skills.paths.push()

OpenCode 설정에 스킬 디렉토리 경로를 추가하여 플러그인을 등록하는 방식

로컬 모델의 성급한 결론 도출을 방지하기 위해 리뷰 스킬의 깊이를 강화하는 로직을 추가했다. 단순히 코드를 검토하는 것을 넘어 검토 결과가 틀렸음을 증명하려는 시도인 교차 확인 단계와 필수적인 재현 시나리오 작성을 강제하는 절차를 포함했다. 이는 고성능 모델인 Sonnet이나 Opus에 최적화된 기존 Anthropic 버전을 로컬 환경에 맞게 최적화한 결과이다.

플러그인 로더 구현을 위해 Jesse Vincent의 superpowers 패턴을 차용하여 스킬 디렉토리를 프로그래밍 방식으로 등록했다. config.skills.paths.push() 메서드를 사용하여 사용자가 정의한 11가지 스킬을 OpenCode 환경에 동적으로 로드할 수 있도록 설계했다. 이 구조는 코드 리뷰, 보안 감사, 프론트엔드 디자인 등 다양한 전문 작업을 모듈화하여 관리할 수 있게 한다.

용어 해설

모델 컨텍스트 프로토콜(MCP): — AI 모델이 로컬 데이터나 외부 도구에 표준화된 방식으로 접근할 수 있도록 돕는 프로토콜이다. 이 아티클에서는 MCP 서버를 구축하는 기능을 스킬 형태로 구현하여 에이전트의 확장성을 높이는 데 활용했다.
YAML 프론트매터(YAML Frontmatter): — 파일의 최상단에 위치하여 메타데이터를 정의하는 블록이다. 스킬 파일의 속성이나 설정을 구조화된 데이터로 정의하여 에이전트가 해당 스킬의 용도와 실행 방식을 인식하게 한다.
슬래시 커맨드(Slash Command): — 채팅창에 '/'로 시작하는 명령어를 입력하여 특정 기능을 즉시 실행하는 인터페이스이다. 복잡한 워크플로를 단축어로 호출하여 에이전트가 정해진 절차에 따라 작업을 수행하도록 유도한다.

언급된 도구

OpenCode추천

Claude Code의 대안으로 사용되는 오픈소스 코딩 에이전트

Claude Code중립

Anthropic에서 제공하는 공식 CLI 코딩 에이전트

언급된 리소스

GitHubopencode-power-pack GitHub