Skills

Verdent Skills는 에이전트의 전문성을 확장하는 재사용 가능한 지식 팩입니다. 각 Skill에는 도메인별 프롬프트, 스크립트, 참조 자료, 모범 사례가 포함됩니다. Skill 이름을 호출하기만 하면 에이전트가 해당 컨텍스트를 로드하고 미리 정의된 워크플로를 따릅니다.

Skills란 무엇인가요?

핵심 개념

Skill은 폴더에 저장되는 구조화된 지식 팩입니다. 모든 Skill에는 이름, 설명, 상세 프롬프트를 정의하는 SKILL.md 파일이 포함됩니다. 대화에서 Skill을 호출하면 Verdent이 이 파일을 읽고 그 내용을 에이전트의 컨텍스트에 주입합니다.

Skills, Subagents, MCP의 차이

요약하면 Skills는 지식과 워크플로 가이드를 제공하고, Subagents는 독립 작업을 실행하며, MCP는 외부 도구와 데이터 소스를 연결합니다.

Skills 사용 방법

Skill 호출하기

Skill은 두 가지 방법으로 호출할 수 있습니다.

1. 대화에서 Skill 이름 언급하기

Use the skill-creator skill to help me create a new Skill

2. @ 멘션 문법 사용하기

@skill-creator help me create a Skill for API documentation generation

Skill이 트리거되면:

1. 에이전트가 skill 도구를 호출해 Skill의 SKILL.md 파일을 읽습니다
2. 파일 내용이 현재 대화 컨텍스트에 주입됩니다
3. 에이전트가 Skill의 가이드에 따라 계속 작업합니다

사용 가능한 Skills 둘러보기

Settings에서 Skills 패널에 접근합니다.

1. Settings 메뉴를 엽니다
2. Skills 탭을 선택합니다
3. 설치된 Skills와 Skill Store에서 제공되는 Skills를 둘러봅니다

입력창에 @를 입력해 자동 완성을 트리거하고 사용 가능한 Skill을 빠르게 선택할 수도 있습니다.

내장 Skills

Verdent에는 일반적인 워크플로를 다루는 내장 Skills 세트가 포함되어 있습니다.

커스텀 Skills 만들기

팀의 도메인 전문성이나 프로젝트별 워크플로를 캡슐화하는 커스텀 Skills를 만들 수 있습니다.

Skill 디렉터리 구조

표준 Skill 폴더는 다음과 같습니다.

my-custom-skill/
├── SKILL.md              # Required: Skill definition file
├── agents/
│   └── verdent.yaml      # Optional: UI configuration (icons, display name)
├── scripts/              # Optional: helper scripts
└── references/           # Optional: reference docs or examples

SKILL.md 형식

SKILL.md는 핵심 Skill 파일이며, YAML frontmatter와 Markdown 본문을 포함합니다.

---
name: my-custom-skill
description: A concise description shown in the Skill list
metadata:
  version: "1.0.0"
  author: "Your Name"
  license: "MIT"
---

# Detailed Instructions

This is the detailed prompt content the Agent reads.

## Workflow

1. Step one
2. Step two
3. ...

## Best Practices

- Practice suggestion 1
- Practice suggestion 2

Frontmatter 필드 요구사항:

• name (필수): 폴더 이름과 일치해야 합니다. 소문자, 숫자, 하이픈(a-z0-9-)만 허용됩니다. 길이: 1~64자. 연속 하이픈이나 앞뒤 하이픈은 허용되지 않습니다.
• description (필수): 짧은 설명이며, 최대 1024자입니다.
• metadata (선택): 버전, 작성자, 라이선스 및 기타 메타 정보입니다.

커스텀 Skills 설치하기

방법 1: Settings에서 가져오기

1. Settings → Skills를 엽니다
2. Import Skill을 선택합니다
3. Skill 폴더(또는 .zip / .skill 아카이브)를 선택합니다
4. Verdent이 SKILL.md을 검증하고 ~/.verdent/skills/에 설치합니다

방법 2: 수동 복사

cp -r my-custom-skill ~/.verdent/skills/

Verdent을 다시 시작하거나 Skills 목록을 새로고침하면 Skill을 사용할 수 있습니다.

방법 3: 프로젝트 수준 Skill

프로젝트 디렉터리 안에 Skill을 배치합니다.

cp -r my-custom-skill /path/to/your/project/.verdent/skills/

프로젝트 수준 Skills는 해당 프로젝트 안에서만 표시되며, 같은 이름의 전역 Skills보다 우선합니다.

Skill 범위

Verdent은 세 가지 수준의 Skill 범위를 지원합니다.

우선순위 규칙:

같은 이름의 Skills가 여러 범위에 존재하는 경우:

• 프로젝트가 전역보다 우선합니다

Skill Store

Verdent은 커뮤니티 및 공식 Skills를 둘러보고 설치할 수 있는 Skill Store를 제공합니다.

Skill Store 둘러보기

1. Settings → Skills를 엽니다
2. Store 탭으로 전환합니다
3. 사용 가능한 Skills를 둘러보거나 검색창을 사용합니다

Store에서 설치하기

1. Store에서 원하는 Skill을 찾습니다
2. Install을 선택합니다
3. Skill이 자동으로 다운로드되어 ~/.verdent/skills/에 설치됩니다

보안 검증:

Store에서 설치한 Skills는 파일 무결성과 보안을 보장하기 위해 SHA256 체크섬 검증을 거칩니다.

실제 예시

예시 1: skill-creator로 새 Skill 만들기

@skill-creator help me create a Skill for guiding the team on writing Go unit tests

에이전트는 다음을 수행합니다.

1. skill-creator Skill 콘텐츠를 읽습니다
2. Skill 이름, 설명, 핵심 프롬프트를 채우도록 안내합니다
3. 표준 SKILL.md를 생성합니다
4. 설치 경로와 검증 단계를 제안합니다

예시 2: spreadsheet로 데이터 분석하기

@spreadsheet read sales-2025.xlsx from the project root, analyze Q1 sales trends, and generate a chart

에이전트는 다음을 수행합니다.

1. spreadsheet Skill을 로드합니다
2. pandas 및 openpyxl을 사용해 Excel 파일을 읽습니다
3. 데이터를 분석하고 시각화를 생성합니다
4. 결과를 저장하거나 대화에 표시합니다

예시 3: gh-fix-ci로 CI 수정하기

@gh-fix-ci my PR #123 GitHub Actions tests are failing, help me debug

에이전트는 다음을 수행합니다.

1. gh CLI를 사용해 PR #123의 CI 로그를 가져옵니다
2. 실패 원인을 분석합니다(예: 테스트 케이스 오류, 의존성 문제)
3. 수정안을 제안합니다
4. 사용자의 승인 후 코드를 수정하고 수정 사항을 푸시합니다

자주 묻는 질문

고급 사용법

Skills에 스크립트 포함하기

Skill에 scripts/ 디렉터리를 추가하고 SKILL.md에서 스크립트를 참조합니다.

## Data Processing Script

Run the following command to process data:

\`\`\`bash
python scripts/process_data.py --input data.csv --output results.json
\`\`\`

에이전트는 이 지침을 읽고 필요할 때 스크립트를 실행합니다.

문서 참조하기

API 문서, 사양 또는 샘플 코드를 references/ 디렉터리에 저장하고 SKILL.md에서 링크합니다.

## Reference Documentation

See [references/api-spec.md](references/api-spec.md) for the detailed API specification.

에이전트는 Skill의 지침에 따라 이러한 참조 파일을 읽을 수 있습니다.

모범 사례

함께 보기