SkillAgentSearch skills...

update-aegis

Use when the user says `aegis:update`, asks to update or upgrade an installed Aegis method-pack, wants the latest Aegis version, or asks whether Aegis is current on this host.

Install / Use

npx skills add GanyuanRan/Aegis --skill update-aegis

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

87/100

Supported Platforms

Universal

Tags

Our assessment of update-aegis

update-aegis scores 87/100 on our quality scale, 2186th of 4,698 Development & Engineering skills we index (top 47%).

Its SKILL.md is 5.6 KB long, split into 5 sections with 12 code examples: a solid amount of guidance for an agent.

With 1,273 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
26/30
Structure
18/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so update-aegis is actively maintained.
  • Our last check on 2026-11-02 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

update-aegis compared with similar skills

All 4 of these similar skills score higher than update-aegis; compare them before choosing.

SkillScoreStarsUpdatedFormat
update-aegis (this skill)by GanyuanRan871.3k53d agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md
lobehubby lobehub10085.6ktodayMCP Server

Frequently asked questions

How do I install update-aegis?
Run npx skills add GanyuanRan/Aegis --skill update-aegis. The install tabs above show the steps for each supported agent.
Which AI agents does update-aegis work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is update-aegis safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is update-aegis still maintained?
The repository was last updated about 2 months ago, so update-aegis is actively maintained.

name: update-aegis description: "Use when the user says aegis:update, asks to update or upgrade an installed Aegis method-pack, wants the latest Aegis version, or asks whether Aegis is current on this host."

Update Aegis

Update the installed Aegis Method Pack for the current AI coding host.

This skill is host maintenance. Do not edit the target project just because the user asked to update Aegis.

Default Semantics

  • aegis:update updates the current host's registered Aegis installation.
  • Updating every registered host requires an explicit --all request.
  • If more than one host is registered and the current host cannot be identified, ask one concrete question before updating.
  • Do not update a development checkout when the installed method-pack root is a separate path.
  • Do not perform background automatic updates. The local registry may record updateMode, but this skill only performs explicit user-triggered updates.

Evidence First

From the installed method-pack root, inspect the host-scoped registry:

python scripts/aegis-update.py status --json

If the registry is missing, register the current host before updating. Use the host's install guide and actual discovery path rather than guessing.

If ~/.config/aegis/config.toml already declares method_pack_root, prefer that canonical root when registering additional hosts. Host-specific discovery paths, copied skill directories, plugin caches, or adapter payloads should be treated as generated / host-managed views into the same Aegis body, not as separate editable checkouts.

Codex example:

python scripts/aegis-update.py register \
  --host codex \
  --sync-mode junction \
  --discovery-root ~/.agents/skills/aegis \
  --reload-hint "restart Codex"

Copy-based host example:

python scripts/aegis-update.py register \
  --host codebuddy \
  --sync-mode copy-skills \
  --discovery-root ~/.codebuddy/skills \
  --reload-hint "restart CodeBuddy"

Prefixed direct-child host example:

python scripts/aegis-update.py register \
  --host copilot \
  --sync-mode junction \
  --discovery-shape direct-child \
  --discovery-root <target-repo>/.github/skills \
  --discovery-name-prefix aegis- \
  --reload-hint "restart Copilot session or reopen the repository"

Kimi Code CLI automatic installations are plugin-managed. Do not use the Aegis updater against Kimi's managed plugin copy. In Kimi, run the native update or reinstall flow, verify the selected managed plugin, then reload:

/plugins install https://github.com/GanyuanRan/Aegis
/plugins info aegis
/reload

If Kimi requires confirmation or removal before replacing the managed copy, follow its exact plugin-manager prompt. Then locate the managed root from /plugins info aegis and run:

cd <aegis-method-pack-root>
python scripts/aegis-doctor.py --json --host-profile kimi-code-auto

Kimi Code CLI Explicit Compatibility Installation example:

python scripts/aegis-update.py register \
  --host kimi-code \
  --sync-mode junction \
  --reload-hint "restart Kimi Code CLI"

When --discovery-root is omitted for kimi, kimi-code, or kimi-code-cli, the updater uses $KIMI_CODE_HOME/skills or, when KIMI_CODE_HOME is unset, ~/.kimi-code/skills. Use this updater path only when the Aegis Kimi plugin is disabled or uninstalled and the user has selected explicit compatibility mode.

Plugin-managed hosts can be registered, but the updater reports that the host plugin manager owns the update path:

python scripts/aegis-update.py register \
  --host opencode \
  --sync-mode plugin-managed \
  --reload-hint "restart OpenCode"

Update Commands

Current or explicitly selected host:

python scripts/aegis-update.py update --host <host> --json

All registered hosts, only when the user explicitly asks for all-host update:

python scripts/aegis-update.py update --all --json

Preview without touching files:

python scripts/aegis-update.py update --host <host> --dry-run --json

If the installed checkout has local changes, do not overwrite them. Either ask the user how to proceed or, with explicit permission, preserve them with:

python scripts/aegis-update.py update --host <host> --stash --json

Completion Evidence

Treat the update as complete only when the updater reports the selected host and the post-update doctor verification succeeds. For link-based discovery roots (junction, symlink, or repo-only), the updater passes discoveryRoot through to aegis-doctor.py --discovery-root; when a registered direct-child view declares discoveryNamePrefix, the updater also passes --discovery-name-prefix. For copy-based hosts, it verifies that copied Aegis skill directories exist after the copy step, then runs doctor against the method-pack root.

When multiple registered hosts share the same methodPackRoot, the updater now reuses a single method-pack checkout update and then refreshes each host's exposure or verification path separately.

Report:

  • selected host / installation id
  • previous and final commit when available
  • whether the install was updated or already current
  • sync mode used
  • doctor verification result
  • restart or reload hint

If the updater skips a plugin-managed host, state that the host plugin manager owns the update path and give the reload or reinstall hint.

For Kimi automatic installations, completion also requires /plugins info aegis, /reload or /new, the kimi-code-auto doctor profile, and the host-native automatic-entry checks from docs/README.kimi-code.md. File discovery or a generic doctor result alone is not sufficient.

Related Skills

View on GitHub
GitHub Stars1.3k
CategoryDevelopment
Updated1mo ago
Forks64

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions