스킬 설치

외부 스킬 패키지로 Minara를 확장하세요. 채팅에서 바로 요청할 수 있습니다.

Minara는 대규모 내장 스킬 카탈로그를 제공하지만, Git 저장소에서 외부 스킬을 추가하여 기능을 확장할 수 있습니다. 외부 스킬은 일반 마크다운 파일(SKILL.md)과 소형 매니페스트로 구성되며, 로컬 설치 환경에 벤더링됩니다. 이를 통해 Agent는 내장 스킬과 동일한 방식으로 외부 스킬을 활성화할 수 있습니다.

가장 쉬운 방법: Minara에게 요청하기

스킬을 설치하는 권장 방법은 채팅에서 Minara에게 직접 말하는 것입니다. Agent는 스킬 설치 의도를 파악하고, 적절한 명령을 실행합니다. REPL을 벗어나지 않아도 라이선스 검사와 스킬 등록이 완료됩니다.

예시 프롬프트:

install this skill: https://github.com/acme/minara-skill-tax-reports

add the coinglass skill from github

vendor https://github.com/some-org/skills-monorepo, the one under
skills/invoice-parser

I want the polymarket trading skill — find and install it

upgrade my coingecko skill to latest

remove the tax_reports skill, I don't need it anymore

Minara는 설치를 실행하기 전에 확인을 요청합니다. 외부 코드 설치는 Tier 3 작업에 해당합니다. 이후 감지된 라이선스를 표시하고, 스킬이 등록되었음을 알립니다. 다음 세션부터 새 스킬을 활성화할 수 있습니다.

이 방식이 권장되는 이유는 다음과 같습니다.

URL 파싱, 서브패스 감지, 라이선스 판단을 Agent가 대신 처리합니다.
라이선스 경고(UNKNOWN, ⚠️ NONE, ⚠️ PROPRIETARY)를 암호 같은 접두사가 아닌 문맥에 맞는 설명으로 안내합니다.
"이제 ETH로 시도해봐"와 같은 후속 요청도 같은 대화에서 자연스럽게 이어집니다.

CLI 방식 (직접 실행하려는 경우)

스크립팅이나 비대화형 환경에서는 동일한 작업을 minara skills 명령 계열로 수행할 수 있습니다.

minara skills list                          # 설치된 외부 스킬 목록 조회
minara skills add <git-url> [options]       # 새 스킬 설치
minara skills upgrade [<id>]                # 최신 버전으로 업데이트
minara skills remove <id>                   # 제거

이 명령들은 모두 사용자별 스킬 디렉터리(~/.minara/skills/)에서 동작합니다. 저장소 소스에는 영향을 주지 않으며, 설치된 스킬은 npm install 이후에도 유지되고 메인 코드베이스에 커밋되지 않습니다.

스킬 추가 (CLI)

가장 간단한 형태는 Git URL을 사용하는 것입니다.

minara skills add https://github.com/acme/minara-skill-tax-reports

Minara는 저장소를 클론하고, SKILL.md 매니페스트를 감지한 후 라이선스를 검사하고, 스킬을 등록하여 요약 정보를 출력합니다.

✓ Installed: acme.tax_reports
  License: MIT (OK)
  Tools:   0
  Prompt:  ~420 tokens

스킬은 다음 minara chat 세션부터 사용 가능합니다. 실행 중인 REPL을 재시작할 필요는 없지만, 이미 실행 중인 세션에서는 새 스킬이 표시되지 않습니다.

멀티 스킬 저장소

하나의 Git 저장소에 여러 스킬이 서로 다른 서브디렉터리에 포함될 수 있습니다. --subpath로 원하는 스킬을 지정하세요.

minara skills add https://github.com/acme/skills-monorepo \
  --subpath skills/tax-reports

minara skills add https://github.com/acme/skills-monorepo \
  --subpath skills/invoice-parser \
  --id acme.invoices

ID 재정의

설치된 스킬은 저장소 경로에서 파생된 기본 ID를 가집니다. --id로 이를 재정의할 수 있습니다.

minara skills add https://github.com/acme/foo --id acme.custom_name

두 스킬의 ID가 충돌할 경우나 활성화 이름을 더 짧게 만들고 싶을 때 사용하세요.

특정 ref 고정

minara skills add https://github.com/acme/foo --ref v1.2.0
minara skills add https://github.com/acme/foo --ref main
minara skills add https://github.com/acme/foo --ref 3f1e2d4

