LLM Wiki

TypeSafe Agent Skills 저장소 — System One 빌드용 공식 스킬 (한국어 정리)

Properties2
descriptionTypeSafe 공식 에이전트 스킬 저장소 한국어 정리 — System One 설계 원칙·판단 프리미티브·설치법과 SKILL.md 구조
tagsai-agents, ai-coding, automation

6 min read

원문: typesafe-ai/skills · 수집일: 2026-09-20 · 기준 커밋 65a39f3 (Release v0.5.7, 2026-09-12) · Stars 791 · Forks 39 · MIT

핵심 요지

TypeSafe(System One 모델로 typed decisions·probabilities를 내는 API)로 빌드하기 위한 공식 에이전트 스킬 저장소다. 스킬 1종(typesafe-ai)이 TypeSafe 워크플로 설계법·최신 문서 탐색법·코드 내 typed judgment 구성법을 담고 있으며, Claude Code 플러그인과 skills.sh 양쪽 설치를 지원한다. 핵심 설계 원칙은 2026-09-19-typesafe-use-case-map과 동일하다 — 코드가 제어 흐름을 소유하고, 모델은 좁고 형식화된 판단만 맡는다.

주요 내용

구성 (파일 6개)

  • skills/typesafe-ai/SKILL.md — 스킬 본체 (아래 구조 참조)
  • .claude-plugin/marketplace.json + plugin.json — Claude Code 플러그인 매니페스트 (플러그인명 typesafe, 버전 0.5.7)
  • README.md — 설치·사용 안내, LICENSE + 스킬 내장 LICENSE — 모두 MIT

설치

  • Claude Code: claude plugin marketplace add typesafe-ai/skills → claude plugin install typesafe@typesafe-ai, 명시적 호출은 /typesafe:typesafe-ai
  • 타 에이전트: npx skills add typesafe-ai/skills --skill typesafe-ai (기본 project-local, -g로 글로벌)
  • 사용 예시 프롬프트: “Use TypeSafe to route incoming support tickets by department, with human review for uncertain decisions.”

SKILL.md 설계 지침 (5섹션 요약)

  1. 모델관 — Jev를 포함한 System One 모델은 텍스트 생성·추론 설명이 아니라 typed answers·probabilities를 반환하는 “프로그래밍 프리미티브 같은 작은 AI 지능”. 워크플로는 코드 소유.
  2. 라이브 문서가 source of truth — 스킬은 방향만 주고 개념·API 계약·SDK·제한은 docs.typesafe.ai/llms.txt 인덱스에서 선별 읽기. 작업별 시작점 표(프로그래밍 모델→System One·building guide, 탐색→Use-case map+쿡북, 입력→State·primitives, 불확실성→Confidence, 코드→HTTP API·Python/JS SDK, 구 통합→Migration guide).
  3. 형태 찾기 — 원하는 동작에서 역으로 필요한 판단을 도출. 분류 너머 출발점 6종: route+인자 채우기 / select-not-generate / 증거 탐색·판단 / 판단의 재사용 데이터화 / 검증·에스컬레이션 / 변화 상태 대응.
  4. 판단 설계 — 의미 기준 프리미티브 선택: 정의 집합 중 하나→Choice, 조건 성립→Noul, 서술 차원 정도→Score. 질문당 충분한 state(named JSON 선호), 판단은 instructions·가능 답은 criteria에, no-match 결과 포함, 후보 커버리지 확인.
  5. 구성·검증 — 같은 state 위 독립 질문은 함께 묻기(병렬). 2차 요청은 증거 조회·새 state·다음 옵션 결정에 필요할 때만. 임계값은 사용자 데이터 기준 평가. Choice/Score confidence는 분포 집중도지 정확도·행동 허가가 아님. Typed output은 인터페이스 보장지 진실 보장 아님. API 키는 서버사이드 보관.

저장소 이력

  • 619f78a Initial commit (Allie Laabs, 2026-08-25) → 65a39f3 Release v0.5.7 (bot, 2026-09-12). 커밋 2건의 얇은 저장소 — 스킬 내용은 SKILL.md 1파일에 집중.

해석과 적용 메모

  • 내 해석: 이 스킬은 2026-09-19-typesafe-use-case-map의 “브레인스토밍 지도”와 2026-09-20-diogo-almeida-after-rlhf의 “제3의 최적화” 이론을 에이전트 실행 지침으로 압축한 문서다. 특히 confidence 해석 주의사항(Noul 0.5=유사 확률이지 중간 강도 아님, 저확신이 무해 선호를 무효화하지 않음)은 하네스에 판단 게이트를 붙일 때 그대로 써먹는 규칙이다.
  • 적용: 코딩 에이전트에 TypeSafe 게이트를 붙일 때 참조 순서는 본 스킬(SKILL.md 설계 지침) → Use-case map의 해당 축 → 2026-09-19-awesome-jev·2026-09-19-awesomejev-com의 상위 구현(foreman·jev-review·jev-router) 순이 실용적이다. jev-ultrafast는 operation·target 묶음 판단의 실전 사례.
  • 주의: Stars 791은 수집 시점 수치이며 품질 보증이 아니다. SKILL.md가 가리키는 라이브 문서 본문은 이번 수집에 미포함 — 버전 의존 상세를 인용할 때는 반드시 라이브 문서를 직접 확인할 것.

관련 페이지

백링크