작성자 주: VibeHub Skill은 구어체를 Agent가 바로 실행할 수 있는 요구사항으로 바꿔 주고, 한 번에 최대 3개의 관련 용어만 보충해요. 이 글에서는 설치 방법, 두 가지 기능의 사용법, Token이 실제로 어디에 쓰이는지, 그리고 모델 요청을 APIYI에 연결하는 방법을 설명해요.
먼저 결론부터 말하면: VibeHub는 여러분의 구어체를 정확하게 다듬는 역할을 하고, Token은 Agent가 호출하는 모델에 쓰이지 VibeHub 자체 조회에는 쓰이지 않아요.
Agent로 Vibe Coding을 할 때 흔히 겪는 상황이 두 가지 있어요. 첫 번째는 “이 버튼에 마우스를 올리면 색이 변하고, 클릭하면 피드백도 있어야 해”라고 말했는데 Agent가 잘못 이해해서 결과물이 맞지 않는 경우예요. 두 번째는 Agent의 답변에 Tooltip, Hover, 낙관적 업데이트 같은 용어가 튀어나와서 무슨 말인지 모르겠고, 다음에 뭐라고 답해야 할지도 모르는 경우죠. VibeHub Skill은 이 두 문제를 다루는데, 명확한 경계가 하나 있어요. 한 번에 정말 관련 있는 용어 3개까지만 보충한다는 거예요.
이건 여러분에게 프론트엔드 수업을 열어 주는 게 아니에요. 리포지토리 README에 명시되어 있듯이, 학습 로드맵이나 커리큘럼, 로컬 실습을 제공하지 않고, 간단한 요구사항 한 줄을 튜토리얼로 확장하지도 않아요.
이 글을 읽고 얻을 수 있는 것: Agent에게 바로 보낼 수 있는 설치 문장 한 줄, 두 기능 각각의 사용법과 경계, “이 Skill 자체는 API Key를 받지 않는다”와 “이걸 설치한 Agent는 여전히 모델 Token을 소비한다”의 차이, 그리고 Agent의 Token을 APIYI에 연결할 때 OpenAI 호환과 Anthropic 네이티브에 각각 어떤 주소를 쓰는지예요.
VibeHub이란 무엇인가: Agent가 구어를 이해하도록 돕는 Vibe Coding 용어 도감
VibeHub의 사이트는 vibe-hub.org이고, 중국어 첫 페이지의 콘셉트는 “Vibe Coding 용어 도감, 쉬운 말로 프론트엔드·백엔드·AI 용어를 정확히 짚어 준다”예요. 내비게이션 바에는 용어, 연습, 강좌, AI 티 없애기, 업데이트, Skill, 커뮤니티 그룹이라는 몇 개의 입구가 있어요. 저자는 Oil이고, 개인 사이트와 GitHub 프로필은 글 말미의 참고 자료에서 확인할 수 있어요.
사이트 안에는 Vibe Coding 자체에 대한 항목도 있어요: 자연어로 AI에게 요구를 표현하면 AI가 코드를 작성하고, 다시 실행 결과에 따라 끊임없이 반복 개선하는 것인데, 중국어에서는 흔히 ‘분위기 프로그래밍’, ‘느낌대로 프로그래밍’이라고도 불러요. 항목 안에는 기억해 둘 만한 문장이 하나 있어요: 실행된다고 해서 신뢰할 수 있는 건 아니며, 출시 전에는 여전히 코드와 테스트, 권한을 점검해야 한다는 것. 이 문장은 뒤에서 언급할 모든 Agent 워크플로에도 똑같이 적용돼요.
| 항목 | 설명 | 당신에게 주는 가치 |
|---|---|---|
| 사이트 | vibe-hub.org, 시각화 용어 도감 (Skill 소개 페이지 원문: 360개의 시각화 용어) | 낯선 개념을 만나면 쉬운 말 설명을 찾아볼 수 있어요 |
| Skill 저장소 | GitHub oil-oil/vibe-hub-skill, MIT 라이선스 |
Agent가 대화 중에 용어 규칙을 자동으로 사용하도록 해요 |
| 기능 1 | 표현 정규화: 구어를 바로 전송할 수 있는 요구로 다시 써 줘요 | Agent의 이해 편차를 줄여요 |
| 기능 2 | 능동적 알림: 한 번에 최대 3개의 관련 용어를 짚어 줘요 | 답변을 이해하고 다음에 뭐라고 말할지 알 수 있어요 |
| 비용 경계 | Skill 자체는 계정과 API Key를 설정하지 않아요 | Token은 Agent가 호출하는 모델에만 쓰여요 |
VibeHub Skill과 VibeHub 사이트의 역할 분담
둘의 역할 분담은 저장소 README에 아주 명확히 적혀 있어요: 용어 콘텐츠는 vibe-hub.org가 유지·관리하고, 저장소는 표현 규칙과 용어 파서만 보관해요. 즉, 사이트는 “이 단어가 무슨 뜻이고 어떤 그림을 붙이는지”를 담당하고, Skill은 “언제 이 단어를 언급해야 하는지, 당신의 말을 어떻게 다시 쓸지, 링크는 어디서 오는지”를 담당해요.
저장소 skills/vibehub/ 디렉터리에는 네 개의 파일이 있어요: SKILL.md는 표현 규칙을 정의하고, agents/openai.yaml은 Agent 호스트를 위한 설정이며, scripts/vibehub.mjs는 용어 파싱 스크립트, vibehub.config.json은 파서 설정이에요. Skill 전체에는 모델 호출 로직이 포함되지 않는데, 이 점이 뒤에서 말할 Token의 귀속을 결정해요.
VibeHub Skill을 1분 만에 설치하는 방법
설치에는 계정 등록도, 어떤 API 키 입력도 필요 없어요. README에 적힌 구성 조건을 보면 전제는 두 가지뿐이에요. 로컬에 Node.js 20 이상이 있어야 하고, 인터넷에 연결되어 있어야 해요.
VibeHub Skill 설치 방법 두 가지
- 방법 1: 에이전트에 한 문장으로 보내기 (Skill 소개 페이지 원문):
https://github.com/oil-oil/vibe-hub-skill 帮我安装这个仓库里的 skills/vibehub Skill。 - 방법 2: skills 명령으로 설치하기 (저장소 README 원문):
npx skills add oil-oil/vibe-hub-skill - 설치 후: 에이전트 호스트가 Skill을 다시 로드하면 새 대화에서 바로 적용돼요.
첫 번째 방법은 터미널을 직접 다루고 싶지 않은 분께 맞아요. 문장 전체를 에이전트 대화창에 붙여넣기만 하면, 에이전트가 가져오기와 배치를 알아서 처리해요. 두 번째 방법은 명령줄에 익숙한 사용자에게 적합하고, 결과는 같아요. 두 방법 모두 API 키를 입력하라고 요구하지 않아요. 이 Skill은 자체 포함된 용어 파싱 스크립트만 실행하기 때문이에요.
| 구성 항목 | VibeHub Skill의 요구 사항 | 출처 |
|---|---|---|
| 실행 환경 | Node.js 20 이상 | 저장소 README 원문 |
| 네트워크 | 인터넷 연결 필요(vibe-hub.org 용어 조회) | 저장소 README 원문 |
| 계정 / API 키 | 계정 또는 API 키 구성 없음 | 저장소 README 원문 |
| 라이선스 | MIT | 저장소 README 원문 |
| 파싱 명령 형태 | node skills/vibehub/scripts/vibehub.mjs resolve, 하나 이상의 --query 추가, --compact 추가 가능 |
저장소 README 원문 |
VibeHub 용어 조회는 어떻게 나가나요?
파서는 요구 문장 전체를 검색 인터페이스에 그대로 넘기지 않아요. 흐름은 이래요. 에이전트가 먼저 현재 문맥을 바탕으로 후보 용어를 추론한 뒤, 한 번의 일괄 조회로 이름과 링크를 검증해요. 확신도가 높을 때는 하나만 조회하고, 모호할 때는 최대 세 개를 비교해요.
링크 규칙은 꽤 엄격해요. 파서가 반환한 url만 사용하고, 임의로 이어 붙이거나 만들어 내지 않아요. 일치하는 항목이 없으면 그대로 설명하고, 용어와 링크를 지어내지 않아요. 그래서 답변에서 보이는 VibeHub 링크는 모두 조회 인터페이스가 실제로 반환한 거예요.
🚀 빠른 시작 팁: VibeHub를 설치하면 에이전트가 매 라운드의 재작성과 설명에서 대규모 언어 모델을 한 번씩 호출해요. 여러 에이전트에서 하나의 API 키를 공유하고 청구 내역을 한곳에서 보고 싶다면, 먼저 APIYI(apiyi.com)에 계정을 등록하고, 가입 후 받은 소량의 체험 크레딧으로 흐름을 먼저 검증해 보세요.
VibeHub의 두 가지 기능: 구어체를 정확하게 바꾸고, 최대 3개 용어 보충
Skill 소개 페이지는 기능을 2가지 핵심 기능으로 정리해요. 아래에서는 소개 페이지에 있는 예시를 하나씩만 사용해 설명하고, 추가로 확장하지 않아요.
기능 1: VibeHub가 구어체를 Agent가 바로 실행할 수 있는 요구사항으로 바꿔줘요
원래 말은 「이 버튼 마우스 올리면 색 좀 변하고, 클릭하면 뭔가 반응이 있어야 해.」였어요.
재작성 결과는 「버튼에 Hover 상태와 Active 상태를 추가하고, Transition을 사용해 상태 변화가 더 자연스럽게 느껴지도록 해주세요.」였어요. 세 용어는 페이지에서 각각 vibe-hub.org의 /hover, /active, /transition 항목으로 링크돼요.
이 단계의 핵심은 원래 의도 유지예요. Skill은 프레임워크나 파라미터, 구현 방식을 임의로 추가하지 않아요. 예를 들어 색상 값을 대신 정하거나 애니메이션 길이를 결정하거나 UI 라이브러리를 바꾸지 않아요. 여러분이 받는 건 Agent에게 바로 보낼 수 있는 한 문장의 요구사항이고, 의미는 원래 말하려던 것과 같아요. 다만 표현이 Agent가 오해하기 어려운 말로 바뀐 거예요.
기능 2: VibeHub가 당신이 꼭 알아야 할 용어를 먼저 짚어줘요
원래 말은 「이 설정은 바꾸면 바로 적용됐으면 좋겠어, 저장 버튼을 또 누르고 싶지 않아.」였어요.
Skill은 Switch를 알려줘요. 켜기와 끄기 두 상태만 있고 수정 후 즉시 적용되는 상황에 적합하고, 여러 항목을 먼저 고친 뒤 한꺼번에 확인해야 한다면 이렇게 설계하면 안 된다는 거예요. 이 설명은 현재 작업에 바로 붙어서 언제 쓰고 언제 쓰지 말지를 알려주지, 백과사전식 정의를 주지는 않아요.
능동적 안내에는 세 가지 규칙이 있어요(Skill 소개 페이지 원문):
- 용어가 처음 등장할 때 VibeHub로 링크
- 설명은 현재 작업에 바로 붙이고, 백과사전 정의는 하지 않음
- 한 번에 최대 3개의 실제로 관련 있는 용어만 안내
| 비교 항목 | 기능 1: 표현 규범화 | 기능 2: 능동적 안내 |
|---|---|---|
| 트리거 시점 | 요구 표현이 모호할 때 | 요구 뒤에 아직 말하지 않은 설계 개념이 있을 때 |
| 출력 내용 | 바로 전송할 수 있는 재작성 요구 한 문장 | 1~3개 용어 + 작업에 밀착한 설명 |
| 예시 용어 | Hover, Active, Transition | Switch |
| 하지 않는 일 | 프레임워크·파라미터·구현 방식 임의 추가 | 백과사전 정의, 용어집을 끝까지 설명 |
| 다음 단계 | 확인 후 Agent에게 바로 전송 | 설계가 적합한지 판단한 뒤 표현 방식 결정 |
Agent 응답이 이해 안 될 때, VibeHub로 핵심 개념만 설명받기
Agent 응답에 Tooltip, 낙관적 업데이트 같은 단어가 갑자기 나오면, 원래 문장을 그대로 붙여넣으면 돼요. README에 따르면 다음 단계 판단에 가장 영향을 주는 개념만 설명하고, 문단 전체를 단어별로 번역하지도, 자동으로 강의를 열지도 않아요.
README의 작업 원칙은 네 가지로 요약할 수 있어요. 바로 쓸 수 있는 결과를 먼저 주고 용어는 나중에 설명하기, 사용자의 원래 의도 유지하기, 한 번에 최대 1~3개 용어만, 표현이 이미 정확하면 굳이 교육을 덧붙이지 않기예요. 마지막 원칙이 참 실용적이에요. 원래부터 명확하게 말했다면, 굳이 끼어들지 않아요.
VibeHub Skill의 Token, 대체 어느 단계에서 쓰일까요?
이 부분이 가장 헷갈리기 쉬운 지점이에요. VibeHub Skill 자체는 API 키를 받지 않고, 용어 조회도 대규모 언어 모델을 호출하는 게 아니에요. 파싱 스크립트는 vibe-hub.org에 일괄 조회를 한 번 보내서 용어 이름과 링크만 받아오죠.
실제로 Token을 소모하는 건 이 Skill을 설치한 Agent예요. 여러분의 구어체를 다듬고, 용어를 쉬운 말로 설명한 뒤, 이어서 페이지까지 만드는 세 단계가 모두 모델 호출이에요. Skill은 이런 호출의 입력과 출력을 더 정확하게 만들어 주지만, 비용을 대신 부담하지는 않아요. 호출 자체도 사라지지 않고요.
| 단계 | 실행 주체 | 대규모 언어 모델 호출 여부 | 모델 Token 소모 여부 |
|---|---|---|---|
| 후보 용어 추론 | Agent | 예 | 예 |
| 용어와 링크 일괄 조회 | VibeHub 파싱 스크립트 → vibe-hub.org | 아니요 | 아니요 |
| 구어체 요구사항 재작성 | Agent | 예 | 예 |
| 쉬운 말로 용어 설명 | Agent | 예 | 예 |
| 요구사항에 따라 코드 작성, 페이지 수정 | Agent | 예 | 예 |
그래서 충전하거나 모델을 고를 때 대상이 되는 건 Agent 뒤의 모델 서비스예요. VibeHub 웹사이트에 계정을 개설하는 게 아니에요. help-apiyi에 이미 《Agent 장기 작업의 Token 청구서는 어디서 오나요?》라는 글이 있어서, 장기 작업에서 프리픽스 캐시가 청구서에 어떻게 영향을 주는지 자세히 다뤘으니 여기서는 더 풀어내지 않을게요.
위 그림이 말하는 결론은 이래요: Agent의 모델 요청은 APIYI(apiyi.com)로 연결할 수 있고, 하나의 Key와 같은 잔액으로 Claude 계열과 GPT 계열 모델을 동시에 커버할 수 있어요. VibeHub 쪽은 아무것도 바꿀 필요가 없고요.
APIYI로 모델 조회·가격 확인하고 Agent 요청을 연결하기
APIYI는 API 게이트웨이예요. 모델을 직접 호스팅하는 곳은 아니에요. 하나의 키와 같은 잔액으로 여러 벤더의 모델을 호출할 수 있어요. 계정은 직접 가입해야 하고, 가입하면 소량의 체험 크레딧이 제공돼요. 플랫폼에는 무료 모델 라우팅이 없어요. 전체 모델과 가격은 모델 총표 docs.apiyi.com/models에서 확인할 수 있고, 데이터는 시스템의 실시간 가격 API에서 가져와요.
엔드포인트는 모델이 아니라 SDK 기준으로 선택해요
Agent의 요청을 APIYI로 연결할 때는 먼저 Agent가 어떤 SDK를 쓰는지 확인하고, 그에 맞는 주소를 넣어요:
- OpenAI 호환: base_url에
https://api.apiyi.com/v1을 넣어요. Chat Completions는/v1/chat/completions로, Responses는/v1/responses로 가요. - Anthropic 네이티브: base_url에는 루트 도메인
https://api.apiyi.com을 넣고,/v1을 다시 붙이지 마세요. 그러지 않으면/v1/v1/messages로 조합돼 404가 반환돼요. Messages 엔드포인트는/v1/messages예요. - 노드 선택:
api.apiyi.com은 기본 노드이고,b.apiyi.com은 대체 및 기업 시나리오에 사용해요.api-cf.apiyi.com은 텍스트만 지원하며 타임아웃 상한이 약 100초라 긴 작업에는 적합하지 않아요.
문서에서는 OpenAI GPT-5 이후 모델은 Responses를 우선 사용하라고 권장해요. Claude Code, Codex 등 여러 Agent를 함께 쓰고 있다면, help-apiyi의 “한 단계씩 따라하기: 하나의 Key로 모든 Agent 연결하기, 오픈소스 magpie로 API 게이트웨이 통합 연결”에서 통합 연결 방법을 다뤄요.
Vibe Coding 자주 쓰는 모델 가격(총표 원문)
아래 표의 데이터는 2026-11-13 12:57 (UTC+8) 기준으로 업데이트되었고, 단위는 100만 tokens당 미국 달러이며, APIYI apiyi.com 모델 총표 원문에서 가져왔어요. 충전은 1:7 고정 환율을 적용하고, 그룹별 실제 할인 가격은 로그인 후 콘솔에서 확인할 수 있어요. 이번 모델들의 ‘최저’ 열은 ‘—’예요.
| 모델 ID | 입력 | 출력 | 캐시 읽기 | 엔드포인트 | 그룹 |
|---|---|---|---|---|---|
claude-opus-5-5 |
$4 | $20 | $0.2 | chat, messages | ClaudeCode, Claude_Reverse, Claude_Enterprise, Default, SVIP |
claude-sonnet-5-5 |
$2 | $10 | $0.1 | chat, messages | ClaudeCode, Claude_Reverse, Claude_Enterprise, Default, SVIP |
claude-fable-5-2 |
$8 | $40 | $0.2 | chat, messages | ClaudeCode, Claude_Enterprise, Default, SVIP |
gpt-6.1-sol † |
$2 | $10 | $0.1 | responses(권장), chat | CodexResponses, Codex_Reverse, Default, SVIP |
gpt-6.1-terra |
$1 | $5 | $0.05 | responses(권장), chat | CodexResponses, Codex_Reverse, Default, SVIP |
몇 가지 보충 설명을 ID별로 나눠서 알려드릴게요.
claude-opus-5-5,claude-sonnet-5-5,claude-fable-5-2에는 각각 같은 가격의-thinking버전이 있어요.claude-fable-5-2는 총표의 그룹에 Claude_Reverse가 없어요. 그룹을 선택할 때 주의하세요. 앞의 두 Claude 모델 그룹을 그대로 적용하면 안 돼요.gpt-6.1-sol에는 †가 붙어 있는데, 계단식 요금이에요. 총표 원문: 0~272,000 tokens 입력 $2/1M, 272,000 tokens 초과 입력 $4/1M.gpt-6.1-sol과gpt-6.1-terra는/v1/responses사용을 권장하고, 도구 호출도 Responses로 처리해요.
💡 선택 팁: VibeHub의 리라이팅과 용어 설명은 짧은 대화라서 모델 성능에 대한 요구가 높지 않아요. 실제로 Token을 많이 쓰는 건 뒤에 코드를 작성하는 긴 작업이에요. APIYI apiyi.com에서 같은 Key로 여러 모델을 각각 시험해 보고, 같은 요구사항에서 효과와 청구서를 비교한 뒤 일상적으로 어떤 모델을 쓸지 결정하면 좋아요.
Agent가 연동 방식을 스스로 읽게 하고 싶다면, APIYI의 연동 스킬 패키지를 Agent에 넣을 수 있어요: npx skills add https://docs.apiyi.com, 스킬 패키지 설명은 docs.apiyi.com/skill.md에 있어요.
VibeHub 사용 시 프라이버시와 위험의 경계
위험은 두 층으로 나눠서 봐야 해요. 하나는 VibeHub의 용어 조회이고, 다른 하나는 Agent 자체의 모델 호출이에요.
VibeHub 용어 조회 계층: 저장소 README에 따르면, 용어 조회는 프로그램으로 민감 정보를 걸러낸 짧은 설명만 전송해요. 흔히 등장하는 키, URL, 이메일, 로컬 경로, 코드 블록은 전송 전에 제거되고, 소스 코드나 고객 정보, 요구사항 전체는 보내지 않아요. vibe-hub.org로 전달되는 건 “버튼 호버 상태” 같은 짧은 용어 정도예요.
Agent와 모델 계층: Agent가 이미 읽어들인 프로젝트 컨텍스트는 여전히 여러분이 사용하는 제품과 모델 서비스 제공업체의 프라이버시 설정에 따라 제약을 받아요. VibeHub의 민감 정보 제거는 자신이 보내는 용어 조회에만 적용될 뿐, Agent가 모델로 보내는 내용에는 관여할 수 없어요.
- API 키를 대화에 붙여넣지 마세요. 키는 채팅 내용으로 모델에 보내는 게 아니라 Agent 설정이나 환경 변수에 넣어야 해요.
- APIYI의 정체는 API 게이트웨이예요. 계정 풀이 아니고 로그인 우회 도구도 아니며, 호출은 정상적인 API 과금 경로를 따라요.
- 출시 전에 직접 점검하세요. Vibe Coding 항목에서 이야기했듯이, 실행된다고 해서 신뢰할 수 있는 건 아니에요. 코드, 테스트, 권한은 여전히 여러분이 한 번 훑어봐야 해요.
자주 묻는 질문 FAQ
Q1: VibeHub는 무엇인가요?
VibeHub(vibe-hub.org)는 개발자 Oil이 관리하는 Vibe Coding 용어 도감으로, 프런트엔드, 백엔드, AI 용어를 쉬운 말로 풀어 설명해 줘요. 함께 제공되는 VibeHub Skill을 Agent에 설치하면 여러분의 구어체 표현을 정확한 요구사항으로 다듬어 주고, 한 번에 최대 3개의 관련 용어를 짚어 줘요.
Q2: VibeHub Skill에 API Key를 입력해야 하나요?
아니요, 필요 없어요. 저장소 README 원문에 ‘계정이나 API Key 설정 없음’이라고 명시되어 있고, Node.js 20 이상 버전과 인터넷 환경만 있으면 돼요. Key가 필요한 건 여러분의 Agent가 호출하는 대규모 언어 모델이고, 그 Key는 APIYI apiyi.com의 토큰을 사용할 수 있으며 VibeHub와는 무관해요.
Q3: VibeHub와 Agent에게 직접 용어 설명을 요청하는 것의 차이는 무엇인가요?
Agent에게 직접 설명을 요청하면 한 번에 많은 내용을 쏟아내거나 스스로 만든 링크를 줄 수도 있어요. VibeHub는 한 번에 최대 1~3개의 용어로 제한하고, 설명은 현재 작업에 밀접하게 붙으며, 링크는 파서가 반환한 url만 사용하고, 찾지 못하면 찾지 못한다고 말할 뿐 지어내지 않아요. 표현이 이미 정확하면 굳이 설명을 덧붙이지도 않아요.
Q4: VibeHub는 어떤 상황에 적합한가요?
– 상호작용 효과를 설명하고 싶은데 Hover, Active 같은 이름이 떠오르지 않을 때
– 어떤 설정을 즉시 적용되는 Switch로 만들지, 아니면 일괄 저장으로 할지 확신이 없을 때
– Agent의 답변에 이해가 안 되는 개념이 있어서 다음 질문을 어떻게 이어갈지 막막할 때
학습 로드맵이나 강좌는 제공하지 않아요. 체계적으로 배우고 싶다면 웹사이트의 강좌와 연습 메뉴를 이용하세요.
Q5: VibeHub를 설치한 뒤 Agent의 모델 요청을 APIYI로 연결하려면 어떻게 하나요?
1. APIYI apiyi.com에서 직접 계정을 등록하고 API Key와 소량의 체험 쿼터를 받으세요.
2. OpenAI 호환 SDK의 base_url에 `https://api.apiyi.com/v1`을 입력하세요.
3. Anthropic 네이티브 SDK는 루트 도메인 `https://api.apiyi.com`을 입력하고, `/v1`을 추가하지 마세요.
VibeHub 쪽은 아무 설정도 바꿀 필요가 없어요.
Q6: VibeHub가 제 코드를 외부로 전송하나요?
README에 따르면 용어 조회 시에는 익명 처리된 짧은 설명만 전송하고, 키, URL, 이메일, 로컬 경로, 코드 블록은 전송 전에 제거하며, 소스 코드나 요구사항 전체를 보내지 않아요. 다만 Agent가 보는 프로젝트 컨텍스트는 여러분이 선택한 모델 서비스 제공자의 정책에 따라 처리되므로, 이 부분은 별도로 평가해야 해요.
Q7: VibeHub에는 어떤 제약이 있나요?
인터넷과 Node.js 20 이상 버전이 필요하고, 용어 범위는 vibe-hub.org에 수록된 것에 한정되며, 일치하는 단어가 없으면 억지로 만들지 않아요. 또 표현과 용어만 담당할 뿐, 구현 방안을 대신 결정해 주지도 않고, Agent가 작성한 코드의 신뢰성을 보장하지도 않아요.
VibeHub Skill 핵심 요점 Key Takeaways
- 한 줄 정의: VibeHub는 구어체를 정확하게 다듬고, Token은 Agent가 호출하는 모델에 사용해요.
- 두 가지 설치 방법: Agent에게 설치 문구를 보내거나,
npx skills add oil-oil/vibe-hub-skill을 실행하면 돼요. - 기능 1: 표현을 표준화하고 원래 의도를 유지하며, 임의로 프레임워크나 파라미터를 추가하지 않아요.
- 기능 2: 능동적으로 안내하며, 매번 최대 3개의 실제로 관련 있는 용어만 제시해요.
- 비용 경계: Skill에는 API 키가 필요 없고, 용어 조회는 대규모 언어 모델을 호출하지 않아요.
- APIYI 연동: OpenAI 호환은
/v1을, Anthropic 네이티브는 루트 도메인을 사용해요. - 프라이버시 계층화: 용어 조회는 비식별화되지만, Agent의 컨텍스트는 여전히 선택한 모델 서비스 제공자를 거쳐요.
요약
VibeHub가 Vibe Coding에서 해결하는 것은 ‘정확하게 말하지 못함’과 ‘이해하지 못함’ 두 가지예요:
- 구어체를 정확하게 다듬기: 예를 들어 ‘마우스를 올리면 색이 변하고, 클릭하면 피드백이 생긴다’는 Hover, Active, Transition 세 용어로 구성된 요구사항으로 재작성돼요;
- 딱 필요한 만큼만: 매번 최대 3개의 용어만 보충하고, 설명은 현재 작업에 밀착하며, 강의를 열지 않아요;
- 비용 구분: Skill 자체는 키를 받지 않고 모델을 호출하지 않으며, Token은 모두 Agent의 재작성, 설명, 코드 작성 이 세 단계에 사용돼요.
설치는 한 문장이면 충분해요. 진짜로 당신이 결정해야 할 것은 Agent 뒤에 어떤 모델을 연결하고, 어느 엔드포인트를 사용할지예요. APIYI apiyi.com에서 하나의 키로 위 표의 여러 모델을 비교한 뒤, Agent의 요청을 그쪽으로 보내면 돼요. 모델과 가격은 플랫폼의 모델 목록을 기준으로 해요.
📚 참고 자료
- VibeHub 공식 사이트: Vibe Coding 용어 도감
- 링크:
vibe-hub.org -
설명: 용어, 연습, 강좌 진입점이며 Vibe Coding 항목은
vibe-hub.org/vibe-coding에 있어요 -
VibeHub Skill 소개 페이지: 두 가지 핵심 기능과 설치 안내 원문
- 링크:
vibe-hub.org/vibehub-skill -
설명: 규범적 표현과 능동적 안내의 예시 출처
-
GitHub – vibe-hub-skill: Skill 저장소
- 링크:
github.com/oil-oil/vibe-hub-skill -
설명: README와 SKILL.md, 조회 방식과 프라이버시 및 구성 경계를 포함해요
-
작성자 Oil: 개인 사이트와 GitHub
- 링크:
oiloil.org,github.com/oil-oil -
설명: VibeHub 작성자 홈페이지
-
APIYI 모델 총표: 모델명, 엔드포인트, 그룹과 가격
- 링크:
docs.apiyi.com/models -
설명: 데이터는 2026-11-13 12:57 (UTC+8)에 업데이트되었으며, 단위는 100만 tokens당 달러예요
-
APIYI 문서 진입점과 연동 스킬 패키지
- 링크:
docs.apiyi.com/llms.txt,docs.apiyi.com/skill.md - 설명: 엔드포인트 선택, 노드 설명과 Agent 연동 방식
작성자: APIYI 기술팀
기술 교류: APIYI apiyi.com 웹사이트 홈에서 저희에게 연락해 주세요. 더 많은 연동 자료는 docs.apiyi.com 문서 센터에서 확인할 수 있어요
