Communitygithub.com

AsadJaved66/Web-Skills-Protocol

AI 에이전트가 웹사이트 기능을 발견하고 사용할 수 있도록, 웹 상호작용을 위한 실행 가능한 태스크 파일을 게시하는 개방형 표준입니다.

Web-Skills-Protocol란 무엇인가요?

Web-Skills-Protocol은 AI 에이전트(예: Claude Code, Cursor, Codex)가 웹사이트와 상호작용하는 방식을 표준화하는 개방형 프로토콜입니다. 이 프로토콜은 각 웹사이트가 자신의 기능을 '스킬(Skill)'로 정의한 JSON 또는 Markdown 파일을 게시함으로써, AI 에이전트가 해당 사이트를 사용하는 방법을 스스로 발견하고 실행할 수 있게 합니다. 개발자는 이 프로토콜을 통해 자신의 웹사이트나 서비스에 대한 AI 친화적인 인터페이스를 제공할 수 있으며, 에이전트는 수동 문서 없이도 즉시 사이트 기능(예: 검색, 예약, 데이터 조회)을 수행할 수 있습니다. 이는 AI 에이전트의 웹 자율성을 높이고, 사이트별 맞춤 통합 비용을 크게 절감합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add AsadJaved66/Web-Skills-Protocol

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Web-Skills-Protocol은(는) 무엇을 하나요?

AI 에이전트가 웹사이트 기능을 발견하고 사용할 수 있도록, 웹 상호작용을 위한 실행 가능한 태스크 파일을 게시하는 개방형 표준입니다.

개요

Web-Skills-Protocol은 AI 에이전트(Claude Code, Cursor, Codex 등)가 웹사이트와 상호작용하는 방식을 표준화합니다. 각 웹사이트는 자신의 기능을 설명하는 스킬 파일(JSON 또는 Markdown)을 제공하며, 에이전트는 이를 자동으로 발견하고 실행합니다.

주요 기능

  • 표준화된 스킬 정의: 웹사이트의 작업(task)을 기계가 읽을 수 있는 형식으로 정의
  • 자동 발견(Discovery): 에이전트가 웹사이트의 .well-known/skills 또는 표준 엔드포인트를 통해 스킬 목록을 조회
  • 실행 가능한 태스크: 각 스킬은 구체적인 API 호출, 폼 입력, 데이터 추출 등의 작업을 포함
  • 플랫폼 독립적: 모든 AI 에이전트 프레임워크와 호환 가능

사용 방법

  1. 웹사이트 루트에 skills/ 디렉토리 생성
  2. 각 스킬을 Markdown 또는 JSON 파일로 정의
  3. .well-known/skills 엔드포인트에 스킬 목록 게시
  4. AI 에이전트가 자동으로 스킬을 발견하고 활용

예시 스킬 파일

{
  "name": "search-products",
  "description": "제품 검색 및 결과 반환",
  "endpoint": "/api/search",
  "method": "GET",
  "parameters": {
    "query": "검색어",
    "category": "카테고리 (선택사항)"
  },
  "output": "JSON 배열 of products"
}

라이선스

MIT

관련 스킬