> ## Documentation Index
> Fetch the complete documentation index at: https://flowglad.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> 외부 에이전트와 Automation을 위한 재사용 가능한 패키지 만들기

Skill은 지침과 선택적인 지원 파일로 구성된 재사용 가능한 패키지입니다. 팀이 작업을 완료하는 반복 가능한 방법을 한 번 정의한 뒤 Flowglad 전반에 일관되게 적용할 수 있습니다.

각 Skill에는 이름, 슬래시 명령 slug, 설명, Markdown으로 작성된 지침이 있습니다. 지원 파일은 해당 지침을 따르는 데 필요한 추가 컨텍스트나 리소스를 제공할 수 있습니다.

## Flowglad를 팀의 Skill 라이브러리로 사용하기

Flowglad는 각 Skill을 버전이 관리되는 패키지로 보관합니다. 변경 사항을 게시하면 이전 패키지를 그 자리에서 교체하는 대신 새 revision이 생성됩니다. Organization 관리자는 Skill의 **History**를 열어 revision을 검사하고, 변경 사항을 비교하고, 이전 revision을 복원하거나, 해당 작업이 가능한 경우 draft를 폐기할 수 있습니다.

이를 통해 팀은 특정 시점에 어떤 버전이 활성 상태였는지를 보존하면서 재사용 가능한 지침을 하나의 관리되는 장소에서 유지할 수 있습니다. Draft 및 거부된 revision은 활성 버전을 대체하지 않습니다.

### MCP로 Skill 관리하기

Flowglad MCP 서버를 연결하면 에이전트가 조직의 Skill 라이브러리를 대신 검사하고 관리할 수 있습니다.

* `skills.list`는 연결에서 볼 수 있는 Skill을 반환합니다.
* `skills.get`은 하나의 Skill에 대한 최신 및 활성 revision 메타데이터를 반환합니다.
* `skills.create`는 새 Skill 패키지를 제출합니다.
* `skills.create_candidate`는 기존 Skill의 새 revision을 제출합니다.
* `skills.publish_revision`은 보류된 revision을 검증하고 게시합니다.
* `skills.create_package_upload_session` 및 `skills.finalize_package_upload_session`은 inline으로 보내기에 너무 큰 패키지를 전송합니다.
* `skills.get`는 수락된 요청의 검증 및 승격 결과를 보고합니다.

Skill을 만들거나 업데이트하려면 팀원의 organization membership과 MCP 연결의 grant 모두에 `skills:write` 권한이 필요합니다. 서버를 연결한 후 권한을 추가했다면 Flowglad MCP를 다시 연결하고 `skills:write`를 승인해야 쓰기 도구를 사용할 수 있습니다.

**권한:** 관리자는 기본적으로 Skill 작성 권한을 가집니다. Contributor에게 같은 권한을 부여하려면 **Settings** → **Team**을 열고 팀원을 선택한 다음 **Skill Authoring**을 활성화하세요. 이렇게 하면 팀원을 관리자로 만들지 않고도 조직 Skill을 만들고 업데이트할 권한이 부여됩니다.

## Flowglad MCP Skill을 에이전트에 로드하기

Flowglad MCP 서버는 MCP 초기화 중에 `io.modelcontextprotocol/skills`를 알립니다. 이는 호환 클라이언트에게 서버가 에이전트 Skill 메서드 `skills/list` 및 `skills/get`을 구현한다는 것을 알려줍니다. 반환되는 각 Skill에는 `skill://` 리소스 URI와 콘텐츠 digest가 포함되며, 클라이언트는 `resources/read`로 파일을 가져올 수 있습니다.

서버를 연결했다고 해서 클라이언트가 `skills/list`를 호출하거나 반환된 패키지를 설치한다는 보장은 없습니다. 클라이언트 지원은 다양합니다. 에이전트가 각 세션 시작 시 Flowglad 레지스트리를 새로 고치도록 하려면 ChatGPT / Codex 또는 Claude에 시작 지침을 추가하세요.

**MCP 이름 지정:** 이름은 의도적으로 다릅니다. 점을 사용하는 `skills.list`는 조직의 버전 관리 Skill 레코드를 위한 Flowglad 도구입니다. 슬래시를 사용하는 `skills/list`는 에이전트용 Skill 패키지를 탐색하기 위한 MCP 프로토콜 확장 메서드입니다.

### 시작 지침 추가하기

새 세션을 시작하기 전에 대상 디렉터리를 한 번 만든 다음, 아래의 해당 지침 블록을 추가하세요.

#### ChatGPT / Codex

`mkdir -p ~/.agents/skills`로 ChatGPT / Codex 대상 디렉터리를 만드세요.

모든 프로젝트에 적용하려면 다음 블록을 `~/.codex/AGENTS.md`에, 저장소 팀과 공유하려면 해당 저장소의 `AGENTS.md`에 넣으세요.

```markdown AGENTS.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.agents/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `$skill-name` invocation.
6. If this ChatGPT / Codex client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

#### Claude

`mkdir -p ~/.claude/skills`로 Claude 대상 디렉터리를 만드세요.

모든 프로젝트에 적용하려면 다음 블록을 `~/.claude/CLAUDE.md`에, 저장소 팀과 공유하려면 해당 저장소의 `CLAUDE.md`에 넣으세요.

```markdown CLAUDE.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.claude/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `/skill-name` invocation.
6. If this Claude client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

