당신은 이미 수십 개의 Agent Skills를 가지고 있습니다. 단지 찾을 수 없을 뿐입니다.

I’m happy to translate the article for you, but I’ll need the full text of the post (the paragraphs, headings, lists, etc.) in order to do the translation. Could you please paste the content you’d like translated? I’ll keep the source line and all formatting exactly as you requested.

akm 로 성장하는 스킬 컬렉션 관리하기

지난 글에서 문제를 설명했습니다: 에이전트의 스킬 컬렉션이 관리 속도보다 빨리 늘어나고 있다는 점. 스킬이 여러 디렉터리에 흩어져 있고, 검색도 없으며, 공유도 안 되고, 체계가 흐트러지고 있습니다.

Agentikit 은 단일 CLI인 akm 로 이 문제를 해결합니다. akm 은 에이전트에게 검색 가능하고 인덱싱된 자산 보관소를 제공합니다.

실제 도전 과제

대부분의 여러분은 처음부터 시작하는 것이 아닙니다. 이미 여러 도구에 자산이 흩어져 있습니다:

같은 주에 두세 개의 플랫폼을 동시에 사용할 수도 있고, 서로의 자산을 볼 수 없습니다.

akm 은 자산이 어디서 왔는지는 신경 쓰지 않습니다. 어떤 디렉터리를 지정하면 그 안의 모든 것을 인덱싱합니다. 다섯 개의 디렉터리를 지정하면 모두에 대한 의미 기반 검색 을 한 번의 명령으로 수행할 수 있습니다 – 하나의 커맨드, 모든 플랫폼, 모든 모델.

빠른 시작

CLI 설치

설치 후, akm이 PATH에 추가됩니다. 새 버전이 출시되면 akm upgrade를 실행하여 제자리에서 업데이트하세요.

Stash 초기화

akm init

• ~/akm 디렉터리를 만들고 하위 폴더 scripts/, skills/, commands/, agents/, knowledge/, memories/ 를 생성합니다.
• 다른 위치를 사용하려면 akm init을 실행하기 전에 AKM_STASH_DIR을 설정하세요.

기존 자산 디렉터리 추가

파일을 옮기는 대신, 이미 사용 중인 디렉터리를 간단히 등록하세요.

# Register Claude Code skills
akm stash add ~/.claude/skills

# Register OpenCode assets in a project
akm stash add ./my-project/.opencode/skills

# Register Cursor rules
akm stash add ./.cursor/rules

소스 이름 지정 (선택 사항)

akm stash add ~/.claude/skills --name "claude-skills"
akm stash add ./team-shared --name "team"

소스 목록 / 제거

# Show everything you’ve added
akm stash list

# Remove by path or name
akm stash remove ~/.claude/skills
# or
akm stash remove claude-skills

원격 키트 설치

GitHub, npm, 또는 로컬 git 저장소에서 자산을 가져올 수 있습니다. 키트는 자동으로 캐시되고 인덱싱됩니다.

# A team repo full of shared skills
akm add github:your-org/team-agent-toolkit

# An npm package
akm add @scope/deploy-skills

# A local git directory
akm add ./path/to/my-opencode-skills

검색 인덱스 구축

# 최초 전체 빌드
akm index

# 이후 증분 빌드 (변경된 디렉터리만)
akm index

벡터 기반 의미 검색 활성화 (선택 사항)

# 임베딩 모델 가져오기 (예: Ollama)
ollama pull nomic-embed-text

# 임베딩 엔드포인트 설정
akm config set embedding '{"endpoint":"http://localhost:11434/v1/embeddings","model":"nomic-embed-text","dimension":384}'

# 임베딩을 사용해 인덱스 재구축
akm index --full

임베딩을 설정하지 않으면 akm은 강력한 키워드 매칭으로 대체됩니다.

자산 검색

# Search across all registered sources
akm search "docker container management"

이 명령은 akm에 바로 전달할 수 있는 참조를 반환합니다:

# Show the full content of a skill
akm show skill:docker-homelab

• Skills → 전체 SKILL.md 내용.
• Scripts → 실행 가능한 명령.
• Commands → 자리표시자가 포함된 마크다운 템플릿.
• Knowledge → 목차가 있는 탐색 가능한 섹션.

