개발 자동화

  • GitHub AI 에이전트 7개 다 봤는데 하나도 안 깐 이유

    GitHub AI 에이전트 7개 다 봤는데 하나도 안 깐 이유

    소셜 미디어에서 뭔가를 보면 일단 저장부터 한다. 나중에 쓸 것 같아서. 근데 나중이 오는 경우는 드물다.

    이번엔 달랐다. 인스타그램 어딘가에서 AI 에이전트 도구 소개 카드를 봤고, 그냥 넘기지 않았다. 스크린샷을 찍어서 Claude Code한테 바로 물어봤다.

    AI 에이전트 도구 7개, 먼저 검증했던 이유

    처음엔 3개였다. claude-mem, find-skills, VibeSec. 캡처한 카드를 Claude Code에 던지면서 물었다.

    “지금 설치돼 있어? 설치하면 나한테 좋아? 아니면 없어도 돼?”

    그냥 좋아 보인다고 깔면 안 된다는 걸 안다. 도구는 내 상황에 맞아야 쓸 수 있다. 맞지 않는 도구는 설치하는 순간부터 짐이 된다. 그래서 먼저 확인했다.

    확인 과정에서 ponytail, graphify, Ruflo, OmniRoute까지 추가로 검토하게 됐다. 결국 7개를 다 들여다봤다.

    이미 깔려있던 도구들 (claude-mem, find-skills, ponytail, graphify)

    결과부터 말하면, 4개는 이미 있었다.

    claude-mem은 8월 28일부터 설치돼 있었다. find-skills도 이미 스킬로 등록된 상태였다. 몰랐다. 쓰고 있었는데 쓰고 있는 줄 몰랐던 거다.

    ponytail은 좀 달랐다. 설치돼 있는 수준이 아니었다. 그 대화를 하는 내내 실제로 켜져서 작동하고 있었다. 이걸 확인하면서 뭔가 이해됐다. Claude Code가 항상 최소한의 코드로 답하던 게 이상하다고 생각한 적 있었는데, 그게 ponytail 때문이었다. 도구가 조용히 일하고 있었던 거다.

    graphify도 전역 설정(어떤 프로젝트에서도 공통으로 적용되는 설정)에 등록돼 있어서 언제든 쓸 수 있는 상태였다. fire-your-seo-agency 스킬을 블로그 4개에 자동 적용했을 때도 비슷한 걸 느꼈다 — 이미 깔린 걸 제대로 아는 게, 새로 까는 것보다 먼저다.

    AI 에이전트 도구 claude-mem, find-skills, VibeSec, ponytail 설치 여부를 실제 명령어로 확인한 터미널 화면

    이 네 개는 새로 깔 필요가 없었다. 이미 있으니까.

    VibeSec을 안 깐 이유: 내 프로젝트 구조와 안 맞았다

    VibeSec은 웹 취약점(XSS, SQL 인젝션 같은 것)을 잡아주는 보안 도구다.

    XSS(Cross-Site Scripting)는 악성 스크립트를 웹페이지에 심는 공격이고, SQL 인젝션은 데이터베이스 쿼리를 조작하는 공격이다. 로그인 폼, 검색창, 결제 입력칸 같은 데서 주로 생긴다.

    내 프로젝트엔 그런 게 없다. 지금 만드는 건 블로그 자동 생성 스크립트들이다. 사용자 입력을 받는 곳이 없다. 로그인도 없고 결제도 없다. 워드프레스 인증은 앱 비밀번호를 .env.local 파일(환경 변수를 저장하는 파일, 코드에 직접 비밀번호를 적지 않기 위해 사용)에 넣어서 쓰는 정도다.

    VibeSec이 잡아줄 취약점 자체가 생길 구조가 아니었다. 좋은 도구지만 내 상황엔 맞지 않는다. 그래서 안 깔았다.

    Ruflo, OmniRoute가 과했던 이유

    Ruflo는 스웜 오케스트레이션(swarm orchestration, 여러 AI 에이전트를 동시에 무리 지어 운영하는 방식) 프레임워크다.

    근데 확인해보니 사실 claude-flow라는 기존 프로젝트를 이름만 바꾼 거였다. 버전이 385개나 찍혀 있었다. 60개 넘는 에이전트를 동시에 굴리는 구조인데, 내 작업은 프로젝트마다 4~5개 역할이 정해진 순서대로 도는 방식이다. Ruflo가 필요한 상황이 아니었다. 이름을 바꿨다고 다른 도구가 되는 건 아니다.

    OmniRoute는 다른 방향에서 과했다. 여러 AI 제공사(OpenAI, 앤트로픽 같은 곳)를 하나로 묶어서 무료 할당량을 다 쓰면 자동으로 다른 모델로 넘어가는 게이트웨이(gateway, 여러 서비스를 하나로 연결하는 중간 통로)다.

    아이디어는 나쁘지 않다. 하지만 내 파이프라인 전체가 Claude 하나 기준으로 맞춰져 있다. 말투 스킬도, AI 패턴 차단 규칙도 전부 Claude 기준이다. 여기에 다른 모델을 섞으면 그동안 다듬어온 것들이 다 어긋날 수 있다. 거기다 요청이 게이트웨이를 하나 더 거치게 된다는 것도 마음에 걸렸다. 중간에 거치는 단계가 하나 늘어날 때마다 뭔가 꼬일 가능성도 하나씩 늘어난다.

    13만 개 별을 의심하고 다시 확인한 검증 과정

    ponytail 별(star, GitHub에서 사용자들이 좋은 프로젝트에 누르는 즐겨찾기 같은 것)이 13만 개, graphify가 11만 개라고 나왔다.

    이 숫자가 이상했다. 13만 개면 엄청난 숫자다. 유명한 오픈소스 프로젝트 수준이다. AI가 그냥 그럴듯하게 숫자를 지어냈을 수 있다고 생각했다. AI가 할루시네이션을 일으키는 건 알려진 사실이다.

    그래서 GitHub API(Application Programming Interface, 프로그램끼리 데이터를 주고받는 통로)로 직접 다시 확인해달라고 했다. 결과는 같은 숫자였다. 진짜였다.

    AI 에이전트 도구 ponytail과 graphify 별점을 GitHub API로 재검증한 터미널 화면, stargazers_count 값이 동일하게 확인됨

    의심했다. 확인했다. 믿었다. 이 순서가 맞다. 실제로 ponytail 저장소에 들어가면 지금도 그 별점을 직접 확인할 수 있다.

    AI가 말하는 숫자나 사실은 한 번쯤 다시 확인해야 한다. 귀찮더라도 그렇게 해야 한다. 이번엔 맞았지만, 다음에도 맞다는 보장은 없다.

    하나도 안 깐 게 오히려 정답인 이유

    7개를 다 봤다. 하나도 안 깔았다.

    처음엔 뭔가 하나쯤은 새로 깔아야 할 것 같았다. 7개를 다 확인해봤는데 결과물이 없으면 시간 낭비처럼 느껴질 것 같았다. 근데 하나씩 따져보면서 생각이 바뀌었다.

    이미 있는 건 이미 있는 거다. 없는 건 지금 내 상황에 안 맞았다. 새로 깐 게 없다는 게 실패가 아니라, 지금 쓰는 구조가 이미 내 상황에 맞게 다듬어져 있다는 확인이었다.

    뭔가를 안 하기로 결정하는 것도 결정이다. 그리고 그 결정을 내리려면 일단 확인은 해봐야 한다. 소개 카드만 보고 “좋아 보이네” 하고 깔았으면 지금 내 환경에 안 맞는 도구들이 3~4개쯤 더 쌓여 있었을 거다.

    다음엔 지금 이미 깔려 있는 도구들을 제대로 들여다볼 생각이다. ponytail이 그 대화 내내 켜져 있었다는 걸 이번에 처음 알았다. 모르고 쓰고 있는 게 또 있을 거다.

    버전이 안 맞아서 CLI가 아예 안 됐던 사례는 데몬 버전 불일치로 CLI가 안 됐던 이야기 (v1.8.7→1.8.8)에 정리했다.

  • 클로드 스킬 3개 비교, 나는 last30days만 쓰기로 했다

    클로드 스킬 3개 비교, 나는 last30days만 쓰기로 했다

    인스타그램 릴스 하나가 날아왔다. 클로드 스킬 3개를 소개하는 영상이었다. 별 합산 21만 개라고 했다. 바로 설치하지 않았다. 이번도 똑같은 순서로 확인했다.

    릴스가 말한 Claude 스킬 3개는 뭐였나? (사실 확인 결과)

    영상이 소개한 스킬은 세 개였다.

    첫째, Agent Skills. 별 9.9만 개. 개발 순서(workflow, 작업을 어떤 흐름으로 처리할지 정한 절차) 스킬 25개 묶음이다. 둘째, last30days. 별 6.3만 개. 레딧·유튜브 같은 플랫폼에서 최근 30일 반응을 수집하는 스킬이다. 셋째, Obsidian Skills. 별 4.9만 개. 노트 앱 옵시디언의 대표가 직접 만든 스킬이라고 했다.

    영상은 데모도 보여줬다. 스킬 없이 ‘할 일 관리 웹앱 만들어줘’라고 하면 클로드가 묻지도 않고 코드부터 짠다. /spec 명령을 붙이면 코드 전에 질문부터 한다는 거였다. 설치는 셋 다 한 줄이라고 했다.

    주장 자체는 깔끔했다. 그래서 직접 확인했다.

    인스타 릴스에 나온 클로드 스킬 3개(Agent Skills, last30days, Obsidian Skills) — 누구에게 맞고 누구에게 안 맞는지, 그리고 내가 1개만 쓰기로 한 이유 스크린샷 1

    위는 릴스 첫 화면을 캡처한 프레임이다. 별 21만, 9.9만, 6.3만, 4.9만이라는 숫자가 이 화면에 나온다.

    GitHub로 직접 확인한 별(⭐) 개수와 업데이트 현황

    GitHub API(GitHub 공식 데이터 조회 도구)로 세 저장소(repository, 코드를 저장하는 폴더)를 직접 조회했다.

    • addyosmani/agent-skills: 99,180개
    • mvanhorn/last30days-skill: 62,889개
    • kepano/obsidian-skills: 48,894개

    합치면 약 21만 1천 개. 영상의 ’21만’은 맞았다. 셋 다 MIT 라이선스(소스코드를 자유롭게 쓰고 수정할 수 있는 오픈소스 허가)이고, 최근 한 달 안에 업데이트된 기록도 있었다.

    저자 검증도 했다. addyosmani의 GitHub 프로필에는 ‘Former Director at Google’이라고 적혀 있다. kepano의 프로필 이름은 Steph Ango, 회사는 Obsidian이다. 영상이 말한 “옵시디언 대표”라는 직함까지는 확인하지 못했다. 프로필에서 확인한 건 이름과 소속 회사까지다.

    인스타 릴스에 나온 클로드 스킬 3개(Agent Skills, last30days, Obsidian Skills) ,  누구에게 맞고 누구에게 안 맞는지, 그리고 내가 1개만 쓰기로 한 이유 스크린샷 2

    위는 Agent Skills 저장소의 GitHub 화면이다.

    한 가지는 확인하지 못했다. 영상이 말한 ‘질문 8개’는 README(저장소 설명 파일)에서 찾지 못했다. /spec 명령이 실제로 질문을 몇 개 하는지, 그 숫자는 검증 안 됐다.

    내 개발 환경에 이미 깔려 있던 것들

    확인하다 보니 겹치는 게 많았다.

    내 Claude Code에는 이미 superpowers라는 클로드 스킬 묶음이 깔려 있다. brainstorming(아이디어를 설계로 만들고 승인받기), writing-plans(실행 계획 쓰기), test-driven-development(테스트 주도 개발), systematic-debugging(체계적 디버깅), requesting-code-review(코드 리뷰 요청), verification-before-completion(완료 전 검증) 같은 것들이다.

    Agent Skills의 /spec → /plan → /build → /test → /review 흐름과 거의 같은 순서다.

    더 뜻밖이었던 건 last30days였다. 이미 깔려 있었다. 이 프로젝트의 .claude/skills/last30days에 v3.21.0으로 들어 있었고, 저장소는 mvanhorn/last30days-skill로 동일했다. 릴스를 보기 전까지 설치만 해두고 한 번도 쓰지 않은 클로드 스킬이었다.

    Obsidian은 반대 상황이었다. 맥에 앱 자체가 없다. /Applications에도, Application Support에도 Obsidian이 없었다.

    last30days는 실제로 작동하나? (상태 점검 결과)

    상태 점검을 돌려봤다.

    인스타 릴스에 나온 클로드 스킬 3개 ,  누구에게 맞고 누구에게 안 맞는지, 그리고 내가 1개만 쓰기로 한 이유 스크린샷 3

    위는 last30days 저장소의 GitHub 화면이다.

    키 없이 작동하는 소스는 다섯 개였다. 레딧, 유튜브, 해커뉴스, 폴리마켓(예측 시장 데이터 플랫폼), GitHub. 이 다섯은 ‘작동 안 함’이 없었다.

    설정이 안 된 상태로 나온 건 X, 틱톡, 인스타그램, 스레드, 링크드인이었다. 이 플랫폼들은 별도 API 키(플랫폼 접근 허가증)를 발급받아야 쓸 수 있다는 뜻이다.

    버전은 3.21.0인데 저장소에는 3.25.0 릴리스(출시 버전)가 올라와 있었다. 업데이트가 필요하다.

    실제 조사는 아직 돌려보지 않았다. 상태 점검만 한 거다. 결과물 품질은 모른다. 이 점은 명확히 한다.

    Agent Skills와 Obsidian을 안 쓰기로 한 구체적 이유

    클로드 스킬 중 Agent Skills는 설치하지 않는다.

    이유는 두 가지다. 첫째, superpowers와 역할이 거의 겹친다. 같은 상황에 클로드 스킬 두 세트가 동시에 발동하면 어느 쪽 절차를 따를지 충돌할 수 있다.

    둘째, 컨텍스트 부담이 있다. 클로드 스킬 25개의 설명이 통째로 얹힌다. 예전에 컨텍스트가 넘쳐서 MCP 커넥터(외부 도구를 클로드에 연결하는 플러그인) 몇 개를 꺼둔 적이 있다. 가볍게 볼 문제가 아니다.

    하나 더 있다. Agent Skills README에는 스킬을 하나씩 설치할 경우 저장소 공용 references 폴더가 같이 설치되지 않는 문제(이슈 #361)가 적혀 있었다. 알려진 버그다.

    Obsidian Skills는 이유가 단순하다. 옵시디언을 안 쓴다. 앱이 없다. 끝이다.

    각 스킬별 ‘누구에게 맞고 누구에게 안 맞는지’ 정리

    직접 다 써본 결과가 아니다. 위에서 확인한 사실로 내린 판단이다.

    스킬 맞는 사람 안 맞는 사람
    Agent Skills 클로드가 묻지 않고 코드부터 짜는 게 불만인 사람 / 웹앱이나 서비스를 처음부터 끝까지 만드는 사람 / 개발 순서용 클로드 스킬이 하나도 없는 사람 superpowers 같은 비슷한 클로드 스킬 묶음을 이미 쓰는 사람 / 컨텍스트 여유가 빠듯한 사람 / 짧은 스크립트 몇 개만 돌리는 사람
    last30days 블로그 주제나 제품 반응을 조사해야 하는 블로거·마케터·기획자 / 레딧·유튜브·해커뉴스 범위로 충분한 사람 X나 틱톡 결과까지 반드시 필요한 사람 (키 발급이 필요함) / API 키 설정이 귀찮은 사람은 무료 소스 범위로 만족할 수 있는지 먼저 봐야 한다
    Obsidian Skills 이미 옵시디언으로 노트를 쓰는 사람 옵시디언을 안 쓰는 사람. 이유가 없다
    인스타 릴스에 나온 클로드 스킬 3개 ,  누구에게 맞고 누구에게 안 맞는지, 그리고 내가 1개만 쓰기로 한 이유 스크린샷 4

    위는 Obsidian Skills 저장소의 GitHub 화면이다.

    이번 릴스는 숫자가 정확했다. 21만이라는 별 합산도, 저자 정보도 맞았다. 그렇다고 셋 다 설치할 이유는 없었다. 나한테 맞는 건 하나였고, 그건 이미 깔려 있었다.

    덧붙임: 클로드 스킬이 아닌 옵시디언 플러그인 Claudian도 넘겼다

    이 글을 쓴 뒤 릴스 하나가 더 왔다. 클로드 스킬이 아니라 옵시디언 플러그인 Claudian을 소개하는 영상이었다. GitHub 별 15,500개, MIT 라이선스다. 옵시디언 커뮤니티 플러그인 목록에도 있다. 다만 목록에는 옵시디언 직원이 직접 검토하지 않았다는 표시가 붙어 있다.

    하는 일은 단순하다. 옵시디언 안에 채팅창을 붙이고, 노트 폴더를 Claude Code의 작업 폴더로 쓴다. 안에서 돌아가는 건 이미 쓰는 Claude Code다.

    클로드 스킬 3개 중 옵시디언용을 안 쓴 것과 같은 이유로 설치하지 않기로 했다. 영상은 클로드가 오래된 맥락을 지운다고 했는데, README에는 Claudian이 그 문제를 고친다는 내용이 없다.

    그래프 화면은 옵시디언 기본 기능이다. 내 기억은 이미 Claude Code의 메모리 파일이 맡고 있고, 옵시디언도 깔려 있지 않다.

    위 클로드 스킬 3개와 마찬가지로 직접 써본 결과가 아니라 README와 내 환경을 비교한 판단이다.

    클로드 스킬 확인 후 남은 할 일

    같은 결의 글로 올라마 연동을 안 깐 이유도 정리해뒀다. 릴스를 받으면 확인하고, 겹치는지 보고, 내 작업에 닿는지 따진다. 순서는 매번 같다.

    다음에 할 일은 하나다. last30days로 실제 리서치(조사)를 한 번 돌려보는 것. 상태 점검 통과와 결과물 품질은 다른 문제다. 돌려보고 나면 쓸 만한지 아닌지 알 수 있다.