웹 스킬 개발
브라우저 자동화 스킬을 녹화하고, 검증하고, 발행하는 전체 워크플로우
웹 스킬은 브라우저 자동화 작업을 녹화하여 재사용 가능한 슬래시 명령(/skill-name)으로 만드는 기능입니다. 에이전트에게 스킬을 배정하면 웹사이트를 자동으로 탐색할 수 있습니다.
스킬이란?
스킬은 마크다운(.md) 파일로 저장되는 웹 자동화 레시피입니다.
- 특정 사이트에서 데이터 수집
- 웹 서비스 로그인 후 작업 수행
- 반복적인 웹 폼 작성 자동화
스킬 파일 구조
---
name: "skill-name"
description: "스킬 설명"
domain: "example.com"
auth: "none"
category: "data"
tags: ["scraping", "automation"]
---
# 이 스킬이 하는 일
[스킬의 동작을 자연어로 설명]
## 성공 기준
[작업이 성공했는지 판단하는 기준]
## 단계
[순서대로 수행할 브라우저 작업]개발 워크플로우
스킬 피커 진입
Skills 탭 > 스킬 허브에서 "새 웹 스킬 시작" 카드를 탭하거나, 기존 스킬을 선택하여 수정합니다. 워크스페이스 이름을 입력하면 스킬 워크스페이스가 생성됩니다.
워크스페이스 준비
스킬 워크스페이스 상세 화면에서 현재 상태를 확인합니다.
상태 칩(draft → recording → verifying → ready → published)으로 진행 상황을 추적합니다.
브라우저 녹화
스튜디오를 열면 전체 화면 브라우저가 표시됩니다. 실제 웹사이트에서 작업을 수행하면 page-visit, click, input, submit, scroll, back/forward 액션이 자동으로 녹화됩니다.
인스펙터로 확인
녹화된 단계, 초안, 검증 상태를 인스펙터 바텀 시트에서 확인합니다. (아래 인스펙터 섹션 참고)
Replay 검증
skill.md의 프론트매터와 성공 기준을 파싱하여 격리된 브라우저에서 스킬을 자동 실행하고 성공 여부를 판정합니다.
발행
검증을 통과하면 스킬이 ~/.angski/skills/<name>.md에 저장되고 에이전트에 배정할 수 있습니다.
녹화 팁
불필요한 탐색(OTP 입력 등) 중에는 녹화를 일시정지하세요. 최소 2단계 이상 녹화해야 검증이 가능합니다. "성공 마크"를 사용하여 작업 완료 기준을 명확히 설정하세요.
자동 제안 시스템
녹화 중 시스템이 자동으로 의사결정을 요청합니다.
2단계 이상 녹화 후:
"이 플로우에 로그인이 포함되나요?" —
auth:none(권장) 또는auth:login선택
3단계 이상 & 인증 모드 설정 후:
"현재 화면을 성공 기준으로 설정할까요?" —
success:current(권장) 또는success:later선택
인스펙터
인스펙터 바텀 시트에는 3개 탭이 있습니다.
녹화된 모든 단계를 순서대로 표시합니다.
- 각 단계: 번호, 제목, 종류, 상세, URL
- 단계 삭제: 개별 단계 제거
- 이후 자르기 (Trim After): 선택한 단계 이후 모두 삭제
- 여정 초기화: 전체 단계 삭제 (확인 필요)
발행 조건
모든 조건을 충족해야 스킬을 발행할 수 있습니다:
- Replay Verify 상태가
pass - 마지막 검증 이후 초안이 변경되지 않음
발행 차단 사유
다음 중 하나라도 해당되면 발행이 차단됩니다:
- Studio 세션 미시작
- 녹화 단계 2개 미만
- Replay Verify 진행 중
- 검증 미통과
- 초안 변경 후 재검증 미실행
상태 전이 다이어그램
draft → recording → (제안 선택) → recording → (Replay Verify)
→ verifying → pass → ready → (Publish) → published
fail → recording (수정 후 재검증)발행 후에도 추가 녹화가 가능하며, 이 경우 상태가 recording으로 돌아갑니다.