Hermes Agent용 AI 에이전트 스킬 모음 (agent-skills)

도메인별로 정리된 Hermes Agent를 위해 구축된 AI 에이전트 스킬들의 모음입니다. 각 스킬은 자체 폴더에 독립적으로 존재하므로 필요한 것을 선택하여 설치할 수 있습니다.

이식성(Portability): 이 스킬들은 Hermes의 도구 아키텍처(web_search, web_extract, terminal, delegate_task, cronjob 등)와 SKILL.md 형식에 맞춰 작성되었습니다. 하지만 워크플로우, 프롬프트, 스크립트는 에이전트와 독립적(agent-agnostic)입니다. 따라서 어떤 플랫폼의 AI 에이전트(Claude Code, Codex, OpenCode, LangGraph 등)라도 도구 이름 매핑과 스킬 로더 규칙을 자체 환경에 조정함으로써 이를 활용할 수 있습니다.

agent_skills/
├── README.md ← 현재 위치 (레포지토리 레벨)
├── LICENSE
...

새로운 스킬은 관련 도메인 디렉터리 아래 폴더로 추가됩니다.

|— |
| decision-log | 생산성(productivity) | 상위 버전 체인 및 크론 검토 알림이 포함된 ADR 스타일 의사결정 저널 | — |
| scheduled-summary | 생산성(productivity) | 크론 기반의 세션 간 요약본—채팅 플랫폼에서는 보이지 않는 활동을 노출합니다 | decision-log, news-monitoring |
| file-organizer | 생산성(productivity) | LLM 기반 디렉토리 정리기: 스캔 → 구조 제안 → 확인 → 청크 이동 | — |
| ... |

관련 작업: Odysseus (PewDiePie의 자체 호스팅 AI 워크스페이스)는 독립형 웹 앱으로서 유사한 기능을 제공합니다—"Deep Research"와 "Compare"—반면, deep-research와 model-compare는 모든 에이전트의 툴 루프 내부에서 순수 프롬프트 워크플로우(pure-prompt workflows) 및 stdlib 스크립트가 다루는 것과 동일한 영역을 다룹니다.

스킬 외에도, 이 저장소는 plugins/ 아래에 설치 가능한 Hermes Agent 플러그인을 제공합니다.

대규모 라이브러리로의 스킬 사용 확장을 위한 Hermes 플러그인입니다. 스킬 카탈로그가 수십 개를 넘어서면, 턴당 <available_skills> 블록이 입력 토큰 비용을 발생시키고 적절한 스킬을 노이즈 속에 묻어버립니다. 이 플러그인은 전체 블록을 BM25 검색(retrieval)으로 대체합니다: 각 사용자 턴은 스킬 이름과 설명으로부터 구축된 stdlib 역색인(inverted index)과 점수가 매겨지며, 가장 관련성이 높은 상위 K개 스킬만 프롬프트에 주입됩니다 (기본 K=6, plugin.yaml을 통해 구성 가능).

stdlib 전용— numpy/scipy 불필요; 인덱스는 밀리초 단위로 구축되며 128개 이상의 스킬에 대한 검색은 서브-밀리초(sub-millisecond)입니다.프로파일 인식 발견(Profile-aware discovery)— 경로는 Hermes 자체 도우미(get_hermes_home, get_skills_dir)를 통해 해결되므로, 이름 지정된 프로파일, skills.external_dirs, 신뢰하는 프로젝트 로컬 스킬, 비활성화 목록, 그리고 플랫폼/조건 게이트가 에이전트 자체가 보는 것과 모두 일치합니다. 인덱스 캐시는 Hermes 홈별로 키가 지정되어 있어 다중화된(multiplexed) 프로파일은 절대 인덱스를 공유하지 않습니다.Windows 안전— 스킬 ID는 순방향 슬래시(/)로 정규화되며, $HERMES_HOME 인식 경로 해결을 지원합니다.선택적 Jev 재순위화(rerank)— SKILL_RETRIEVAL_RERANK가 활성화되고 TYPESAFE_API_KEY가 있을 때, BM25 상위 K개 결과를 Jev 시스템-원 판단 모델(api.typesafe.ai)로 재순위화합니다.

is present (the legacy TYPESAFE_KEY)

name is accepted, from os.environ.

Fail-soft: 타임아웃이나 오류 발생 시 로그를 기록하고 순수 BM25로 폴백합니다. A/B 로그 (rerank_ab_report.py)는 테스트 검토를 위해 쿼리별 결정을 기록하며, 크기는 5MB를 초과하지 않도록 회전(rotates)됩니다. cron으로 실행되며 런타임 종속성이 없습니다.점진적 성능 저하 (Graceful degradation)— Hermes 핵심 모듈을 사용할 수 없을 경우 독립형 로더로 폴백합니다. 잘못된 설정 파일은 인덱스 빌드를 중단시키지 않습니다. A/B 로깅 및 리랭크는 검색(retrieval)을 중단시키지 않습니다.

또는 Hermes 플러그인 카탈로그에서 설치할 수 있습니다 (고정 버전, 버전 추적):

hermes plugins install skill-retrieval

plugins/skill-retrieval/를 ~/.hermes/plugins/ (또는 프로필의 plugins/)로 복사하거나 심볼릭 링크합니다. 그런 다음 게이트웨이를 재시작합니다. 테스트: python3 -m pytest plugins/skill-retrieval/tests/.

에이전트의 대화 기록과 메모리를 유지되는 마크다운 위키(Karpathy 스타일 LLM 위키)로 변환하는 Hermes 플러그인입니다. 두 가지 스킬이 있습니다: lumen:wiki (방법론: OKF 프런트매터, 3계층 페이지 레이아웃, 수집/쿼리/린트 워크플로우)와 lumen:curator (wiki_curator.py 스크립트와 읽기 전용 메모리 소스 어댑터 계층 — Hermes 대화 기록은 읽기 전용 SQLite를 통해, Mnemosyne은 hermes CLI 내보내기를 통해, 일반 JSON 파일 또는 없음).

기본적으로 세션 우선 (Sessions-first by default)— 기본 메모리 소스는 에이전트 자체의 대화 기록(state.db에 대한 읽기 전용 SQLite)입니다. auto는 세션을 선호하고, 그다음 Mnemosyne을, 그다음 JSON 파일을 사용합니다. 대화 기록은 진실 근거(ground truth)로 취급되며, 메모리 저장소에는 파생된 노트가 담깁니다.캡 제한형 큐레이션 (Cap-bounded curation)— 배치 수집, 업데이트 및 검증 실행은 실행당 상한이 설정되어 있으며, 페이지별 백업과 원자적 교체(atomic replace) 기능을 제공합니다.출처 귀속 계약 (Source attribution contract)— 생성된 모든 줄에는 [source: id]가 귀속됩니다. 운영자가 작성한 텍스트는 업데이트 시에도 보존되며 (독립적인 확인 검토자 7회 검토 라운드를 통해 검증됨).Stdlib + PyYAML만 사용— hermes을 제외하고 네트워크 호출은 없습니다.

CLI를 사용하여 메모리를 내보내고(export); 어댑터는 이 내보낸 데이터를 읽으며, 제공자 내부 정보에는 접근하지 않습니다.

plugins/lumen/ 폴더를 복사하거나 심볼릭 링크하여 ~/.hermes/plugins/ (또는 프로필의 plugins/)에 설치하고, hermes plugins enable lumen으로 활성화한 후 게이트웨이를 재시작하세요. 테스트는 python3 -m pytest plugins/lumen/tests/를 실행합니다.

npx skills add moonlight-lupin/agent-skills
모든 스킬을 .agents/skills/에 설치합니다 (Cursor, Codex, Gemini CLI, Copilot, OpenCode 등에서 작동하며; Claude Code는 심볼릭 링크 복사본을 받습니다). 또한 skills-lock.json이라는 해시 고정 파일이 .claude/skills/에 생성되어 나중에 npx skills update으로 새로고침할 수 있습니다. --skill <이름>으로 하나의 스킬만 설치하거나, 대화형 목록에서 선택하려면 이 옵션을 생략하세요.

# 정확한 경로로 하나의 스킬을 설치합니다 (가장 빠르며 트리 스캔 없음)
gh skill install moonlight-lupin/agent-skills creative/image-studio/SKILL.md
# ...또는 특정 에이전트 디렉터리로 이름으로 설치하기
...

git clone https://github.com/moonlight-lupin/agent-skills.git
cd agent-skills

각 스킬 폴더에는 설정 및 사용 설명서가 담긴 SKILL.md 파일이 있습니다 — 원하는 내용을 에이전트의 스킬 디렉터리 (예: ~/.claude/skills/, ~/.cursor/skills/, ~/.agents/skills/)로 복사하세요.

자격 증명(credentials)은 절대 커밋하지 마세요. API 키, 비밀 정보가 포함된 설정 파일, 그리고 생성된 아티팩트는 모두 gitignore 됩니다.

Spec 준수: 모든 스킬은 Agent Skills spec에 대해 검증됩니다 (npx skills-ref validate)

)
Author, version, and platform metadata는 metadata: 아래에 있습니다.

MIT — 이 저장소의 모든 스킬은 moonlight-lupin이 제작한 오리지널 작품이며 MIT 라이선스(MIT License)로 보호받습니다.