커뮤니티 레지스트리도 검색하기

akm search "code review" --source both

찾은 킷 설치하기

akm add github:someone/great-kit

킷에서 단일 자산 복제하기

akm clone "github:someone/great-kit//skill:code-review" --dest ./.claude

적절한 하위 디렉터리(skills/, scripts/ 등)가 자동으로 생성됩니다.

모두 합치기

아래와 같은 스니펫을 AGENTS.md, CLAUDE.md 또는 시스템 프롬프트에 추가하면 에이전트가 스태시를 직접 활용할 수 있습니다:

에이전트 스태시 액세스

akm CLI를 사용하면 모든 자산을 검색할 수 있습니다:

• Search: akm search ""
• Show: akm show :
• Run a script: akm run
• Add a kit: akm add

이제 모든 스킬, 스크립트, 명령, 에이전트, 지식 및 메모리를 위한 **단일 진실의 원천**이 확보되었습니다—원래 어디에 있었든 상관없습니다. 즐거운 빌딩 되세요!

## Resources & Capabilities  

스크립트, 스킬, 명령, 에이전트, 지식 및 메모리를 검색할 수 있는 라이브러리에 **`akm`** CLI를 통해 접근할 수 있습니다.  
`akm -h`를 실행하면 옵션 전체 목록을 확인할 수 있습니다.

## 문제  

- 각 에이전트 플랫폼(Claude Code, OpenCode, Cursor 등)은 자산을 자체 형식과 위치에 저장합니다.  
- 특정 스크립트나 규칙이 필요할 때 여러 디렉터리나 저장소를 뒤져야 합니다.  
- 이러한 파편화는 컨텍스트를 깔끔하게 유지하고 도구 간에 자산을 재사용하기 어렵게 만듭니다.

## **`akm`**가 해결하는 방법  

`akm`은 **all** 자산 위치를 한 곳에 인덱싱하여, 셸 명령을 실행할 수 있는 모든 모델이 단일 쿼리로 이를 검색할 수 있게 합니다.

- **Progressive disclosure** – 에이전트는 실제로 필요한 파일만 로드합니다.  
- **Relevance ranking** – 결과는 쿼리와의 일치 정도에 따라 정렬됩니다.  
- **Platform‑agnostic** – Claude Code 스킬은 Claude Code 스킬 그대로 유지되고, OpenCode 스크립트는 OpenCode 스크립트 그대로 유지됩니다; `akm`은 단지 이를 검색 가능하게 만들 뿐입니다.

## 예시 설정  

다음 디렉터리에 자산이 있다고 가정합니다:

| 플랫폼 | 경로 | 예시 자산 |
|------------|--------------------------|----------------|
| Claude Code| `~/.claude/skills/`      | PDF 생성, CMYK 변환, 인쇄 레이아웃 QA |
| OpenCode   | `.opencode/skills/`      | Azure 배포 스크립트, LiteLLM 관리자 |
| Shared team repo | `git@github.com:your-org/team-agent-toolkit.git` | Dockerfile, CI/CD 파이프라인, 코드 리뷰 자산 |
| Cursor     | `.cursor/rules/`         | 코딩 규칙, 아키텍처 패턴 |

### 1. `akm` 설치

```bash
curl -fsSL https://raw.githubusercontent.com/itlackey/agentikit/main/install.sh | bash

2. 인덱스 초기화

akm init

3. 자산 위치(스태시) 추가

akm stash add ~/.claude/skills
akm stash add .opencode/skills
akm stash add .cursor/rules
akm add github:your-org/team-agent-toolkit   # 원격 저장소

4. 인덱스 구축

akm index

5. 필요한 것을 검색

akm search "deploy container to azure"

결과: akm은 OpenCode 디렉터리에서 Azure 배포 스크립트를, 팀 저장소에서 Docker 스킬을, 그리고 Cursor 규칙에서 관련 지식 문서를 반환합니다—모두 관련성에 따라 순위가 매겨집니다. 에이전트는 선택된 파일만 로드하고 작업을 진행합니다.

Benefits at a Glance

빠른 참고

저장소:

흩어져 있는 에이전트 자산으로 한번 시도해 보고, 문제가 발생하면 알려 주세요!