🖼️ 인포그래픽

🖼️ 4컷 인포그래픽

💡 한 줄 요약

이 글은 OpenCode의 기본 역량을 실시간 웹 접근, 세션 인계, 코드베이스 이해, 계획 검증, 다중 에이전트 운영, 출력 절약, 외부 서비스 연동으로 확장하는 10개 스킬과 그 작동 원리·선정 기준을 소개한다.

📌 핵심 요약

• OpenCode 스킬은 필수 YAML 메타데이터와 마크다운 지침이 담긴 SKILL.md를 중심으로 구성되며, 필요하면 스크립트와 참고 파일을 함께 포함한다.
• OpenCode는 시작 시 설치된 스킬의 이름과 설명만 모델에 제시하고, 작업과 일치하는 스킬이 호출될 때 전체 지침을 불러오는 점진적 로딩 방식을 사용한다.
• 추천 목록은 Firecrawl, stop-slop, Handoff, Grill Me, Obra Superpowers, Understand-Anything, Caveman, skill-optimizer, Vault Daydream, Composio로 구성된다.
• 좋은 스킬은 구체적인 실행 조건, 스크립트로 분리된 결정적 작업, 간결한 본문과 필요할 때만 읽는 참고 자료, 하나의 명확한 책임을 갖춰야 한다.
• 본문은 Firecrawl의 검색·스크래핑·크롤링·브라우저 상호작용 기능과 stop-slop의 인공지능 문체 탐지·교정 방식을 특히 상세하게 설명한다.

🧩 주요 포인트

1. 스킬의 이름과 설명만 상시 노출하고 본문은 선택적으로 불러오는 구조는 많은 스킬을 설치해도 무관한 작업의 문맥 소비를 억제한다.
2. 반복 가능한 파싱·검증·정렬을 스크립트에 맡기고 스킬의 역할을 하나로 제한하면 모델 의존적 실행보다 비용과 오작동 가능성을 줄일 수 있다.
3. 스킬은 에이전트의 작업 방법을 가르치고 플러그인은 실행 환경의 동작을 바꾸므로, 설치 전 역할을 구분하고 지침·스크립트·네트워크 호출을 검토해야 한다.

🧠 상세 정리

1. OpenCode에서 스킬이 필요한 이유

글은 OpenCode가 특정 모델이나 제공업체에 종속되지 않고 여러 대규모 언어 모델과 로컬 모델을 실행할 수 있다는 점에서 출발한다. 그러나 모델 자체는 에이전트 유용성의 절반에 불과하며, 나머지는 현재 작업에 필요한 문맥과 반복 가능한 업무 절차라고 설명한다. OpenCode는 기본 상태만으로 실시간 웹, 세션 인계, 코드베이스 탐색, 계획 검증, 다중 에이전트 조율, 외부 서비스 연결을 모두 제공하지 않으므로 스킬이 이 공백을 메운다. 따라서 추천 목록은 단순한 명령 모음보다 에이전트가 정보를 얻고 판단하며 작업을 이어가는 방식을 확장하는 도구에 초점을 맞춘다.

2. 스킬의 구성과 점진적 로딩

OpenCode 스킬은 SKILL.md가 들어 있는 디렉터리이며, 필요에 따라 보조 스크립트와 참고 문서를 추가할 수 있다. SKILL.md의 앞부분에는 이름과 설명을 필수 항목으로 갖는 YAML 메타데이터가 오고, 그 뒤에 스킬이 활성화됐을 때 에이전트가 따를 마크다운 지침이 배치된다. OpenCode는 세션을 시작할 때 모든 스킬의 전체 문서를 읽는 대신 이름과 설명만 도구 목록으로 모델에 공개한다. 사용자의 요청과 설명이 일치하면 모델이 해당 스킬을 호출하고 그때 전체 지침을 불러오므로, 호출되지 않은 스킬은 문맥 창을 차지하지 않는다. 이 구조 덕분에 수십 개의 스킬을 설치하더라도 현재 작업과 관계없는 지침이 매번 함께 들어오는 문제를 피할 수 있다.

3. 설치 경로와 모델 호환성

