How do I install the Using Aegis skill?

Run npx skillmds@latest add ganyuanran/using-aegis in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Using Aegis safe to use?

SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Using Aegis?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Using Aegis free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Using Aegis?

GanyuanRan (@ganyuanran) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Using Aegis by ganyuanran — Agent Skill

Name: Using Aegis
Rating: 4.2 (5 reviews)
Author: GanyuanRan

File contents

Skip for subagents.

Hot Path

User/project instructions outrank Aegis.
Active codebase question/"what next": check README/ADR/rules/baseline, else bounded index-first scan. Non-trivial owners passively use relevant CONTEXT-MAP.md/CONTEXT.md; compose establishing-project-context only for semantic delta/conflict. Create baselines only with evidence.
Direct grilling or plan/design pressure-tests (grill me, grill this plan, 审问我, 盘问我, 拷问我) route to brainstorming; literal/explanatory uses do not.
/aegis-goal or Aegis goal: loads goal-framing before routing.
Bug, failure, regression, or unexpected behavior routes to systematic-debugging; quick bug lane owns Change Necessity before source edits.
Classify before implementation/start/resume/compaction. Low: intent, baseline, verification. Medium/high: baseline read-set + plan (session-internal by default; docs only when the work needs durable cross-session direction or approval - Doc Necessity Gate). TDD: off=no auto route/load; auto=strict/light/skipped; explicit request applies. Spec Brief or Design Spec only for ambiguous/contract/cross-module medium/high work. Shared/core/contract/cross-module never low without evidence. Source edits/new paths: owner workflow surfaces Change Necessity.
Before the first repo write, the coordinator records TaskStartSnapshot. Complexity, TDD, planning, or subagents alone do not justify branch/worktree creation.
Non-tiny loaded skill: at first substantive user-visible stage say why Aegis is shaping work/risk; do not wait for the user to ask. structured trace only for audit/debug/release/long-task review/asked; Trace Digest does not route. Tiny stays implicit.
ArchitectureReviewRequired: yes for medium/high architecture/contract/ cross-module/owner/source-of-truth/fallback/adapter/baseline; carry to verification.
Workspace support is lazy; use configured Aegis workspace support only when records needed. Fast Q&A/status/tiny edits write no files. Doc Necessity Gate: docs only for durable/irreversible, cross-session, approval-gated, or authority-required change surfaces; covered surfaces update the owner doc, never a sibling; mechanical changes write no docs (commit message + code comments as the record).
Load smallest needed skill/reference.
Tool/log/memory/search outputs are evidence candidates, not prompt payloads; summary first, large input index->window->excerpt.
No history/sessions/transcripts/large logs by default; bound requested evidence by scope/time/lines.
Unclear host tool-name mapping: read smallest relevant reference.

Contract: Route: fast-path; Aegis Reason Note.

---name: using-aegisdescription: Routes requests to Aegis skills based on intent, loading relevant skills for debugging, planning, and goal framing while keeping fast-path responses lightweight.---<SUBAGENT-STOP>Skip for subagents.</SUBAGENT-STOP><EXPLICIT-MODE-GATE>If activation mode is explicit and this request did not explicitly invoke Aegis or a named skill, stay on the fast path; do not route to any Aegis skill. Explicit invocation proceeds normally.</EXPLICIT-MODE-GATE><EXTREMELY-IMPORTANT>You have Aegis. Load explicit/relevant Aegis skill before response/action;otherwise proceed normally.</EXTREMELY-IMPORTANT>## Hot Path1. User/project instructions outrank Aegis.2. Active codebase question/"what next": check README/ADR/rules/baseline, else bounded index-first scan. Non-trivial owners passively use relevant `CONTEXT-MAP.md`/`CONTEXT.md`; compose `establishing-project-context` only for semantic delta/conflict. Create baselines only with evidence.3. Direct grilling or plan/design pressure-tests (`grill me`, `grill this plan`, `审问我`, `盘问我`, `拷问我`) route to `brainstorming`; literal/explanatory uses do not.4. `/aegis-goal` or `Aegis goal:` loads `goal-framing` before routing.5. Bug, failure, regression, or unexpected behavior routes to `systematic-debugging`; quick bug lane owns Change Necessity before source edits.6. Classify before implementation/start/resume/compaction. Low: intent, baseline, verification. Medium/high: baseline read-set + plan (session-internal by default; docs only when the work needs durable cross-session direction or approval - Doc Necessity Gate). TDD: off=no auto route/load; auto=strict/light/skipped; explicit request applies. Spec Brief or Design Spec only for ambiguous/contract/cross-module medium/high work. Shared/core/contract/cross-module never low without evidence. Source edits/new paths: owner workflow surfaces Change Necessity.7. Before the first repo write, the coordinator records `TaskStartSnapshot`. Complexity, TDD, planning, or subagents alone do not justify branch/worktree creation.8. Non-tiny loaded skill: at first substantive user-visible stage say why Aegis is shaping work/risk; do not wait for the user to ask. structured trace only for audit/debug/release/long-task review/asked; `Trace Digest` does not route. Tiny stays implicit.9. ArchitectureReviewRequired: yes for medium/high architecture/contract/ cross-module/owner/source-of-truth/fallback/adapter/baseline; carry to verification.10. Workspace support is lazy; use configured Aegis workspace support only when records needed. Fast Q&A/status/tiny edits write no files. **Doc Necessity Gate:** docs only for durable/irreversible, cross-session, approval-gated, or authority-required change surfaces; covered surfaces update the owner doc, never a sibling; mechanical changes write no docs (commit message + code comments as the record).11. Load smallest needed skill/reference.12. Tool/log/memory/search outputs are evidence candidates, not prompt payloads; summary first, large input index->window->excerpt.13. No history/sessions/transcripts/large logs by default; bound requested evidence by scope/time/lines.14. Unclear host tool-name mapping: read smallest relevant reference.Contract: `Route: fast-path`; `Aegis Reason Note`.

Frequently asked questions

Using Aegis