Install
npx skills add mastra-ai/skills누구에게 맞나
Mastra 프레임워크로 AI 앱이나 agent를 쓰고 코딩 도우미가 공식 스킬대로 하게 하려는 사람에게 맞다. 공식 문구: 이것들은 Mastra 프레임워크를 쓰는 agent를 위한 정식 스킬이다. Mastra는 현대 TypeScript 스택으로 AI 앱과 agent를 만드는 프레임워크다. 프레임워크 사이트:
https://mastra.ai/
더 맞는 사람은 이미 TypeScript / Mastra 프로젝트가 있거나 공식 종합 스킬로 개발하려는 사람이다. 원문은 수록 내용을 「단일 종합 스킬」로 적고 progressive disclosure와 참고 파일로 이후 주제를 덮는다. 이 단락은 그 참고 파일 이름을 적지 않는다.
시작 전에 npx skills add를 실행할 수 있어야 한다. 주 경로를 검증되지 않은 다른 설치기로 바꾸지 말 것.
3분 안에 첫 시도를 마치기
저장소가 준 주 설치 명령만 따른다. 첫 시도는 읽기 전용 대조다. 새 운영 agent를 아직 만들지 말 것.
전제 조건: 이 기기에 이미 npm/npx가 있고, 자신의 TypeScript 프로젝트 또는 곧 초기화할 Mastra 코드가 있다. 예시 저장소 주소를 만들지 말 것.
설치 위치: 작업 공간에서 실행한다:
npx skills add mastra-ai/skills
공식 저장소:
https://github.com/mastra-ai/skills
낮은 위험 트리거: 설치 후 이 종합 스킬로 기존 Mastra 코드 구조를 점검하게 하고, 어떤 공식 지침을 볼지만 말하게 하며 파일은 아직 바꾸지 말 것. 도우미가 새 agent를 만들거나 네트워크 호출을 쓰기 시작하면 먼저 부작용을 확인한다.
성공 신호: 스킬이 추가되었고 도우미가 「단일 종합 스킬」로 Mastra 개발을 이야기하며 확인하지 않은 파일을 쓰지 않았다. 스킬이 나타나지 않으면 먼저 설치 명령이 완전한지 맞추고, 지명되지 않은 패키지 이름으로 바꾸지 말 것.
사용 사례
사례 1: 기존 TypeScript 프로젝트에서 Mastra 개발 점검을 한다. 공식 종합 스킬을 쓴다. 앱 골격이 이미 있고 정식 스킬로 agent 능력을 채우려는 사람에게 맞다. 증거는 progressive disclosure와 참고 파일만 말하며 파일 이름은 적지 않는다. 먼저 점검한 뒤 코드를 바꿀지 정한다.
사례 2: .well-known 발견을 쓴다. Mastra는 그 발견 표준도 지원하며 공식 보충 명령은 다음과 같다.
npx skills add https://mastra.ai/
저장소는 RFC 8615 Well-Known URI로 스킬을 제공한다:
https://mastra.ai/.well-known/skills/
표준 설명:
https://github.com/cloudflare/agent-skills-discovery-rfc
프레임워크 사이트에서 스킬을 발견하려는 사람에게 맞다. 이것은 두 번째 설치 경로다. 주 명령과 같은 작업에서 섞지 말 것. 증거는 발견 후 어떤 파일이 들어가는지 적지 않는다.
사용 경계
주 설치 명령은 npx skills add mastra-ai/skills이다. .well-known 경로는 보충이며 기본 첫 시도가 아니다.
원문은 「단일 종합 스킬」만 적으며 스킬 폴더를 지명하지 않는다. skills/ 경로나 참고 파일 이름을 채우지 말 것.
이것은 TypeScript 프레임워크 위의 공식 스킬이다. 다른 언어의 설치 단계도, 도우미 배타 명단도 없다.
추가 문서 사이트 밖의 주소를 만들지 말 것. 프레임워크 사이트와 저장소 페이지 밖에서는 원문의 발견 주소와 RFC 링크만 쓴다.