프로젝트 단위 경로로는 .opencode/skills, .claude/skills, .agents/skills가 인식되며, 전역 경로로는 ~/.config/opencode/skills, ~/.claude/skills, ~/.agents/skills가 사용된다. 글은 전역 OpenCode 경로가 ~/.opencode/skills가 아니라 ~/.config/opencode/skills라고 명시하고, 서로 다른 안내가 있을 때 공식 문서를 기준으로 삼으라고 강조한다. 스킬이 마크다운 중심이기 때문에 OpenCode가 연결한 Claude, OpenAI, Gemini, xAI, Kimi, GLM, DeepSeek, Qwen 및 Ollama 기반 로컬 모델에서도 활용할 수 있다. 다만 Claude Code 생태계에서 만들어진 일부 스킬은 하위 에이전트용 Task 도구처럼 특정 기능에 의존하므로 다른 제공업체에서는 조정이 필요할 수 있다. 즉, 문서 형식의 호환성과 모든 실행 기능의 완전한 호환성은 구분해서 봐야 한다.

4. 스킬·플러그인·권한의 차이

OpenCode의 스킬은 에이전트에게 무엇을 어떻게 수행할지 알려주는 지침인 반면, 플러그인은 자바스크립트나 타입스크립트로 세션 생명주기, 도구 실행, 채팅 메시지 같은 런타임 사건에 개입한다. Obra Superpowers처럼 스킬 모음과 플러그인을 함께 제공하는 도구도 있지만, 두 체계의 역할은 동일하지 않다. opencode.json에서는 스킬별로 허용, 거부, 실행 전 질문을 지정할 수 있으며, 거부된 스킬은 에이전트의 목록에서 완전히 숨겨진다. 같은 프로젝트에서도 에이전트마다 보이는 스킬을 다르게 설정할 수 있고, 특정 에이전트의 스킬 도구 자체를 끄는 것도 가능하다. 이 권한 구조는 설치된 기능을 모두 무조건 노출하지 않고 업무와 신뢰 수준에 따라 사용 범위를 나누는 수단이다.

5. 좋은 스킬을 가르는 기준

좋은 스킬은 ‘웹 작업을 돕는다’처럼 모호한 설명보다 검색, URL 스크래핑, 문서 사이트 크롤링, 구조화 데이터 추출처럼 구체적인 활성화 조건을 적어야 한다. OpenCode가 매 요청에서 이름과 설명을 기준으로 적합한 스킬을 찾기 때문에 설명이 모호하면 호출 시점도 불명확해진다. 파싱, 검증, 정렬처럼 결과가 결정적이어야 하는 작업은 모델 지침에 맡기지 말고 번들 스크립트로 구현하는 것이 더 저렴하고 안정적이라고 글은 권한다. SKILL.md는 짧게 유지하고 예외와 세부 자료는 필요할 때만 읽는 참고 파일로 분리하며, 하나의 스킬에는 하나의 업무만 부여하는 것이 바람직하다. 반대로 비대한 본문, 문서화되지 않은 네트워크 호출, 사용 사례를 파악할 수 없는 예시 부재는 설치 전 경계해야 할 신호다.

6. 추천된 10개 스킬의 역할

Firecrawl은 실시간 검색·스크래핑·크롤링·브라우저 자동화를 제공하고, stop-slop은 문서와 홍보문 등에서 인공지능 특유의 상투적 표현을 찾아 제거한다. Handoff는 현재 세션을 마크다운 문서로 압축해 새 세션이나 다른 에이전트로 넘기며, Grill Me는 코드를 작성하기 전에 계획을 반복적으로 질문해 공동 이해를 확인한다. Obra Superpowers는 브레인스토밍, 작업 트리, 테스트 주도 개발, 하위 에이전트, 체계적 디버깅을 묶고, Understand-Anything은 코드베이스를 퍼지 검색·의미 검색·안내식 탐색이 가능한 지식 그래프로 만든다. Caveman은 기술적 사실을 유지하면서 설명성 문장을 줄여 출력 토큰을 평균 65% 절감한다고 소개되며, skill-optimizer는 과거 세션에서 반복 가능한 절차를 찾아 스킬화하고 기존 스킬을 개인화한다. Vault Daydream은 Obsidian 노트의 무작위 쌍을 하위 에이전트에 보내 뜻밖의 연관성을 찾고, Composio는 MCP·기본 도구·명령줄 인터페이스를 통해 천 개 이상의 서비스 연동 방법을 에이전트에 가르친다.

7. Firecrawl의 웹 데이터 기능

글은 OpenCode에 기본적인 실시간 웹 접근이 없기 때문에 학습 이후 변경된 문서, 라이브러리 변경 기록, 현재 웹페이지를 직접 확인할 수 없다고 설명한다. Firecrawl 스킬은 에이전트가 Firecrawl 명령줄 도구를 설치하고 검색, 스크래핑, 크롤링, 사이트 주소 탐색, 브라우저 상호작용을 자율적으로 수행하도록 안내한다. 검색은 단순한 결과 조각이 아니라 페이지 전체 내용을 제공하고, 스크래핑은 자바스크립트 중심 사이트에서도 정리된 마크다운을 추출하며, 크롤링은 사이트 링크를 재귀적으로 따라간다. 상호작용 기능은 자연어 지시나 Playwright 코드로 실제 브라우저를 조작하고 사용자가 볼 수 있는 실시간 화면도 제공한다. 결과를 문맥 창에 한꺼번에 쏟지 않고 파일에 기록하는 설계는 대규모 웹 자료를 다루는 에이전트 작업에 맞춰져 있다.

8. Firecrawl의 활용 조건과 stop-slop의 문체 교정

Firecrawl은 변경 기록 조사, 경쟁사 가격 페이지 비교, OpenCode 문서 전체에서 플러그인 언급 찾기 같은 작업에 활용할 수 있으며, --all 옵션으로 기기의 여러 코딩 에이전트에 설치하고 --browser 옵션으로 브라우저 인증을 진행할 수 있다. 일부 기능은 키 없이 시험할 수 있지만 지속적인 사용에는 API 키가 필요하고, 월 1,000크레딧의 무료 구간을 넘는 대규모 조사에는 유료 사용이 필요할 수 있다고 글은 밝힌다. 이어 소개되는 stop-slop은 군더더기식 도입부, 업무용 유행어, 과도한 긴 대시, 이분법적 대비, 극적인 문장 파편, 수동태 같은 인공지능 문체의 징후를 분류한다. 이 스킬은 Directness, Rhythm, Trust, Authenticity, Density의 다섯 항목을 각각 1점에서 10점으로 평가하고, 총점이 50점 중 35점보다 낮으면 문장을 수정한다. 코드 작성용 스킬이 아니라 README, 커밋 메시지, 변경 기록, 블로그, 마케팅 문구처럼 실제로 공개할 산문을 다듬는 ‘선호도 인코딩’형 스킬로 제시된다.

🧾 핵심 주장 / 시사점

• 많은 스킬을 설치하는 것보다 설명을 구체적으로 작성해 정확한 순간에 호출되도록 만드는 일이 스킬 라우팅 품질에 직접 영향을 준다.
• 실시간 공개 웹은 Firecrawl, SaaS API는 Composio처럼 정보 원천별 역할을 분리하면 서로 다른 통합 도구의 책임과 적용 범위를 명확히 할 수 있다.
• 외부 스킬은 마크다운 파일이라고 해서 자동으로 안전한 것이 아니므로, 설치 전에 SKILL.md와 포함된 모든 스크립트 및 네트워크 호출을 검토하고 권한 정책으로 노출 범위를 제한해야 한다.

✅ 액션 아이템

• 추천 10개 스킬을 구체 실행 조건·단일 책임·스크립트 분리 기준으로 비교해 설치 우선순위를 정한다.
• 설치 후보마다 스킬과 플러그인 역할을 구분하고 지침·스크립트·네트워크 호출 범위를 점검한다.
• 파싱·검증·정렬 같은 결정적 작업을 스킬 본문에서 분리해 스크립트로 둘 경계를 정의한다.

❓ 열린 질문

• 이름·설명만 상시 노출하는 점진적 로딩에서 문맥 절감 효과를 어떤 기준으로 판단할 것인가?
• Firecrawl과 stop-slop 외에 웹 접근·문체 교정 요구를 단일 책임 스킬로 나눌 경계는 어디인가?
• 모델 의존 실행 대비 스크립트 분리가 비용·오작동을 줄이는 조건은 무엇인가?