스킬 작성

기준일: 2026-07-26
난이도: 중급
공식 기준: Creating Skills

개요

SKILL.md 형식, progressive disclosure, env 요구, 배포 위치를 공식 기준으로 정리합니다.

핵심 개념

개념	설명
Skill vs Tool	지침 vs 코드 통합
Progressive disclosure	목록→본문→스크립트
requires_env	로드 전 자격증명
Blueprints	자동화 템플릿 겸 스킬

상세

스킬 vs 도구

원문 절: Should it be a Skill or a Tool?

• Skill
• Tool

스킬 디렉터리 구조

원문 절: Skill Directory Structure

• 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.

skills/
├── research/
│   └── arxiv/
│       ├── SKILL.md              # Required: main instructions
│       └── scripts/              # Optional: helper scripts
│           └── search_arxiv.py
├── productivity/
│   └── ocr-and-documents/
│       ├── SKILL.md
│       ├── scripts/
│       └── references/
└── ...

SKILL.md 형식

원문 절: SKILL.md Format

• 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.

When to Use

• 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.

Quick Reference

• 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.

Procedure

• 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.

Pitfalls

• 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.

Verification

• Platform-Specific Skills — 공식 하위 절. 구현·설정 세부 원문 참조.
• Conditional Skill Activation — 공식 하위 절. 구현·설정 세부 원문 참조.
• Environment Variable Requirements — 공식 하위 절. 구현·설정 세부 원문 참조.

Field	Behavior
requires_toolsets	Skill is hidden when ANY listed toolset is not available
requires_tools	Skill is hidden when ANY listed tool is not available
fallback_for_toolsets	Skill is hidden when ANY listed toolset is available
fallback_for_tools	Skill is hidden when ANY listed tool is available

### Platform-Specific Skills

Skills can restrict themselves to specific operating systems using the `platforms` field:

로드 시 보안 설정

원문 절: Secure Setup on Load

• Config Settings (config.yaml) — 공식 하위 절. 구현·설정 세부 원문 참조.
• Credential File Requirements (OAuth tokens, etc.) — 공식 하위 절. 구현·설정 세부 원문 참조.
• Storage:
• Discovery:
• Runtime injection:
• Manual setup:

required_environment_variables:
  - name: TENOR_API_KEY
    prompt: Tenor API key
    help: Get a key from https://developers.google.com/tenor
    required_for: full functionality

스킬 가이드라인

원문 절: Skill Guidelines

• No External Dependencies — 공식 하위 절. 구현·설정 세부 원문 참조.
• Progressive Disclosure — 공식 하위 절. 구현·설정 세부 원문 참조.
• Include Helper Scripts — 공식 하위 절. 구현·설정 세부 원문 참조.
• Deliver media as documents ([[as_document]]) — 공식 하위 절. 구현·설정 세부 원문 참조.
• Test It — 공식 하위 절. 구현·설정 세부 원문 참조.

Token	Replaced with
${HERMES_SKILL_DIR}	Absolute path to the skill's directory
${HERMES_SESSION_ID}	The active session id (left in place if there is no session)

To analyse the input, run:

    node ${HERMES_SKILL_DIR}/scripts/analyse.js <input>

스킬 위치

원문 절: Where Should the Skill Live?

• broadly useful to most users
• optional-skills/
• Skills Hub

Blueprints: skills that are also automations

• blueprint
• Installing a blueprint.
• suggested cron job
• opt-in
• source
• Sharing an automation you built.

metadata:
  hermes:
    tags: [blueprint, email]
    blueprint:
      schedule: "0 8 * * *"     # presence of `blueprint:` marks it runnable
      deliver: telegram          # optional (default: origin)
      prompt: "Summarize my unread email and today's calendar."  # optional
      no_agent: false            # optional

Suggested Cron Jobs

• never
• important-mail monitor

Source	Trigger
catalog	Curated starter automations (/suggestions catalog) — daily briefing, important-mail monitor, weekly review, workday-start reminder
blueprint	You installed a skill carrying a blueprint: block
usage	The background review noticed a recurring ask a schedule would serve
integration	You connected an account (Gmail, GitHub, ...) and the obvious automations are offered

/suggestions             # list pending
/suggestions accept N    # schedule suggestion N (creates the cron job)
/suggestions dismiss N   # dismiss it — latched, never re-offered
/suggestions catalog     # add the curated starter automations

Publishing Skills

• To the Skills Hub — 공식 하위 절. 구현·설정 세부 원문 참조.
• To a Custom Repository — 공식 하위 절. 구현·설정 세부 원문 참조.

hermes skills publish skills/my-skill --to github --repo owner/repo

Security Scanning

• 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.

체크리스트

• 공식 원문 Creating Skills과 대조했다
• 관련 코드·설정·권한을 로컬에서 확인했다
• 보안·opt-in·allowlist 정책을 지켰다
• 스모크 테스트 또는 단계 검증을 수행했다

다음 단계

• 공식 문서: Creating Skills
• Hermes Agent 소개
• 트러블슈팅

---

기준일: 2026-07-26 — 공식 문서 동기화 코퍼스