태그, 브랜치, 커밋 SHA 등 git checkout이 허용하는 모든 값을 사용할 수 있습니다.

라이선스 감지 (중요)

모든 스킬은 LICENSE 파일 유무를 스캔합니다. 설치 프로그램은 다음 중 하나를 출력합니다.

결과	의미
`MIT` / `Apache-2.0` / 기타 SPDX	허용적 오픈소스, 사용 가능
`UNKNOWN`	LICENSE 파일은 존재하지만 알려진 SPDX 식별자와 일치하지 않음
`⚠️ NONE`	LICENSE 파일 없음, 주의 요망
`⚠️ PROPRIETARY`	재배포를 금지하는 조항 감지됨, 설치가 차단됨

기준: UNKNOWN 또는 ⚠️ NONE이 표시되면, 프로덕션에서 스킬을 사용하기 전에 저장소를 열어 LICENSE를 직접 확인하세요. 라이선스가 없거나 모호한 경우, 해당 코드를 사용할 권한이 없는 것입니다.

과거 사례: Anthropic의 공식 docx/pdf/pptx 스킬은 "서비스 외부에서 사본 보관 금지" 조항이 포함된 라이선스를 사용합니다. 따라서 이 스킬들은 벤더링할 수 없습니다. Minara는 대신 MIT 라이선스 대안(docx / pdf-lib / pptxgenjs)을 사용합니다.

설치된 스킬 확인

minara skills list

acme.tax_reports           v0.3.1  MIT           ~420 tok
community.chart_generator  main    Apache-2.0    ~680 tok
local.my_workflow          —       UNKNOWN       ~210 tok

열 구성: ID · 고정된 ref · 감지된 라이선스 · 프롬프트 크기.

대용량 스킬(1500 토큰 초과)은 별도로 표시됩니다. activation: "always"로 설정된 경우 매 턴마다 시스템 프롬프트가 비대해지므로, 설치 유지 전에 매니페스트를 검토하세요.

업그레이드

minara skills upgrade                          # 모든 스킬 업그레이드
minara skills upgrade acme.tax_reports         # 특정 스킬 업그레이드

Minara는 고정된 ref(ref가 없으면 HEAD)에서 최신 버전을 가져오고, 라이선스를 재검증하며, 프롬프트 크기 및 도구 노출 변경 사항을 보고합니다.

↑ acme.tax_reports: v0.3.1 → v0.3.2
  Prompt: 420 → 445 tokens (+5.9%)
  Tools:  unchanged

업그레이드 시 라이선스가 변경되는 경우(예: MIT에서 독점 라이선스로), 업그레이드가 거부됩니다. 수동으로 재설치하기 전까지 기존 버전이 유지됩니다.

제거

minara skills remove acme.tax_reports

~/.minara/skills/에서 클론을 삭제하고 스킬을 등록 해제합니다. 다음 REPL 세션부터 해당 스킬은 표시되지 않습니다.

스킬 출처

Minara 레지스트리: Minara 팀이 관리하는 큐레이션 스킬
GitHub의 Cocoon-AI: 공개 스킬 라이브러리로 지속 성장 중(Cocoon-AI organization)
자체 Git 호스트: Minara 프로세스가 URL에 접근 가능한 모든 자체 호스팅 Git 서버에서 팀 내부 스킬을 운용할 수 있습니다.

외부 스킬은 내장 스킬과 동일한 DomainSkill 계약을 사용합니다. 스킬을 설치하는 것이 아니라 직접 작성하려면 기여 가이드 → 스킬 추가를 참고하세요.

문제 해결

"License: ⚠️ NONE" 경고, 걱정해야 할까요? 저장소 성격에 따라 다릅니다. 개인 실험용 저장소라면 큰 문제가 없을 수 있습니다. 사용자에게 배포하는 환경이라면 저자에게 LICENSE 파일 추가를 요청하세요.

"Skill failed to register" 대개 SKILL.md 프론트매터가 잘못된 경우입니다. minara skills list를 실행하면 파싱 오류와 함께 실패한 스킬이 표시됩니다. 이를 참고하여 업스트림 저장소에 이슈를 등록하세요.

"Tool collision: name already registered" 설치된 두 스킬이 동일한 도구 이름을 선언한 경우입니다. --id로 하나의 이름을 변경하거나 중복 스킬을 제거하세요.

"Not visible after adding" requires_env가 설정된 외부 스킬은 해당 환경 변수가 설정되어야 표시됩니다. 스킬 매니페스트에서 필요한 환경 변수를 확인하고 .env에 추가하세요.