Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

aggrega skills

Memasang skill Aggrega ke asisten AI

Sinopsis

aggrega skills

Deskripsi

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.

Subperintah

PerintahDeskripsi
aggrega skills installMenulis skill Aggrega ke folder skill asisten AI
aggrega skills listMencantumkan skill yang disertakan biner ini dan asisten yang dapat dipasangi skill tersebut

Deskripsi 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.

Flag aggrega skills install

FlagDefaultDeskripsi
--agent[]Asisten yang akan dipasangi skill, berdasarkan pengidentifikasi (misalnya claude-code, codex, cursor, atau gemini-cli). Dapat diulang; bantuan mencantumkan setiap pengidentifikasi dan folder yang ditulis masing-masing. Wajib tanpa —global; dengan —global dan tanpa asisten yang diberikan, skill dipasang untuk asisten yang ditemukan di mesin ini.
--globalfalseMemasang ke folder skill per pengguna setiap asisten di direktori home Anda, yang dibacanya di setiap proyek, alih-alih ke folder skill proyek di root workspace Anda.

Deskripsi 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.

Apa yang dilakukannya

aggrega skills install menulis skill Aggrega ke folder skill setiap asisten AI yang Anda sebut dengan --agent, atau, dengan --global dan tanpa --agent, setiap asisten yang ditemukannya di mesin ini. Skill adalah folder yang berisi file SKILL.md dalam format terbuka Agent Skills: blok frontmatter singkat yang menyebut nama skill dan kapan skill digunakan, diikuti instruksi. Asisten yang membaca skill memuatnya ketika permintaan Anda cocok, sehingga ia tahu cara memasang Aggrega, cara terhubung ke aggrega mcp, cara memulai workspace, dan cara menjalankan siklus penulisan yang dijelaskan di Menulis file Aggrega.

Skill tidak membawa salinan skema atau kontrak entitas apa pun. Skill meminta asisten menanyakan setiap jawaban struktural kepada biner — melalui alat MCP jika server terhubung, atau melalui baris perintah aggrega jika tidak — dan membaca dokumentasi yang dipublikasikan untuk mengetahui arti berbagai hal. Skill tertanam dalam biner, sehingga salinan yang ditulisnya sesuai dengan versi yang Anda pasang.

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

Tempat skill ditempatkan

Tanpa --global, skill masuk ke folder skill proyek asisten di root workspace Anda, tempat asisten mencari skill proyek dan tempat Anda meng-commit-nya. Workspace adalah workspace yang ditemukan setiap perintah — yang disebut --workspace-root, atau yang ditemukan dari direktori tempat Anda menjalankan perintah, sehingga menjalankannya dari subfolder tetap memasang di root — dan direktori yang tidak ditandai workspace mana pun menjadi root-nya sendiri. Dengan --global, skill masuk ke folder skill per pengguna asisten di direktori home Anda, yang dibaca asisten di setiap proyek. Tabel dalam deskripsi di atas memberikan kedua folder untuk setiap asisten; masing-masing adalah folder yang disebut dokumentasi asisten itu sendiri, dan ~ mewakili direktori home Anda.

Beberapa asisten membaca folder bersama .agents/skills. Menyebut lebih dari satu di antaranya akan menulis skill di sana sekali dan menyebut semuanya dalam satu baris yang melaporkannya:

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

Asisten di mesin ini

Dengan --global dan tanpa --agent, perintah ini memasang skill untuk asisten yang ditemukannya di mesin ini. Sebuah asisten dianggap ditemukan bila folder konfigurasinya sendiri ada di direktori home Anda, atau perintahnya ada di PATH Anda; kolom found by pada tabel di deskripsi di atas menyebutkan keduanya untuk setiap asisten. Sebuah folder atau perintah hanya digunakan bila folder atau perintah itu hanya milik asisten tersebut, sehingga menemukannya tidak pernah mewakili asisten lain: folder bersama .agents/skills tidak menemukan siapa pun, dan .gemini, tempat Gemini CLI dan Antigravity sama-sama menyimpan file, tidak menemukan keduanya — Gemini CLI ditemukan melalui perintah gemini-nya, dan setiap produk Antigravity melalui foldernya sendiri di bawah .gemini. Asisten yang konfigurasinya berada di tempat lain di sistem Anda ditemukan melalui perintahnya, atau disebutkan dengan --agent.

Perintah ini mencetak setiap asisten yang ditemukannya dan apa yang menemukannya, lalu memasang:

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

Di terminal, perintah ini bertanya terlebih dahulu. Setelah baris-baris yang menyebutkan apa yang ditemukannya, perintah ini meminta Anda mengonfirmasi: tekan Enter untuk memasang bagi asisten-asisten tersebut, atau ketik pengidentifikasi asisten lain, dipisahkan dengan spasi atau koma, untuk menambahkannya. Bila tidak menemukan satu pun, perintah ini menanyakan pengidentifikasi sebagai gantinya, dan jawaban kosong tidak menulis apa pun. Bila input standar bukan terminal — skrip, asisten yang menjalankan perintah untuk Anda, atau alat milik asisten itu sendiri untuk menjalankannya — perintah ini tidak menanyakan apa pun dan memasang untuk asisten yang ditemukannya. Bila tidak menemukan satu pun dan tidak diberi satu pun, perintah ini tidak menulis apa pun, menyatakannya, dan keluar dengan kode bukan nol.

Menyebutkan --agent apa pun melewati pencarian: perintah ini memasang untuk asisten yang Anda sebutkan dan tidak untuk yang lain. Pemasangan proyek, tanpa --global, selalu menyebutkannya: pemasangan ini untuk asisten yang digunakan orang-orang di proyek tersebut, yang tidak dapat diketahui dari mesin ini.

Memasang lagi, dan apa yang ditolaknya

Setiap file yang ditulis perintah membawa satu baris komentar, tepat setelah frontmatter, yang menyatakan bahwa file berasal dari skill yang tertanam dalam biner aggrega dan bahwa memasang lagi akan menggantinya. Baris itulah cara perintah membedakan salinannya sendiri dari salinan Anda:

  • Salinan yang membawa baris itu diganti. Menjalankan perintah lagi setelah meng-upgrade Aggrega membawa skill ke versi baru, dan baris yang dicetaknya menyatakan Replaced alih-alih Installed.
  • File tanpa baris itu ditolak. SKILL.md yang sudah ada di tujuan dan tidak ditulis oleh perintah adalah milik Anda, sehingga perintah menyebut path-nya, tidak menulis apa pun di mana pun, dan keluar dengan kode bukan nol. Pindahkan file itu ke tempat lain atau hapus, lalu jalankan perintah lagi. Untuk mempertahankan perubahan Anda sendiri, simpan dalam skill dengan nama lain.
  • Folder yang dicapai melalui link yang mengarah ke luar workspace ditolak. Tanpa --global, setiap folder dan file yang akan ditulis perintah dibatasi pada workspace: jika folder skill asisten, atau folder di jalur menuju ke sana, adalah link yang mengarah ke luar workspace, perintah menyebut link tersebut dan ke mana arahnya, tidak menulis apa pun di mana pun, dan keluar dengan kode bukan nol — kondisi yang dijelaskan di A path the operation writes leads through a link out of the directory it must stay inside (Path yang ditulis operasi mengarah melalui link ke luar direktori tempat ia harus tetap berada). Penulisan melalui link yang tetap berada di dalam workspace tetap dilakukan.

Setiap tujuan diperiksa sebelum apa pun ditulis, sehingga penolakan untuk satu asisten juga membiarkan folder setiap asisten lain seperti semula. File di folder skill yang tidak ditulis oleh skill tidak disentuh.

Asisten yang tidak dikenalnya

--agent hanya menerima pengidentifikasi dalam tabel di atas, masing-masing adalah pengidentifikasi yang digunakan alat baris perintah skill terbuka untuk asisten yang sama. Pengidentifikasi lain ditolak dengan menyebut namanya, beserta daftar pengidentifikasi yang dikenalnya. Asisten yang tidak tercantum tetap dapat menggunakan Aggrega: hubungkan ke server MCP seperti yang dijelaskan di Menghubungkan server MCP, dan asisten itu menjangkau alat dan materi referensi yang sama yang ditunjuk skill.

Contoh

Pasang skill untuk Claude Code di proyek ini:

Terminal window
aggrega skills install --agent claude-code

Pasang untuk Gemini CLI dan Cursor di setiap proyek Anda:

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

Pasang di setiap proyek Anda untuk asisten di mesin ini:

Terminal window
aggrega skills install --global

Bawa salinan yang terpasang ke biner yang baru saja Anda upgrade:

Terminal window
aggrega skills install --agent claude-code

Mencantumkan apa yang dikenalnya

aggrega skills list mencetak skill yang tertanam dalam biner ini beserta deskripsinya, lalu setiap asisten yang dikenal aggrega skills install, beserta folder proyek dan folder per penggunanya. Perintah ini tidak menulis apa pun.

Terminal window
aggrega skills list