Skills for Real Engineers. Straight from my .agents directory.
first-principles-review
Agent skill fromGanyuanRan/Aegis
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.
How to install first-principles-review
npx skills add GanyuanRan/Aegis# or add only this skill to Claude Code: copy the folder
skills/first-principles-review/
# into
~/.claude/skills/first-principles-review/ (all projects)
.claude/skills/first-principles-review/ (one project)
1# First Principles Review23## Purpose45Use this as a lightweight decision review before another Aegis workflow makes a6directional choice. It is a compositional skill, not a standalone workflow.78Do not replace `brainstorming`, `systematic-debugging`, `writing-plans`,9`requesting-code-review`, or `verification-before-completion`. Use it to clean10the decision surface those skills will act on.1112When this review materially changes the direction, surface `Aegis Visibility`13in natural prose: name the first principle, dropped assumption, smallest14sufficient path, or owner / retirement falsifier that changed the decision.15Keep it advisory and task-specific; do not turn the lens into approval16authority or a generic skill trace.1718## Use When1920- The user asks for first principles, first-principles thinking, or Occam's21 razor.22- A design, plan, or fix has multiple plausible paths and unclear selection23 criteria.24- The task has ambiguous goals, competing constraints, or product/architecture25 direction risk.26- Debugging is drifting into repeated fixes, fallback growth, duplicate owners,27 consumer-side patches, or "just add another branch" reasoning.28- A review finds that the implementation may be locally correct but directionally29 wrong.3031## Do Not Use3233- Simple Q&A, status checks, tiny wording/config edits, or clearly bounded34 single-owner changes.35- Mechanical execution of an approved plan unless a new directional conflict36 appears.37…
Excerpt shown under the repository's MIT license.
More skills in Aegis
Similar skill repositories
An agentic skills framework & software development methodology that works.
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Public repository for Agent Skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
An AI skill that provides design intelligence for building professional UI/UX across multiple platforms.
