Agent skill

Update Aegis

A skill your agent uses 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.

MITAuto-check passed

Install Update Aegis

skills CLI

$ npx skills add GanyuanRan/Aegis --skill update-aegis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install GanyuanRan/Aegis update-aegis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/GanyuanRan/Aegis.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/update-aegis .claude/skills/update-aegis && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "update-aegis" agent skill from https://github.com/GanyuanRan/Aegis/tree/main/skills/update-aegis into .claude/skills/update-aegis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "update-aegis", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/GanyuanRan/Aegis/tree/main/skills/update-aegis

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add GanyuanRan/Aegis --skill update-aegis -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install GanyuanRan/Aegis update-aegis --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/GanyuanRan/Aegis.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/update-aegis .agents/skills/update-aegis && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "update-aegis" agent skill from https://github.com/GanyuanRan/Aegis/tree/main/skills/update-aegis into .agents/skills/update-aegis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "update-aegis", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add GanyuanRan/Aegis --skill update-aegis -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install GanyuanRan/Aegis update-aegis --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/GanyuanRan/Aegis.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/update-aegis .cursor/skills/update-aegis && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "update-aegis" agent skill from https://github.com/GanyuanRan/Aegis/tree/main/skills/update-aegis into .cursor/skills/update-aegis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "update-aegis", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/GanyuanRan/Aegis.git --path skills/update-aegis

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add GanyuanRan/Aegis --skill update-aegis -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install GanyuanRan/Aegis update-aegis --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/GanyuanRan/Aegis.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/update-aegis .gemini/skills/update-aegis && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "update-aegis" agent skill from https://github.com/GanyuanRan/Aegis/tree/main/skills/update-aegis into .gemini/skills/update-aegis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "update-aegis", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install GanyuanRan/Aegis update-aegis

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add GanyuanRan/Aegis --skill update-aegis -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/GanyuanRan/Aegis.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/update-aegis .github/skills/update-aegis && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "update-aegis" agent skill from https://github.com/GanyuanRan/Aegis/tree/main/skills/update-aegis into .github/skills/update-aegis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "update-aegis", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add GanyuanRan/Aegis --skill update-aegis -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install GanyuanRan/Aegis update-aegis --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/GanyuanRan/Aegis.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/update-aegis .opencode/skills/update-aegis && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "update-aegis" agent skill from https://github.com/GanyuanRan/Aegis/tree/main/skills/update-aegis into .opencode/skills/update-aegis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "update-aegis", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: update-aegis
GitHub stars: 1.3k
Used in: 1 other repo
Token cost: ~1.4k tokens
SKILL.md length: 552 words
Files: 1
Skills in repo: 21
Repo updated: Oct 9, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

A skill your agent uses 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.

The user says aegis:update
SKILL.md covers Default Semantics, Evidence First, Update Commands and Completion Evidence
Calls python
Upgrade an installed Aegis method-pack

What it does

Update Aegis is an agent skill from GanyuanRan/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.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Kimi. The repository describes itself as: Make AI coding agents architecture-aware: baseline-first, evidence-verified, drift-checked, and safe across long tasks. The licence is MIT.

When your agent uses it

The user says aegis:update
Upgrade an installed Aegis method-pack
Wants the latest Aegis version
Asks whether Aegis is current on this host

Example prompts

“/update-aegis”

Requirements

Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 110dbc1. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- python
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Update Aegis loads about 1.4k tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 552 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~47
When it runs · the whole SKILL.md, loaded when a task matches: ~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from GanyuanRan/Aegis at commit 110dbc1, republished under its MIT licence (© GanyuanRan). 552 words, ~1,433 tokens.

