opencode-guide

[시니어 직장인의 AI 탐구기 #09] 바퀴를 다시 발명하지 마라! 스마트 검색 스킬 ‘research-first’ 초보자 설치 및 실전 활용 가이드

“새로운 업무나 프로그램을 만들 때, 맨땅에서 처음부터 코딩하고 계신가요?”
전 세계의 수많은 전문가들이 이미 검증해 둔 훌륭한 오픈소스 도구와 템플릿이 넘쳐납니다. 5분만 먼저 검색(Research)하면 수일의 삽질과 야근을 줄일 수 있습니다.

안녕하세요. 시니어 회사원의 눈높이에서 가장 쓸모 있는 AI 도구 활용법을 나누는 블로그의 아홉 번째 글입니다.

지난 08편에서는 /connect 명령어로 세계 최강 AI 두뇌(구글 제미나이, ChatGPT, 오픈코드 콘솔)를 하나로 묶었습니다. 이제 이 똑똑해진 AI 비서에게 ‘일 잘하는 전문가의 일머리 습관’을 장착해 줄 차례입니다.

오늘 소개해 드릴 research-first는 AI가 사용자의 지시를 받자마자 무작정 코드나 문서를 마구 작성하기 전에, “이미 검증된 오픈소스 도구, 라이브러리, 템플릿, 데이터셋이 있는지 먼저 철저하게 조사한 뒤 가장 최적의 지름길을 제안하도록 강제하는 핵심 스킬(Skill)”입니다.

현재 내 오픈코드에 이 스킬이 설치되어 있지 않더라도 전혀 걱정하실 필요가 없습니다. 깃허브(GitHub)에서 주소를 복사해 오픈코드 대화창에 알려주기만 하면 AI가 알아서 내 PC에 설치해 주는 가장 스마트한 방법을 안내해 드립니다.

1. ‘research-first’ 스킬이란 무엇이며 왜 필수인가요?

일 못하는 직원은 무언가 지시를 받으면 기존에 만들어진 회사 양식이나 도구를 찾아보지도 않고 맨 처음부터 혼자 고군분투하다가 시간만 낭비합니다. 반면, 일 잘하는 시니어는 “누군가 이미 잘 만들어 둔 것이 있는지”를 먼저 찾아서 200% 활용합니다.

research-first 스킬은 바로 이러한 “검증된 기존 자원 우선 탐색(Don’t Reinvent the Wheel)” 원칙을 AI에게 가르치는 두뇌 확장 패치입니다.

[비교] 일반 AI vs ‘research-first’ 스킬이 장착된 AI

비교 항목	일반 AI의 응답 방식	‘research-first’ 장착 AI의 응답 방식
지시 수신 직후	생각 없이 수백 줄의 코드를 즉시 작성 시작	전 세계 GitHub, 오픈소스, 라이브러리를 먼저 5분간 검색
작업 방식	바닥부터 복잡하게 자체 제작 (오류 가능성 높음)	이미 검증된 인기 도구와 표준 템플릿을 조합해 제안
결과물의 품질	유지보수가 어렵고 버그 발생 위험 높음	안정성이 높고, 업데이트가 활발한 업계 표준 방식 적용
소요 시간	디버깅과 수정에 며칠씩 낭비	5분 사전 조사로 전체 작업 시간 80% 이상 단축

2. 오픈코드 스킬 설치 경로 이해하기 (Global vs Project)

오픈코드는 특정 폴더에 규칙에 맞는 파일(SKILL.md)만 넣어두면 프로그램을 껐다 켤 필요도 없이 실시간으로 새 스킬을 자동 감지합니다.

구분	설치 위치 (Mac / Linux 기준)	추천 대상 및 장점
전역 설치 (Global) (적극 권장!)	`~/.config/opencode/skills/research-first/`	컴퓨터 내의 모든 프로젝트와 폴더에서 항상 이 스킬을 자동으로 사용 가능
프로젝트 전용 (Project)	`현재폴더/.opencode/skills/research-first/`	현재 열려 있는 특정 프로젝트 폴더 안에서만 제한적으로 사용

초보자분들은 한 번만 설치해 두면 어떤 업무를 하든 평생 써먹을 수 있는 전역(Global) 설치 방식을 강력히 추천합니다.

3. [초보자 추천] 깃허브(GitHub) 주소 복사로 오픈코드 안에서 10초 만에 설치하기

복잡한 터미널 명령어를 외우거나 파일을 일일이 수동으로 만들 필요가 없습니다. 오픈코드는 파일 생성과 명령어 실행 능력을 갖춘 자율 에이전트이므로, 깃허브 주소를 알려주고 설치해 달라고 말하면 스스로 알아서 끝마칩니다.

설치 3단계 워크플로우

[1단계: 웹 브라우저]          [2단계: 오픈코드 대화창]              [3단계: 오픈코드 자동 설치]
깃허브(GitHub) 검색       ──>  저장소 URL 복사 후               ──>  AI가 자동으로 다운로드 &
원하는 스킬 주소 확인          "이 주소로 스킬 설치해줘" 지시         전역 폴더에 완벽 배치 완료!

1단계: 깃허브(GitHub)에서 스킬 주소 복사하기

웹 브라우저를 열고 깃허브(GitHub)에서 research-first 스킬 저장소로 이동합니다.
검증된 공식 오픈소스 저장소 주소는 다음과 같습니다:
- 👉 저장소 URL: https://github.com/niveku/skill-research-first
브라우저 주소창의 URL을 마우스로 드래그하여 복사(Cmd + C / Windows: Ctrl + C)합니다.

2단계: 오픈코드 대화창에 주소를 알려주고 설치 지시하기

오픈코드 하단 프롬프트 입력창(Composer)에 방금 복사한 깃허브 주소와 함께 아래와 같이 자연어로 지시합니다:

💬 초보자 추천 복사 프롬프트:
“아래 깃허브 저장소에 있는 research-first 스킬을 내 컴퓨터 전역 스킬 폴더(~/.config/opencode/skills/research-first)에 설치해줘.
저장소 주소: https://github.com/niveku/skill-research-first”

3단계: AI의 자동 다운로드 및 파일 배치

지시를 받은 오픈코드 AI는 깃허브 저장소의 파일 구조(SKILL.md 및 references/ 참조 문서들)를 파악합니다.
내 컴퓨터의 전역 스킬 폴더(~/.config/opencode/skills/research-first)를 생성하고 필요한 스킬 파일들을 온전하게 내려받아 저장합니다.
설치가 끝나면 AI가 “research-first 스킬이 전역 경로에 성공적으로 설치되었습니다”라고 완료 보고를 띄웁니다.

[보너스] 터미널 환경이 편한 사용자를 위한 수동 설치법

터미널 명령어에 익숙하신 분은 오픈코드 우측 Terminal 창(Control + Option + T)에서 Git 명령어로 직접 복제하셔도 됩니다:

# 1. 깃허브 저장소 직접 클론
git clone https://github.com/niveku/skill-research-first.git /tmp/skill-rf

# 2. 전역 스킬 폴더로 복사
mkdir -p ~/.config/opencode/skills/
cp -r /tmp/skill-rf/skills/research-first ~/.config/opencode/skills/
rm -rf /tmp/skill-rf

[확인] 설치가 잘 되었는지 3초 만에 검증하기

설치가 끝난 후 오픈코드 대화창에서 확인하는 방법:

프롬프트 입력창에 @ 기호를 입력합니다.
팝업 목록에 @research-first가 나타나면 설치가 완벽하게 완료된 것입니다!
또는 AI에게 “현재 설치된 스킬 리스트를 보여줘”라고 물어보면 목록에 research-first가 포함되어 출력됩니다.

4. 실전! ‘research-first’ 간단 사용 예제 3가지

research-first는 사용자가 특정 키워드(~만들어줘, 구축해줘, 템플릿 찾아줘 등)를 입력하면 AI가 알아서 백그라운드에서 스킬을 자동 로드하여 일머리 있게 조사부터 시작합니다.

📁 예제 1: 엑셀 취합 자동화 프로그램 요청 시

사용자 질문 (프롬프트):

“우리 팀 매월 결산용 엑셀 파일 20개를 하나로 합치고 오류를 찾아내는 파이썬 프로그램을 하나 만들어줘.”
research-first의 동작:
1. 무작정 복잡한 코드를 길게 짜지 않습니다.
2. 파이썬 생태계에서 가장 신뢰받는 엑셀 라이브러리인 pandas와 openpyxl의 최신 기능, 그리고 GitHub의 오픈소스 엑셀 머지 템플릿을 먼저 탐색합니다.
3. “직접 긴 코드를 짤 필요 없이, 가장 안정적인 pandas 라이브러리의 merge 기능을 사용하면 10줄의 간단한 코드로 완벽히 해결됩니다”라며 가장 효율적인 지름길 코드를 제시합니다.

📄 예제 2: 사내 신규 프로젝트 제안서 템플릿 작성 시

사용자 질문 (프롬프트):

“우리 회사 신규 IT 프로젝트 기획서(PRD)를 작성해야 해. 뼈대 템플릿을 짜줘.”
research-first의 동작:
1. AI가 머릿속으로 지어낸 어설픈 양식을 주지 않습니다.
2. 글로벌 빅테크 기업(Google, Amazon) 및 유명 IT 커뮤니티에서 공인된 표준 PRD(Product Requirement Document) 프레임워크를 검색합니다.
3. 핵심 구성 요소(배경, 목표 지표, 기능 명세, 일정, 리스크 관리)가 완벽히 포함된 최고급 마크다운 템플릿을 한눈에 정리해 줍니다.

🎯 예제 3: 명시적 강제 호출 (가장 확실한 방법)

AI에게 무조건 사전 조사를 철저히 시키고 싶을 때는 문장 맨 앞에 @research-first를 직접 붙여서 질문하세요.

프롬프트 입력 예시:

“@research-first 회사 경비 지출 내역 영수증 사진을 올리면 글자를 자동으로 읽어 엑셀로 바꿔주는 오픈소스나 무료 라이브러리 조합을 조사해서 추천해줘.”
AI의 답변 결과:
- Tesseract OCR, EasyOCR 등 검증된 오픈소스 광학문자인식(OCR) 엔진 비교
- 각각의 장단점(한글 인식률, 속도, 설치 난이도)
- 가장 추천하는 조합과 간단한 실행 파이썬 예제 코드까지 일목요연하게 보고서 형태로 제출

5. 실무 적용을 위한 호출 명령어 & 키워드 요약표

호출 방식	추천 프롬프트 키워드	AI의 실제 반응
자동 감지 호출	“~도구 추천해줘”, “~오픈소스 있어?” “~템플릿 만들어줘”, “~어떻게 구현해?”	AI가 `research-first` 스킬을 자동 감지하여 기존 최적 솔루션을 먼저 검색 후 브리핑
직접 강제 호출	`@research-first` + 질문	다른 작업보다 전 세계 GitHub 및 오픈소스 조사를 최우선으로 강제 실행
스킬 목록 확인	“현재 설치된 스킬 리스트 보여줘”	`research-first`를 포함한 사용 가능한 모든 스킬 목록과 설명 확인

6. 에필로그

스마트한 시니어 직장인의 가장 큰 무기는 ‘직접 모든 것을 손으로 만드는 우직함’이 아니라, ‘이미 존재하는 최고의 도구들을 꿰뚫어 보고 적재적소에 연결하는 안목’입니다.

오픈코드에서는 인터넷에서 좋은 도구나 스킬의 깃허브 주소만 발견하면, 대화창에 주소를 툭 던져주는 것만으로 손쉽게 내 PC에 장착할 수 있습니다. 지금 바로 research-first를 장착하고 질문을 던져보세요. 여러분의 업무 생산성이 완전히 다른 차원으로 도약할 것입니다.

다음 글에서는 “실제 사내 엑셀 원본 파일들을 오픈코드에 통째로 연결하고, 데이터 정제부터 피벗 분석 보고서까지 단 10초 만에 끝내는 실전 데이터 분석 비법”을 함께 진행해 보겠습니다.

작성일: 2026년 10월 31일
태그: #오픈코드 #OpenCode #스킬 #Skills #research_first #GitHub연동 #오픈소스탐색 #직장인생산성 #스마트워크 #시니어AI #바퀴를재발명하지마라