콘텐츠로 이동
AggregaAggrega
언어 선택: 한국어
이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

aggrega skills

AI 어시스턴트에 Aggrega 스킬 설치

개요

aggrega skills

설명

Install the skill that teaches an AI assistant to install and use Aggrega.
A skill is a folder holding a SKILL.md file in the open Agent Skills format,
which many assistants read from a skill folder of their own. The Aggrega skill
tells an assistant how to install Aggrega, how to connect it to the aggrega MCP
server, how to start a workspace, and how to run the authoring loop — scaffold,
validate, build. It carries no copy of any schema: it sends the assistant to
this binary for every structural question and to the published documentation
for every conceptual one.
The skill is built into this binary, so the copy it installs matches the
version you have.

하위 명령

명령설명
aggrega skills installAggrega 스킬을 AI 어시스턴트의 스킬 폴더에 씁니다
aggrega skills list이 바이너리가 제공하는 스킬과 스킬을 설치할 수 있는 어시스턴트를 나열합니다

aggrega skills install 설명

Write the Aggrega skill into the skill folder of each assistant named with
--agent, so the assistant knows how to install and use Aggrega.
By default the skill goes into the assistant's project skill folder at the root
of your workspace — the one found from the directory you run the command in, or
named with --workspace-root; a directory no workspace marks is its own root —
which is where a project's own skills are committed. With --global it goes
into the assistant's per-user skill folder in your home directory instead,
where the assistant reads it in every project.
Every folder and file a project installation writes is held to the workspace:
a skill folder reached through a link leading out of it is refused, and
nothing is written.
--agent may be given more than once. Where several of the named assistants read
the same folder, the skill is written there once.
With --global and no --agent, the skill is installed for the assistants found
on this machine: each one whose configuration folder is in your home directory
or whose command is on your PATH, as the table below names them. The command
prints each assistant it found and what found it. At a terminal it then asks
before writing: press Enter to install for those, or type the identifiers of
other assistants to add them. Where standard input is not a terminal it
installs for the assistants found without asking. Where it finds none and is
given none, it writes nothing and says so. A project installation is for the
assistants a project's people use rather than those on one machine, so it
always names them with --agent.
The skill is written as a folder named aggrega holding SKILL.md, and every file
written carries a comment line saying where it comes from. Running the command
again replaces a copy carrying that line, which is how a newer aggrega brings
the skill up to its own version. A file at the target that does not carry it
was not written by this command, so the command refuses, names the file and
writes nothing; move it aside or remove it, then run the command again. Every
target is checked before anything is written, so a refusal leaves every folder
as it was.
The assistants it installs for, the folders each one reads, and what finds each
on this machine — its configuration folder in your home directory, or its
command on your PATH:
--agent assistant project folder per-user folder found by
amp Amp .agents/skills ~/.config/amp/skills ~/.config/amp, amp
antigravity Antigravity .agents/skills ~/.gemini/config/skills ~/.gemini/antigravity, antigravity
antigravity-cli Antigravity CLI .agents/skills ~/.gemini/antigravity-cli/skills ~/.gemini/antigravity-cli
claude-code Claude Code .claude/skills ~/.claude/skills ~/.claude, claude
cline Cline .cline/skills ~/.cline/skills ~/.cline, cline
codex Codex .agents/skills ~/.agents/skills ~/.codex, codex
cursor Cursor .cursor/skills ~/.cursor/skills ~/.cursor, cursor
gemini-cli Gemini CLI .gemini/skills ~/.gemini/skills gemini
github-copilot GitHub Copilot .github/skills ~/.copilot/skills ~/.copilot, copilot
goose Goose .agents/skills ~/.agents/skills ~/.config/goose, goose
opencode OpenCode .opencode/skills ~/.config/opencode/skills ~/.config/opencode, opencode
windsurf Windsurf .devin/skills ~/.codeium/windsurf/skills ~/.codeium/windsurf, windsurf
zed Zed .agents/skills ~/.agents/skills ~/.config/zed, zed
An assistant that is not listed is refused by name. It can still use Aggrega
through its MCP server: connect it to "aggrega mcp" as
https://aggrega.ai/docs/install/ describes.

aggrega skills install 플래그

플래그기본값설명
--agent[]스킬을 설치할 어시스턴트의 식별자입니다(예: claude-code, codex, cursor, gemini-cli). 반복해서 지정할 수 있으며, 도움말에 모든 식별자와 각각이 쓰는 폴더가 나열됩니다. —global 없이는 필수이며, —global을 지정하고 아무것도 지정하지 않으면 이 머신에서 찾은 어시스턴트에 스킬이 설치됩니다.
--globalfalse워크스페이스 루트의 프로젝트 스킬 폴더 대신, 홈 디렉터리에 있는 각 어시스턴트의 사용자별 스킬 폴더에 설치합니다. 어시스턴트는 이 폴더를 모든 프로젝트에서 읽습니다.

aggrega skills list 설명

