Updated 2d ago
by GanyuanRan
Aegis
Make AI coding agents architecture-aware: baseline-first, evidence-verified, drift-checked, and safe across long tasks.
1.3k GitHub stars (1,349)
+63 in 20 days
| Period | New stars |
|---|---|
| Sep 27 | 0 |
| Sep 28 | +2 |
| Sep 29 | +15 |
| Sep 30 | +4 |
| Oct 1 | +1 |
| Oct 2 | +4 |
| Oct 3 | 0 |
| Oct 4 | +3 |
| Oct 5 | +4 |
| Oct 6 | +3 |
| Oct 7 | +1 |
| Oct 8 | +4 |
| Oct 9 | +1 |
| Oct 10 | +6 |
| Oct 11 | +1 |
| Oct 12 | +3 |
| Oct 13 | +5 |
| Oct 14 | +3 |
| Oct 15 | +1 |
| Oct 16 | +2 |
- 22 skills (22 skills found in its SKILL.md files)
- 77 forks (77 forks)
- 2d ago last update (Last updated 2d ago)
Install
Skills CLI
npx skills add GanyuanRan/Aegis
Asks which skills and agents to install. Just one: npx skills add GanyuanRan/Aegis --skill anti-entropy-governance — add -g for every project.
Claude Code
git clone https://github.com/GanyuanRan/Aegiscp -r "Aegis/skills/anti-entropy-governance" ~/.claude/skills/
Copies the anti-entropy-governance skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add GanyuanRan/Aegis
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
anti-entropy-governance
Use when touching retiring old logic, collapsing duplicate owners, removing fallbacks, or schema/persistence/source-of-truth boundaries; identify opportunities automatically; destructive execution requires explicit confirmation.
skills/anti-entropy-governance/SKILL.md on GitHub (opens in a new tab) -
brainstorming
Use when defining ambiguous or high-complexity new features, product behavior, UI/component design, architecture choices, contract changes, or when grilling/pressure-testing a plan or design. Routine small requests stay on the fast path.
skills/brainstorming/SKILL.md on GitHub (opens in a new tab) -
communicating-concisely
Use when the user asks for caveman mode, fewer tokens, brief responses, compressed communication, or otherwise explicitly requests a much shorter answer.
skills/communicating-concisely/SKILL.md on GitHub (opens in a new tab) -
dispatching-parallel-agents
Use when facing 2+ independent tasks without a written plan, with no conflicting shared mutable state or sequential dependencies, where parallel delegation beats inline cost; otherwise inline. Planned tasks use subagent-driven-development.
skills/dispatching-parallel-agents/SKILL.md on GitHub (opens in a new tab) -
establishing-project-context
Use 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. Routine small tasks stay on the fast path.
skills/establishing-project-context/SKILL.md on GitHub (opens in a new tab) -
executing-plans
Use when executing a written implementation plan across sessions or with review checkpoints. Small or single-slice plans stay inline. For same-session independent tasks, use subagent-driven-development instead.
skills/executing-plans/SKILL.md on GitHub (opens in a new tab) -
finishing-a-development-branch
Use when verified work needs integration or cleanup of an existing task-created branch/worktree, or the user explicitly requests merge, PR, or branch lifecycle handling.
skills/finishing-a-development-branch/SKILL.md on GitHub (opens in a new tab) -
first-principles-review
Use when asked for first-principles or Occam's-razor review, or when high-risk decisions involve competing constraints, fallback growth, duplicate owners, or architecture direction risk. Ordinary bug fixes stay on the fast path.
skills/first-principles-review/SKILL.md on GitHub (opens in a new tab) -
goal-framing
Use 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.
skills/goal-framing/SKILL.md on GitHub (opens in a new tab) -
long-task-continuation
Use when a task is multi-step, may span context resets or sessions, uses subagents, or risks losing state before completion.
skills/long-task-continuation/SKILL.md on GitHub (opens in a new tab) -
receiving-code-review
Use when receiving code review feedback before implementing suggestions, especially when feedback is unclear, risky, disputed, or technically questionable.
skills/receiving-code-review/SKILL.md on GitHub (opens in a new tab) -
recording-architecture-decisions
Use 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 after architecture-changing work.
skills/recording-architecture-decisions/SKILL.md on GitHub (opens in a new tab) -
requesting-code-review
Use when requesting independent code review, after implementation slices, before merging high-risk work, or when verification exposes evidence, baseline, architecture, compatibility, or retirement uncertainty.
skills/requesting-code-review/SKILL.md on GitHub (opens in a new tab) -
subagent-driven-development
Use when executing a written implementation plan with independent tasks in the current session where delegation beats inline coordination cost; otherwise inline. Ad-hoc 2+ tasks without a plan use dispatching-parallel-agents.
skills/subagent-driven-development/SKILL.md on GitHub (opens in a new tab) -
systematic-debugging
Use when encountering a bug, test failure, or unexpected behavior, before proposing fixes
skills/systematic-debugging/SKILL.md on GitHub (opens in a new tab) -
test-driven-development
Use when the user explicitly requests strict or test-first TDD, or when the current conversation already contains an explicit `TDD Route: strict` decision from another Aegis workflow.
skills/test-driven-development/SKILL.md on GitHub (opens in a new tab) -
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.
skills/update-aegis/SKILL.md on GitHub (opens in a new tab) -
using-aegis
Use when starting a turn or checking Aegis skill routing.
skills/using-aegis/SKILL.md on GitHub (opens in a new tab) -
using-git-worktrees
Use when a coding task needs a concurrent checkout, unrelated dirty state blocks safe branch switching, or the user or repository explicitly requires a worktree.
skills/using-git-worktrees/SKILL.md on GitHub (opens in a new tab) -
verification-before-completion
Use when about to claim work is complete, fixed, passing, verified, release-ready, or ready to commit, merge, publish, or hand off.
skills/verification-before-completion/SKILL.md on GitHub (opens in a new tab) -
writing-plans
Use when you have an approved spec or written requirements for a multi-step task that needs a durable plan document before touching code. Small, single-owner, or fast-path tasks do not need this skill.
skills/writing-plans/SKILL.md on GitHub (opens in a new tab) -
writing-skills
Use when creating new skills, editing existing skills, or verifying skills work before deployment
skills/writing-skills/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.