본문으로 건너뛰기

에이전트 스킬 (Agent Skills)

웹 UI 혹은 ~/.nexus-agent/skills/ 디렉토리를 통해, Nexus Agent의 능력을 커스텀 스크립트로 확장하는 기능입니다.

스킬 디렉토리 구조​

스킬은 폴더 단위로 관리되며, 필수적으로 SKILL.md 파일을 가져야 합니다.

~/.nexus-agent/skills/
└── my-skill/
    ├── SKILL.md            # 필수: YAML frontmatter + 마크다운 지시사항
    ├── scripts/            # 선택: 실행할 스크립트 (.py, .sh, .js 등)
    └── references/         # 선택: AI가 참고할 참조 문서 (.md, .txt 등)

SKILL.md 작성법​

YAML frontmatter를 포함하여 명확한 지시사항을 작성하세요. allowed-tools를 통해 스킬 안에서 Agent가 사용할 수 있는 권한을 부여할 수 있습니다.

---
name: my-skill
description: >
  이 스킬이 하는 일과 언제 사용해야 하는지 설명합니다. 
allowed-tools: brave-search__brave_web_search, sequential-thinking__sequentialthinking
---

# My Skill

## 사용 방법

1. 사용자가 관련 질문을 하면 이 스킬이 활성화됩니다.
2. `scripts/` 에 있는 스크립트를 분석 후 실행할 수 있습니다.
3. `references/` 에 있는 정책 문서를 참조하여 질문에 응답하세요.

UI를 통한 스킬 관리​

프론트엔드 Agent Skills (/skills) 대시보드에서 다음 작업을 수행할 수 있습니다.

  • 스킬 추가/편집/삭제
  • ZIP 파일 업로드 방식 지원 (폴더 통째로 임포트)
  • 로컬 경로 직접 임포트 지원

스킬은 곧바로 LLM의 시스템 프롬프트(System Prompt)에 주입되어, 봇이 특정 상황에 어떻게 대처하고 어떤 스크립트를 실행할지 능동적으로 판단할 수 있게 해줍니다.