SkillSense: 설치된 코딩 스킬을 프롬프트에 맞춰 로컬에서 재추천하는 도구

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

작성자는 자주 설치한 스킬을 잊는 문제를 해결하기 위해 SkillSense라는 로컬 능력 재발견 도구를 만들었다. 이 도구는 Claude Code와 Codex의 UserPromptSubmit 훅에 연동되어 프롬프트 제출 시 로컬 ~/.codex/skills에 저장된 스킬 목록과 lexical scoring으로 관련성을 계산하고 관련 항목을 에이전트에 권고한다. 구현은 완전 로컬로 SQLite를 인덱스로 사용하며 네트워크 호출이나 API 키를 사용하지 않고, 관련성이 없으면 아무 알림도 내지 않고 실패 시 조용히 동작한다. 현재는 MVP로 GitHub에 공개되어 있으며 작성자는 사용성·통합성에 대한 피드백을 구하고 있다.

실용적 조언

로컬에서 설치한 스킬을 자동으로 재활용하려면 스킬의 메타데이터와 설명을 일관된 형식으로 ~/.codex/skills 같은 디렉터리에 저장하면 검색과 lexical scoring 기반 매칭이 안정적으로 동작할 가능성이 높다. SQLite 같은 경량 데이터베이스를 인덱스로 사용하면 네트워크 없이도 빠른 조회가 가능하며 유지보수가 쉽다. 에이전트에게 권고만 제공하고 사용 여부는 에이전트나 사용자에게 맡기는 방식은 불필요한 알림을 줄여 실제 워크플로우 방해를 최소화한다.

섹션별 상세

작성자는 자주 설치한 스킬을 잊어버리는 문제를 해결하기 위해 SkillSense를 만들었다. 이 도구는 Claude Code와 Codex에서 UserPromptSubmit 훅에 연결되어 사용자가 프롬프트를 제출할 때 자동으로 트리거된다. 트리거되면 프롬프트와 로컬에 저장된 스킬 목록을 대조해 관련성이 있는 항목을 선별하고 에이전트에 '이 기능이 관련성이 있다'고 알린다.

구현상 SkillSense는 완전히 로컬에서 동작하며 외부 API 키나 네트워크 호출을 사용하지 않는다. 저장소로 SQLite를 사용하고 관련성 판단을 위해 lexical scoring 기반의 비교를 수행하며, 관련 결과가 있으면 경고 형태의 권고 문구와 함께 경로를 제공한다. 이 방식은 프라이버시를 유지하면서도 설치된 스킬을 자동으로 재활용할 수 있게 한다.

사용자 경험 측면에서 SkillSense는 에이전트의 판단권을 존중하도록 설계되어 있다. 도구는 관련성이 있는 스킬을 '권고'로 제시할 뿐 사용을 강제하지 않으며, 관련 항목이 없을 때는 아무런 알림을 발생시키지 않도록 동작한다. 이러한 동작은 잦은 알림으로 인한 방해를 최소화하면서 잊혀진 도구의 재활용을 촉진하는 의도를 반영한다.

현재 프로젝트는 MVP 단계로 GitHub 저장소 링크가 제공되어 있고 작성자가 피드백을 요청하고 있다. 게시물에는 예시로 Home Assistant 관련 스킬의 경로(~/.codex/skills/home-assistant-integration-debugging)가 명시되어 있어 로컬 디렉터리 구조와 동작 흐름을 재현할 수 있다. 로컬 우선 설계와 조용한 실패(fail silently) 정책은 실무 환경에서 손쉬운 도입과 데이터 보안 측면에서 장점을 제공할 수 있다.

용어 해설

기능 기억(recall) 메커니즘(Capability Recall): — 사용자가 설치한 개별 기능(스킬)을 프롬프트 문맥과 대조해 관련성을 판단하고 재활용하도록 자동으로 제안하는 메커니즘으로서, 프롬프트 입력을 기준으로 저장된 기능 메타데이터를 검색·정렬해 에이전트에 권고를 제공하는 방식이 핵심이다.
어휘 기반 점수 산정(Lexical Scoring): — 프롬프트 텍스트와 기능 설명 또는 키워드 간의 문자·단어 수준 유사도를 기반으로 점수를 매기는 방법으로서, 의미역(semantic) 임베딩 대신 단어 일치 또는 토큰 빈도를 활용해 단순하고 로컬에서 빠르게 관련도를 계산하는 구현이 가능하다.
프롬프트 제출 훅(UserPromptSubmit): — 에이전트나 인터페이스에서 사용자가 프롬프트를 제출할 때 호출되는 이벤트 지점으로서, 해당 훅에 외부 모듈을 연결하면 입력 프롬프트를 가로채어 추가 검증·보완·추천 작업을 수행할 수 있다.
로컬 우선 설계(Local-first): — 네트워크 호출이나 외부 API 의존성을 최소화하고 장치 내 저장소와 연산으로 기능을 제공하는 설계 철학으로서, 데이터 유출 위험을 낮추고 오프라인 환경에서도 동작하게 하며 운영 제약을 단순화하는 장점이 있다.

언급된 도구

SkillSense중립링크

로컬 기반 capability-recall 엔진으로 프롬프트에 맞춰 설치된 스킬을 제안하는 도구

Claude Code중립

프롬프트 제출 훅(UserPromptSubmit)을 통해 에이전트 인터셉션이 가능한 코딩 에이전트 환경

Codex중립

프롬프트 훅을 통해 외부 모듈에서 입력을 가로채고 보완할 수 있는 코딩 에이전트 환경

언급된 리소스

GitHubSkillSense GitHub