Skip to content

스킬 ​

라우트 /skills. 스킬 마켓플레이스를 검색하고 찾은 것을 설치합니다.

Skills

검색 ​

검색어를 입력하고 Search(검색)를 누릅니다. 검색은 core에 설정된 모든 마켓플레이스를 훑으며, 각 결과에는 어느 출처에서 왔는지가 표시됩니다.

결과 목록이 비어 있는 상태는 뜻이 모호하므로, 이 화면은 그대로 두지 않습니다. 검색 후에는 언제나 다음 네 가지 중 하나가 화면에 있습니다.

  • 마켓플레이스가 결과를 돌려준 경우의 목록 행,
  • 접근하지 못한 출처를 알려주는 알림,
  • 모든 출처가 응답했지만 일치하는 것이 없을 때의 명시적인 "no match" 문구,
  • 검색 자체가 실패했을 때의 오류.

이 구분은 오프라인에서 중요합니다. 어떤 마켓플레이스에도 닿지 못했다면 정직한 답은 "물어볼 곳이 없었다"이지 "아무것도 없다"가 아닙니다.

일부 허브는 연결이 안 되는 것이 아니라 레지스트리에서 의도적으로 비활성화되어 있습니다 — 이 글을 쓰는 시점에는 agentskills.io와 Hermes Hub가 그렇습니다. 이런 허브는 경고 대신 조용한 "Not included: …" 줄로 표시되며, 이유는 툴팁(ⓘ)에 있습니다 — 애초에 이번 검색의 후보가 아니었으므로, 연결이 끊긴 허브와 달리 결과가 불완전해지는 것은 아닙니다.

스킬 만들기 ​

헤더의 New skill(새 스킬)을 누르면 SKILL.md를 만드는 두 가지 방법이 있는 시트가 열립니다.

  • Let the agent draft it(에이전트에게 맡기기) — 이름과 무엇을 해야 하는지를 적고, 이름과 범위(이 프로젝트만, 또는 모든 프로젝트)를 고릅니다. 에이전트는 지금 열려 있는 스레드의 턴으로 파일을 직접 씁니다 — 다른 파일이 쓰이는 것을 지켜보듯 그 스레드에서 지켜보세요. 시트는 닫히고, 그 턴이 끝날 때까지 Skills 화면에 "Drafting…" 줄이 남아 있습니다.
  • Write it myself(직접 쓰기) — 이름과 범위는 같지만, 대신 SKILL.md 편집기가 열립니다. frontmatter(name, description, version)와 "When to use", "Steps", "Checks" 항목이 있는 기본 템플릿으로 시작합니다. frontmatter는 실시간으로 검사되며, 레지스트리가 적용하는 규칙과 같습니다 — 잘못된 이름이나 너무 짧은 설명은 Save 이후가 아니라 그전에 걸러집니다. 이름이 이미 있으면 Save가 조용히 실패하는 대신 "Overwrite it"(덮어쓰기) 체크박스로 바뀝니다.

어느 쪽이든 스킬이 만들어지면 "Run it with /name" 배너가 나타나, 지금 열려 있는 스레드의 입력창에 슬래시 명령을 바로 넣어 줍니다.

설치된 스킬 편집하기 ​

설치된 스킬 행의 Edit(편집)은 디스크에서 읽어온 같은 SKILL.md 편집기를 엽니다. Save는 파일을 다시 쓰고 설치 목록을 새로 고칩니다. 패키지로 들어온 (builtin) 스킬은 대신 built-in 배지를 달고 있습니다 — 이 창이 쓰거나 지울 수 있는 디스크 위치가 없으므로, 행에는 View(보기)가 제공됩니다 — 같은 편집기이지만 읽기 전용이고 Save가 없습니다.

대화를 스킬로 저장하기 ​

스레드의 ⋯ 메뉴에서 Save this conversation as a skill(이 대화를 스킬로 저장)은 이름을 묻고 /skill learn <name>을 보냅니다 — 에이전트가 대화 기록을 읽어 그로부터 SKILL.md를 씁니다. 직접 명령을 입력한 것과 같습니다.

설치 ​

목록 행의 Install(설치)은 그 스킬을 core를 통해 설치합니다. 결과 아래의 출처 입력 상자는 검색이 다루지 않는 곳에서 설치할 때 씁니다.

  • 로컬 디렉터리 — ./my-skill
  • 아카이브 URL — https://…/skill.zip
  • 레지스트리 이름

설치된 스킬 ​

아래쪽 표는 현재 설치된 스킬과 각각의 종류를 보여줍니다. 화면을 열 때 불러오며, Refresh list(목록 새로 고침)로 다시 읽습니다.

스킬을 설치하면 슬래시 명령이 추가될 수 있습니다. 스레드의 명령 팔레트가 컴퓨터마다 다른 명령을 제공하는 이유가 바로 이것입니다.

MIT licensed. The manual is generated from the product repositories — see the banner on each page.