Download SKILL.mdSave it as .claude/skills/update-aegis/SKILL.md (or your agent's skills folder).

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:

bash

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:

bash

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

Copy-based host example:

bash

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:

bash

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:

text

/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:

bash

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

Kimi Code CLI Explicit Compatibility Installation example:

bash

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:

bash

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

Show full SKILL.md (234 more words)Show less

Update Commands

Current or explicitly selected host:

bash

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

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

bash

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

Preview without touching files:

bash

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:

bash

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.

Files

Just SKILL.md in skills/update-aegis of GanyuanRan/Aegis.

Open the folder on GitHubat commit 110dbc1

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in GanyuanRan/Aegis, which our catalogue first saw on October 7, 2026.

hashgraph-online/awesome-codex-pluginsplugins/GanyuanRan/Aegis/skills/update-aegis

Compare with similar skills

Update Aegis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Update Aegis compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Update Aegis this skillGanyuanRan/Aegis	1.3k	1 repos	~1.4k	Automated safety check: Pass	MIT	yesterday
CCS Task Delegationkaitranntt/ccs	2.9k	—	~1.8k	Automated safety check: Pass	MIT	10 days ago
Ccmanager Configkbwo/ccmanager	1.3k	—	~1.5k	Automated safety check: Pass	MIT	yesterday
Kimi WebbridgeMoonshotAI/kimi-code	7.8k	—	~3.6k	Automated safety check: Pass	MIT	today
Open Kimi Pptjinwyp/open-ppt-skill	161	2 repos	~5.1k	Automated safety check: Pass	MIT	2 mo ago
Helmor Bump Vendorsdohooo/helmor	1.3k	—	~2.1k	Automated safety check: Pass	Apache-2.0	1 mo ago

Similar skills

CCS Task Delegation
kaitranntt/ccs
Hands simple, deterministic tasks such as typo fixes, tests and small refactors to cheaper models through the ccs CLI, choosing a profile from your config.
2.9k GitHub stars~1.8k tokensUpdated 10 days ago
Agent WorkflowsAuto-check passed
Ccmanager Config
kbwo/ccmanager
Set up, review, or repair a CCManager config — .ccmanager.json at a git repository root, or the global ~/.config/ccmanager/config.json.
1.3k GitHub stars~1.5k tokensUpdated yesterday
DevelopmentAuto-check passed
Kimi Webbridge
MoonshotAI/kimi-code
Kimi Browser Extension（Kimi 浏览器扩展，原 Kimi WebBridge）lets AI control the user's real browser — navigate, click, type, read, screenshot, and interact with any website using the user's actual login…
7.8k GitHub stars~3.6k tokensUpdated today
DevelopmentAuto-check passed
Open Kimi Ppt
jinwyp/open-ppt-skill
Create, edit, replicate, read, and export presentations. An agent skill from jinwyp/open-ppt-skill.
161 GitHub starsUsed in 2 repos~5.1k tokens
Documents & OfficeAuto-check passed
Helmor Bump Vendors
dohooo/helmor
Bump or upgrade the pinned versions of Helmor's bundled agent CLIs, SDKs, and supporting binaries — Claude Code + claude-agent-sdk (lockstep), Codex, Cursor SDK, OpenCode, Kimi, Pi, and gh / glab /…
1.3k GitHub stars~2.1k tokensUpdated 1 mo ago
Agent WorkflowsAuto-check passed
Gen Changesets
MoonshotAI/kimi-code
A skill your agent uses when generating changesets in the kimi-code repository — deciding whether to write one, which package to list, the bump level, the wording, and the confirmation workflow.
7.8k GitHub stars~1.1k tokensUpdated today
DevelopmentAuto-check passed

More from GanyuanRan/Aegis

All 21 skills in this repo

Anti Entropy Governance
GanyuanRan/Aegis
A skill your agent uses when touching retiring old logic, collapsing duplicate owners, removing fallbacks, or schema/persistence/source-of-truth boundaries; identify opportunities automatically…
1.3k GitHub starsUsed in 1 repo~3.1k tokens
Auto-check passed
Executing Plans
GanyuanRan/Aegis
A skill your agent uses when executing a written implementation plan across sessions or with review checkpoints.
1.3k GitHub starsUsed in 1 repo~2.3k tokens
Auto-check passed
First Principles Review
GanyuanRan/Aegis
A skill your agent uses when asked for first-principles or Occam's-razor review, or when high-risk decisions involve competing constraints, fallback growth, duplicate owners, or architecture…
1.3k GitHub starsUsed in 1 repo~2.5k tokens
Auto-check passed
Goal Framing
GanyuanRan/Aegis
A skill your agent uses when the user explicitly sets an Aegis goal with /aegis-goal, Aegis goal:, or asks to define goal, success evidence, stop condition, or task boundaries before work.
1.3k GitHub starsUsed in 1 repo~1.2k tokens
Auto-check passed
Establishing Project Context
GanyuanRan/Aegis
A skill your agent uses when the user asks to establish shared project language, or project work exposes a conflicting, renamed, or deprecated domain term that needs active semantic modeling.
1.3k GitHub starsUsed in 1 repo~1.5k tokens
Auto-check: warnings
Recording Architecture Decisions
GanyuanRan/Aegis
A skill your agent uses when the user asks to create, write, update, amend, supersede, or evaluate an ADR, architecture decision record, durable architecture decision, decision log, or baseline sync…
1.3k GitHub starsUsed in 1 repo~1.5k tokens
Auto-check passed

Works with

Kimi

Questions about Update Aegis

What does Update Aegis do?

A skill your agent uses 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 is an agent skill from GanyuanRan/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.

When should I use Update Aegis?

Update Aegis fits situations like: the user says aegis:update; upgrade an installed Aegis method-pack; wants the latest Aegis version; asks whether Aegis is current on this host.

How do I install Update Aegis in Claude Code?

Run `npx skills add GanyuanRan/Aegis --skill update-aegis -a claude-code`. Or copy the skill folder (skills/update-aegis in GanyuanRan/Aegis) into .claude/skills/update-aegis in your project. Claude Code loads it when a task matches its description.

How do I install Update Aegis in Codex?

Run `npx skills add GanyuanRan/Aegis --skill update-aegis -a codex`. Or copy the skill folder (skills/update-aegis in GanyuanRan/Aegis) into .agents/skills/update-aegis in your project. Codex loads it when a task matches its description.

Can I use Update Aegis in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add GanyuanRan/Aegis --skill update-aegis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/update-aegis, .gemini/skills/update-aegis, .github/skills/update-aegis and .opencode/skills/update-aegis in your project.

What does Update Aegis need to run?

Going by SKILL.md and its folder, Update Aegis needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Update Aegis access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Update Aegis safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Update Aegis use?

Update Aegis is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Update Aegis use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Update Aegis?

Skills that share tags, products or a category with Update Aegis: CCS Task Delegation (kaitranntt/ccs, 2.9k stars), Ccmanager Config (kbwo/ccmanager, 1.3k stars), Kimi Webbridge (MoonshotAI/kimi-code, 7.8k stars) and Open Kimi Ppt (jinwyp/open-ppt-skill, 161 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Update Aegis?

GanyuanRan (a GitHub user) maintains it in GanyuanRan/Aegis, which has 1,335 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 9, 2026.

Source: GanyuanRan/Aegis on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Update Aegis

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Update Aegis

Default Semantics

Evidence First

Update Commands

Completion Evidence

Files

Used in 1 other repository

Compare with similar skills

Similar skills

More from GanyuanRan/Aegis

Related

Questions about Update Aegis