List the skills built into this binary, and the assistants "aggrega skills
install" can write them for, with the project folder and the per-user folder
each assistant reads skills from. It writes nothing.

동작

aggrega skills install은 --agent로 지정한 각 AI 어시스턴트의 스킬 폴더에, 또는 --global을 지정하고 --agent를 지정하지 않으면 이 머신에서 찾은 각 어시스턴트의 스킬 폴더에 Aggrega 스킬을 씁니다. 스킬은 개방형 Agent Skills 형식의 SKILL.md 파일을 담은 폴더입니다. 이 파일은 스킬의 이름과 언제 사용할지를 밝히는 짧은 프런트매터 블록과 그 뒤의 지침으로 이루어집니다. 스킬을 읽는 어시스턴트는 요청이 일치할 때 이를 불러오므로, Aggrega 설치 방법, aggrega mcp에 연결하는 방법, 워크스페이스를 시작하는 방법, 그리고 Aggrega 파일 작성에서 설명하는 작성 루프를 실행하는 방법을 알게 됩니다.

스킬은 스키마나 엔터티 계약의 사본을 전혀 담고 있지 않습니다. 어시스턴트에게 모든 구조적 답은 바이너리에 물어보도록 하고(서버가 연결된 경우 MCP 도구, 그렇지 않으면 aggrega 명령줄), 각 항목의 의미는 게시된 문서를 읽도록 안내합니다. 스킬은 바이너리에 내장되어 있으므로, 쓰는 사본은 설치한 버전과 일치합니다.

Terminal window
aggrega skills install --agent claude-code
Installed the aggrega skill for Claude Code at /home/you/project/.claude/skills/aggrega

스킬이 설치되는 위치

--global이 없으면 스킬은 워크스페이스 루트에 있는 어시스턴트의 프로젝트 스킬 폴더에 들어갑니다. 어시스턴트는 이곳에서 프로젝트의 스킬을 찾고, 스킬은 이곳에서 커밋됩니다. 워크스페이스는 모든 명령이 찾는 것과 같습니다. 즉 --workspace-root가 지정하는 워크스페이스이거나 명령을 실행한 디렉터리에서 찾은 워크스페이스이므로, 하위 폴더에서 실행해도 루트에 설치됩니다. 어떤 워크스페이스도 표시하지 않은 디렉터리는 그 자체가 루트입니다. --global을 사용하면 홈 디렉터리에 있는 어시스턴트의 사용자별 스킬 폴더에 들어가며, 어시스턴트는 이 폴더를 모든 프로젝트에서 읽습니다. 위 설명의 표에는 모든 어시스턴트에 대해 두 폴더가 모두 나와 있습니다. 각 폴더는 해당 어시스턴트 자체 문서가 지정하는 폴더이며, ~는 홈 디렉터리를 나타냅니다.

여러 어시스턴트가 공유 .agents/skills 폴더를 읽습니다. 그중 둘 이상을 지정하면 스킬은 그곳에 한 번만 쓰이고, 이를 보고하는 한 줄에 그 어시스턴트들이 모두 명시됩니다:

Terminal window
aggrega skills install --agent codex --agent zed --global
Installed the aggrega skill for Codex and Zed at /home/you/.agents/skills/aggrega

이 머신의 어시스턴트

--global을 지정하고 --agent를 지정하지 않으면, 명령은 이 머신에서 찾은 어시스턴트에 스킬을 설치합니다. 어시스턴트 자체의 구성 폴더가 홈 디렉터리에 있거나 그 명령이 PATH에 있으면 어시스턴트를 찾은 것으로 봅니다. 위 설명에 있는 표의 found by 열에 모든 어시스턴트에 대해 두 가지가 모두 나와 있습니다. 폴더나 명령은 그 어시스턴트에만 속하는 경우에만 사용되므로, 그것을 찾았다고 해서 다른 어시스턴트를 찾은 것으로 간주되지는 않습니다. 공유 .agents/skills 폴더로는 어떤 어시스턴트도 찾지 않으며, Gemini CLI와 Antigravity가 모두 파일을 두는 .gemini로는 둘 중 어느 것도 찾지 않습니다. Gemini CLI는 gemini 명령으로 찾고, 각 Antigravity 제품은 .gemini 아래에 있는 자체 폴더로 찾습니다. 구성이 시스템의 다른 곳에 있는 어시스턴트는 그 명령으로 찾거나 --agent로 지정합니다.

명령은 찾은 각 어시스턴트와 무엇으로 찾았는지를 출력한 다음 설치합니다:

Terminal window
aggrega skills install --global
Found Claude Code (claude-code), from the folder /home/you/.claude
Found Codex (codex), from the command /usr/local/bin/codex
Installed the aggrega skill for Claude Code at /home/you/.claude/skills/aggrega
Installed the aggrega skill for Codex at /home/you/.agents/skills/aggrega