ChatGPT / Codex 또는 Claude에게 적절한 블록을 자체 사용자 수준 지침 파일에 추가하도록 요청할 수 있습니다. 해당 파일은 향후 세션에 영향을 주므로 수락하기 전에 제안된 편집을 검토하세요. 이 지침은 최선의 노력(best-effort) 방식의 에이전트 bootstrap입니다. 환경에서 Skill을 결정적으로 새로 고쳐야 한다면 신뢰할 수 있는 `SessionStart` hook이나 MCP 클라이언트 통합에서 동일한 동기화를 구현하세요.

## Skill이 사용되는 곳

현재 Skill에는 두 가지 소비자가 있습니다.

* 호환되는 외부 에이전트는 Flowglad MCP를 통해 활성화된 패키지를 탐색하고 동기화한 다음, 자동으로 매칭하거나 이름으로 호출합니다.
* Automation은 게시된 정확한 Skill revision을 OWS `skill-revision` 코드 리소스로 고정합니다. Automation은 패키지 경로와 entrypoint를 선택하며, 에이전트 단계는 봉인된 실행 capability 집합이 승인한 Skill만 받습니다.

첫 번째 경로는 외부 에이전트에 재사용 가능한 지침을 제공합니다. 두 번째 경로는 반복 가능한 Automation 실행에 불변 코드와 지원 파일을 제공합니다. 게시된 Skill은 조직 전체에 적용되므로, 승인된 Automation은 어떤 Space에서든 같은 Skill revision을 선택할 수 있습니다. Skill을 사용하는 Automation과 그 실행은 계속 해당 Space가 소유하며, Skill을 선택해도 그 경계는 바뀌지 않습니다.

## Skill 만들기 및 유지 관리

**organization menu** → **Skills** → **New Skill**을 여세요. **Skill** 탭에서 **Name**, **Slug**, 선택 사항인 **Description**, 그리고 **Markdown**으로 재사용 가능한 지침을 입력하세요. 지원 패키지 파일이 있으면 **Files** 탭을 사용한 다음 **Create Skill**을 선택하세요.

Slug는 소문자, 숫자, 하이픈을 사용하고 문자나 숫자로 시작하며, 사용자가 `/` 뒤에 입력하는 값입니다.

Skill을 만들거나 편집하면 draft가 생성됩니다. Skill 상세 페이지에서는 편집 내용이 자동 저장되며, **Publish Draft**를 선택해 draft를 검증하고 게시하세요. 검증에 실패하면 표시된 진단을 사용해 draft를 수정하고 다시 게시하세요.

**History**를 사용해 revision을 검사하거나, 대체된 revision을 복원하거나, 해당 작업이 가능한 경우 변경 가능한 draft를 폐기하세요. **Disable Skill**은 revision 이력을 삭제하지 않고 외부 에이전트 탐색과 Automation 확인에서 Skill을 제거하며, **Enable Skill**은 다시 사용할 수 있게 합니다.

## MCP로 Skill 만들기 또는 편집하기

패키지 우선 작성에는 연결된 외부 MCP 클라이언트를 사용하세요. 기존 Skill을 편집하기 전에 `skills.get`을 호출하세요. 새 패키지에는 `skills.create`를, 현재 활성 revision을 기반으로 한 revision에는 `skills.create_candidate`를 사용하세요.

작은 패키지는 inline으로 제공할 수 있습니다. 더 큰 패키지의 경우 `skills.create_package_upload_session`을 호출하고, 요청된 객체를 업로드한 다음, `skills.finalize_package_upload_session`으로 마무리하세요. 검증이 보류되었다면 `skills.publish_revision`을 호출하세요. 수락된 lifecycle 요청과 그 검증 또는 승격 결과는 `skills.get`로 폴링하세요.

Skill을 게시해도 Automation이 생성, 수정, 활성화되지는 않습니다. 필요한 경우 Automation MCP lifecycle을 명시적으로 사용하세요.

## Skill 템플릿에서 시작하기

**Skills** 페이지에는 **Skill Templates**가 포함되어 있습니다. 카탈로그를 검색하거나 필터링하고, 템플릿을 미리 본 다음 **Copy Skill**을 선택하세요. 복사본은 다른 Skill처럼 편집하고 게시할 수 있는 조직 Skill이 됩니다.

## Skill과 Automation

Skill은 재사용 가능한 작업을 수행하는 방법을 정의합니다. 그 작업이 언제 실행될지는 결정하지 않습니다.

작업을 수동으로, 일정에 따라, 또는 이벤트에 대한 응답으로 실행해야 할 때는 Automation을 사용하세요. Automation은 하나 이상의 Skill revision을 고정해 여러 실행에서 동일한 구현을 재사용할 수 있습니다.


## Related topics

- [MCP](/docs/ko/mcp-server.md)
- [Automations](/docs/ko/automations.md)
- [환영합니다](/docs/ko/agents/introduction.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.