Utility Skills

일상적인 작업을 위한 범용 도우미 스킬입니다. 문서 처리(PDF, XLSX), 메모리 관리, 화면 캡처, 비밀번호, 날씨, 텍스트 음성 변환, 동영상 다운로드 등을 포함합니다. 이 스킬들은 다른 카테고리에 깔끔하게 분류되지 않는 다양하지만 필수적인 작업들을 처리합니다.

Overview

Utility 스킬은 광범위한 일상 작업을 다룹니다. 일부는 하네스에서 직접 로드하는 내장 스킬이고, 나머지는 MCP 서버 또는 외부 도구 연동으로 구현됩니다. 이 중 5개 스킬은 기본 활성화(Active) 상태로 제공되며, 나머지 7개는 사용 가능하지만 설정이나 외부 의존성이 필요합니다.

memory

세션 간에 유지되는 영구 메모리입니다. memory 스킬은 중요한 컨텍스트 -- 결정 사항, 선호 설정, 프로젝트 노트, 피드백 -- 를 자동으로 저장하고 관련될 때 불러옵니다. 메모리는 ~/.cli-jaw/memory/ 아래에 Markdown 파일로 저장되며, 빠른 검색을 위해 SQLite로 인덱싱됩니다.

기능

사용 예시

# Manually save a note
/memory save "JWT tokens expire after 24h in this project"

# Search memories
/memory search "authentication"

# List all memory files
/memory list

# Delete a specific memory
/memory delete shared/old-decision.md

메모리 구조

메모리는 네임스페이스가 지정된 Markdown 파일로 구성됩니다. 자동 메모리 시스템은 MEMORY.md를 인덱스로 작성하고, 세부 항목은 주제별 파일에 기록합니다.

~/.cli-jaw/memory/
  MEMORY.md                    # Index with links to detailed files
  feedback_goal_done_method.md # Specific feedback entry
  feedback_poll_dont_wait.md   # Another feedback entry
  shared/
    decisions.md               # Shared project decisions
    preferences.md             # User preferences

pdf

텍스트 기반 PDF 처리 스킬입니다. PDF 파일을 읽고, 텍스트 내용을 추출하며, 구조(제목, 표, 목록)를 파싱하고, 요약을 지원합니다. 선택 가능한 텍스트가 포함된 디지털 PDF에서 가장 잘 동작합니다.

기능

사용 예시

# Read a PDF file
/pdf read ~/Documents/report.pdf

# Read specific pages
/pdf read ~/Documents/report.pdf --pages 1-5

# Summarize a PDF
/pdf summarize ~/Documents/whitepaper.pdf

# Extract metadata
/pdf info ~/Documents/contract.pdf

pdf-vision

비전 기반 PDF 읽기 스킬입니다. 멀티모달 모델을 사용하여 스캔 문서, 이미지가 많은 PDF, 텍스트 추출이 실패하는 페이지를 해석합니다. 각 페이지를 이미지로 렌더링하여 시각적으로 분석하므로, 손글씨 메모, 스캔된 영수증, 복잡한 레이아웃 처리에 필수적입니다.

pdf-vision과 pdf 중 어떤 것을 사용할지

사용 예시

# Read a scanned PDF with vision
/pdf-vision read ~/Documents/scanned-receipt.pdf

# Analyze specific pages visually
/pdf-vision read ~/Documents/diagram-heavy.pdf --pages 3-5

# Extract text from a handwritten note
/pdf-vision read ~/Documents/handwritten.pdf

screen-capture

전체 화면, 특정 창 또는 지정된 영역의 스크린샷을 캡처합니다. 캡처된 이미지는 비전 모델로 분석하거나, 디스크에 저장하거나, vision-click 같은 다른 스킬의 입력으로 사용할 수 있습니다.

기능

사용 예시

# Capture full screen
/screen-capture

# Capture and analyze the screen
/screen-capture --analyze

# Save to a specific path
/screen-capture --output ~/Desktop/screenshot.png

# Capture a specific region (x, y, width, height)
/screen-capture --region 0,0,800,600

xlsx

Excel 스프레드시트 처리 스킬입니다. .xlsx 파일을 읽고, 쓰고, 조작합니다 -- 시트에서 데이터를 추출하고, 새 워크북을 만들고, 셀을 업데이트하고, 형식 간 변환(CSV, JSON)을 수행합니다. 수식, 다중 시트, 기본 서식 지정을 지원합니다.

기능

사용 예시

# Read an Excel file
/xlsx read ~/Documents/sales-data.xlsx

# Read a specific sheet
/xlsx read ~/Documents/report.xlsx --sheet "Q4 Summary"

# Convert XLSX to CSV
/xlsx convert ~/Documents/data.xlsx --to csv

# Create a new spreadsheet from data
/xlsx write ~/Documents/output.xlsx --data '[{"name":"Alice","score":95},{"name":"Bob","score":87}]'

1password

1Password 볼트에서 안전하게 자격 증명을 조회합니다. 1password 스킬은 1Password CLI(op)를 사용하여 로그인 정보, 비밀번호, 보안 메모, API 키 등의 항목을 검색하고 가져옵니다 -- 대화에 평문으로 노출하지 않습니다. 자격 증명은 명령어나 환경 변수에 직접 주입됩니다.

기능

사용 예시

# Search for a credential
/1password search "GitHub token"

# Get a specific password
/1password get "AWS Production" --field password

# Inject a secret into a command
op run --env-file=.env -- jaw serve