터미널에서는 먼저 묻습니다. 찾은 것을 나열하는 줄 다음에 확인을 요청합니다. Enter를 누르면 그 어시스턴트들에 설치하고, 다른 어시스턴트의 식별자를 공백이나 쉼표로 구분해 입력하면 그것들을 추가합니다. 아무것도 찾지 못한 경우에는 대신 식별자를 묻고, 빈 응답이면 아무것도 쓰지 않습니다. 표준 입력이 터미널이 아닌 경우 — 스크립트, 사용자를 대신해 명령을 실행하는 어시스턴트, 또는 이를 위한 어시스턴트 자체의 도구 — 아무것도 묻지 않고 찾은 어시스턴트에 설치합니다. 아무것도 찾지 못하고 아무것도 지정되지 않으면 아무것도 쓰지 않고, 그 사실을 알린 뒤 0이 아닌 코드로 종료합니다.

--agent를 하나라도 지정하면 검색을 건너뜁니다. 명령은 지정한 어시스턴트에만 설치하고 다른 어시스턴트에는 설치하지 않습니다. --global 없는 프로젝트 설치에서는 항상 어시스턴트를 지정합니다. 프로젝트 구성원이 사용하는 어시스턴트를 위한 것이며, 이 머신은 그것을 알려 주지 않기 때문입니다.

다시 설치하기와 거부되는 경우

명령이 쓰는 모든 파일에는 프런트매터 바로 다음에 주석 한 줄이 있으며, 이 파일이 aggrega 바이너리에 내장된 스킬에서 왔다는 것과 다시 설치하면 교체된다는 것을 알립니다. 명령은 이 줄로 자신의 사본과 사용자의 사본을 구별합니다:

  • 이 줄이 있는 사본은 교체됩니다. Aggrega를 업그레이드한 뒤 명령을 다시 실행하면 스킬이 새 버전으로 올라가며, 출력되는 줄에는 Installed가 아니라 Replaced라고 표시됩니다.
  • 이 줄이 없는 파일은 거부됩니다. 대상에 이미 있으면서 명령이 쓰지 않은 SKILL.md는 사용자의 것이므로, 명령은 그 경로를 명시하고 어디에도 아무것도 쓰지 않으며 0이 아닌 코드로 종료합니다. 파일을 다른 곳으로 옮기거나 제거한 뒤 명령을 다시 실행하십시오. 직접 변경한 내용을 유지하려면 다른 이름의 스킬에 보관하십시오.
  • 워크스페이스 밖으로 이어지는 링크를 통해 도달하는 폴더는 거부됩니다. --global이 없으면 명령이 쓸 모든 폴더와 파일은 워크스페이스에 묶입니다. 어시스턴트의 스킬 폴더나 그곳으로 가는 경로의 폴더가 워크스페이스 밖으로 이어지는 링크이면, 명령은 그 링크와 링크가 향하는 곳을 명시하고 어디에도 아무것도 쓰지 않으며 0이 아닌 코드로 종료합니다. 이는 A path the operation writes leads through a link out of the directory it must stay inside (작업이 쓰는 경로가 링크를 통해 머물러야 하는 디렉터리 밖으로 이어짐)에서 설명하는 조건입니다. 워크스페이스 안에 머무는 링크는 그 링크를 통해 쓰입니다.

무엇이든 쓰기 전에 모든 대상을 확인하므로, 한 어시스턴트에 대해 거부되면 다른 모든 어시스턴트의 폴더도 그대로 남습니다. 스킬 폴더 안에서 스킬이 쓰지 않는 파일은 건드리지 않습니다.

알 수 없는 어시스턴트

--agent는 위 표에 있는 식별자만 받으며, 각 식별자는 개방형 스킬 명령줄 도구가 같은 어시스턴트에 사용하는 식별자입니다. 그 밖의 식별자는 이름을 명시하여 거부되며, 알려진 식별자 목록이 함께 표시됩니다. 목록에 없는 어시스턴트도 Aggrega를 사용할 수 있습니다. MCP 서버 연결에서 설명하는 대로 MCP 서버에 연결하면, 스킬이 가리키는 것과 같은 도구와 참조 자료에 접근할 수 있습니다.

예시

이 프로젝트에서 Claude Code용 스킬을 설치합니다:

Terminal window
aggrega skills install --agent claude-code

모든 프로젝트에서 Gemini CLI와 Cursor용으로 설치합니다:

Terminal window
aggrega skills install --agent gemini-cli --agent cursor --global

이 머신의 어시스턴트를 위해 모든 프로젝트에 설치합니다:

Terminal window
aggrega skills install --global

설치된 사본을 방금 업그레이드한 바이너리에 맞춰 올립니다:

Terminal window
aggrega skills install --agent claude-code

알고 있는 항목 나열하기

aggrega skills list는 이 바이너리에 내장된 스킬을 설명과 함께 출력한 다음, aggrega skills install이 아는 모든 어시스턴트를 프로젝트 폴더 및 사용자별 폴더와 함께 출력합니다. 아무것도 쓰지 않습니다.

Terminal window
aggrega skills list