neuro-skill은(는) 무엇을 하나요?
AI 에이전트를 위한 무료 하이브리드 스킬 라우터. 그래프 확산 활성화 + 코사인 유사도 + 키워드 융합. 순수 로컬, 쿼리당 40ms, API 호출 불필요.
개요
neuro-skill은 AI 에이전트(예: Claude Code, Cursor, Codex)가 여러 하위 스킬이나 도구 중에서 가장 적합한 것을 빠르게 선택할 수 있도록 설계된 경량 라우팅 엔진입니다. 세 가지 보완적인 방법을 사용합니다:
- 그래프 확산 활성화: 스킬 간 관계 그래프를 통해 활성화를 전파합니다.
- 코사인 유사도: 쿼리와 스킬 설명 간의 임베딩 유사도를 계산합니다.
- 키워드 융합: 중요한 키워드를 기반으로 매칭 점수를 조정합니다.
이 모든 과정은 완전히 로컬에서 실행되며, 외부 API 호출이나 데이터 전송이 없습니다. 따라서 프라이버시가 중요하거나 오프라인 환경에서 사용하기에 적합합니다. 각 쿼리는 평균 40ms 안에 처리되므로 실시간 에이전트 상호작용에도 쾌적하게 사용할 수 있습니다.
지원 플랫폼
- Claude Code
- Cursor
- Codex
- 기타 로컬 도구 호출을 지원하는 AI 에이전트
설치 및 사용법
- 이 저장소를 클론하거나 스킬 파일을 에이전트 설정 디렉토리에 복사합니다.
- 에이전트 구성 파일에서
wuykjl/neuro-skill을 스킬로 추가합니다. - 필요에 따라 환경 변수를 설정합니다:
NEURO_SKILL_THRESHOLD: 매칭 임계값 (기본값: 0.6)NEURO_SKILL_GRAPH_PATH: 그래프 데이터 파일 경로
- 에이전트를 다시 시작하면 자동으로 라우팅 기능이 활성화됩니다.
예시
# 쿼리 예시: "사용자 인증 모듈 구현"
# neuro-skill이 내부적으로 다음 스킬을 선택할 수 있음:
# - auth-skill (0.85 점수)
# - security-skill (0.72 점수)
# - database-skill (0.45 점수)
# 가장 높은 점수의 스킬로 라우팅
라이선스
MIT
기여
버그 리포트와 기능 제안은 GitHub 이슈로 남겨주세요.