# List all vaults
/1password vaults

goplaces

위치 기반 검색 및 내비게이션 스킬입니다. 장소를 찾고, 길을 안내하며, 상점, 랜드마크, 주소에 대한 정보를 제공합니다. MCP 서버를 통해 지도 API로 구동됩니다.

기능

사용 예시

# Search for a place
/goplaces search "coffee shops near Gangnam Station"

# Get directions
/goplaces directions "Seoul Station" "Gangnam Station"

# Get details about a specific place
/goplaces details "Starbucks Gangnam"

# Find nearby restaurants
/goplaces nearby --type restaurant --radius 500m

summarize

긴 텍스트를 간결한 요약으로 압축합니다. 기사, 트랜스크립트, 회의록, 문서 등 긴 텍스트 입력에 사용할 수 있습니다. 글머리 기호, 문단, 경영진 요약, 핵심 요점 등 다양한 요약 스타일을 지원합니다.

사용 예시

# Summarize a file
/summarize ~/Documents/meeting-notes.md

# Summarize with a specific style
/summarize ~/Documents/report.pdf --style bullets

# Summarize clipboard content
/summarize --clipboard

# Summarize a web article
/summarize https://example.com/long-article

tts

텍스트 음성 변환 스킬입니다. TTS 엔진(시스템 음성 또는 클라우드 API)을 사용하여 텍스트 입력을 음성 오디오로 변환합니다. 문서를 소리 내어 읽거나, 텍스트에서 오디오 파일을 생성하거나, 접근성을 위해 유용합니다.

사용 예시

# Speak text aloud
/tts "Hello, this is a test of the text-to-speech system."

# Save to file
/tts "Meeting summary follows..." --output ~/Desktop/summary.mp3

# Use a specific voice
/tts "안녕하세요" --voice korean --engine openai

# Read a file aloud
/tts --file ~/Documents/notes.md

video-downloader

yt-dlp를 사용하여 URL에서 동영상을 다운로드합니다. YouTube, Vimeo 및 수백 개의 동영상 플랫폼을 지원합니다. 화질 선택, 오디오만 추출, 자막 다운로드, 지정된 디렉토리에 저장 등의 기능을 제공합니다.

기능

사용 예시

# Download a video
/video-downloader https://www.youtube.com/watch?v=dQw4w9WgXcQ

# Download audio only
/video-downloader https://www.youtube.com/watch?v=dQw4w9WgXcQ --audio

# Download with specific quality
/video-downloader https://www.youtube.com/watch?v=dQw4w9WgXcQ --quality 720p

# Download subtitles
/video-downloader https://www.youtube.com/watch?v=dQw4w9WgXcQ --subs ko

video-frames

분석을 위해 동영상 파일에서 개별 프레임을 추출합니다. 지정된 간격이나 타임스탬프에서 프레임을 캡처하고, 이미지로 출력하며, 선택적으로 비전 모델에 보내 설명을 생성합니다. 동영상 요약, 콘텐츠 분석, 썸네일 생성에 유용합니다.

사용 예시

# Extract one frame per second
/video-frames ~/Videos/demo.mp4 --interval 1s

# Extract frame at a specific timestamp
/video-frames ~/Videos/demo.mp4 --at 01:23:45

# Extract and analyze frames with vision model
/video-frames ~/Videos/demo.mp4 --interval 10s --analyze

# Generate thumbnails for a video
/video-frames ~/Videos/demo.mp4 --count 5 --output ~/Desktop/thumbs/

weather

현재 날씨 상태 및 예보를 제공합니다. 모든 위치에 대한 기온, 습도, 바람, 강수량 및 다일 예보를 제공합니다. 날씨 API를 조회하는 MCP 서버로 구현되어 있습니다.

기능

사용 예시

# Get current weather
/weather Seoul

# Get a 5-day forecast
/weather forecast "San Francisco" --days 5

# Get hourly forecast
/weather hourly Tokyo --hours 24

# Check weather alerts
/weather alerts "New York"

설정

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "weather-mcp-server"],
      "env": {
        "WEATHER_API_KEY": "your-api-key",
        "WEATHER_DEFAULT_LOCATION": "Seoul"
      }
    }
  }
}

스킬 비교

작업에 적합한 유틸리티 스킬을 선택하기 위한 빠른 참조표입니다.

문서 처리

미디어 및 캡처

정보 및 시크릿

일반적인 패턴

문서 파이프라인

PDF와 요약 스킬을 결합하여 문서를 처음부터 끝까지 처리합니다.

# Read a PDF, summarize it, and save the summary
"이 PDF 읽고 요약해서 엑셀로 정리해줘"

# The agent chains:
# 1. pdf → read the document
# 2. summarize → condense key points
# 3. xlsx → write summary to a spreadsheet

리서치 워크플로우

날씨, 위치, 메모리 스킬을 함께 사용하여 계획 작업을 수행합니다.

# Plan a trip
"이번 주말 부산 날씨 알려주고, 근처 맛집 찾아줘. 결과 기억해둬."

# The agent chains:
# 1. weather → forecast for Busan this weekend
# 2. goplaces → search restaurants near Busan
# 3. memory → save results for later reference

보안 개발

1Password에서 자격 증명을 가져와 개발 환경에 주입합니다.

# Set up dev environment with secure credentials
"1Password에서 DB 비밀번호 찾아서 .env에 넣어줘"

# The agent chains:
# 1. 1password → get "Database Production" password
# 2. inject into .env file via op:// reference