llms-txt-skills은(는) 무엇을 하나요?
RFC v0.2 + 참조 구현: llms.txt를 통해 Agent Skills를 게시하기 위한 것입니다. 파서, 검사기, JSON 스키마, 예제 skills를 포함합니다.
소개
이 프로젝트는 Agent Skills(예: Claude Code, Cursor, Codex 등에서 사용하는)를 llms.txt 파일을 통해 게시하고 발견하는 표준 방법을 정의하는 RFC입니다. 이는 기존의 llms.txt (웹사이트와 AI 모델을 위한 도움말 파일) 표준을 확장합니다.
왜 llms.txt Skills인가?
- 검색 가능성: 정적 사이트나 저장소에 배치된 표준
llms.txt파일을 통해 스킬을 쉽게 검색할 수 있습니다. - 호환성: 플랫폼 독립적이며, Claude Code, Cursor, Codex 등 모든 AI 에이전트와 함께 작동합니다.
- 간결함: 스킬 정의는
llms.txt파일 내에 간단한 선언으로 작성됩니다. - 검증 가능: JSON 스키마를 사용하여 스킬 정의의 유효성을 검증할 수 있습니다.
작동 방식
- 프로젝트 루트에
llms.txt파일을 추가합니다. - 스킬을 마크다운 블록으로 정의합니다 (자세한 내용은 아래 RFC 참조).
- 에이전트가
llms.txt파일을 읽고 로드할 수 있는 스킬 목록을 얻습니다.
RFC 개요
이 프로젝트는 llms.txt 내에서 Agent Skills를 선언하기 위한 표준을 정의합니다. 핵심 구성 요소는 다음과 같습니다:
- 스킬 선언:
llms.txt파일 내의skill ...블록. - JSON 스키마: 스킬 선언의 형식과 유효성을 정의합니다.
- 파서:
llms.txt파일을 읽고 스킬 선언을 추출하는 참조 구현. - 검사기: 추출된 스킬 선언의 유효성을 확인합니다.
사용 예시
기본 스킬 예시
```skill
name: greet-user
description: 에이전트가 사용자에게 인사하게 합니다.
type: tool
prompt: |
사용자에게 친근하게 인사하며, 어떤 도움이 필요한지 물어보세요.
### 일반 설정 예시
Agent Skills
이 파일은 에이전트가 사용할 수 있는 스킬을 선언합니다.
name: code-review
description: 에이전트에게 코드 리뷰를 요청하는 기능을 제공합니다.
type: prompt
prompt: |
당신은 숙련된 코드 리뷰어입니다. 사용자가 제공하는 코드를 분석하고, 잠재적인 문제, 개선 사항, 보안 취약점을 발견하세요.
## 설치 및 사용
### 참조 구현 (파서 및 검사기)
```bash
# 예시: npm 패키지 (아직 배포되지 않음)
npm install llms-txt-skills
import { parseSkills, validateSkill } from 'llms-txt-skills';
const markdown = fs.readFileSync('llms.txt', 'utf-8');
const skills = parseSkills(markdown);
skills.forEach(skill => {
const validation = validateSkill(skill);
if (validation.valid) {
console.log(`성공: ${skill.name} 로드됨`);
} else {
console.error(`오류: ${skill.name} - ${validation.errors.join(', ')}`);
}
});
기여하기
기여는 환영합니다! RFC 논의를 위한 이슈를 열거나 PR을 제출해 주세요.
라이선스
MIT
RFC v0.2 변경 사항
prompt필드 추가 (선택 사항).- 메타데이터를 위한
tags필드 지원. - 여러 줄 프롬프트를 위한 개선된 마크다운 구문 분석.
- 검사기에 대한 참조 JSON 스키마 포함.