Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/aws-samples/sample-well-architected-skills-and-steering/llms.txt

Use this file to discover all available pages before exploring further.

Antigravity reads always-on rules from .agents/rules/*.md and discovers skill playbooks from .agents/skills/*/SKILL.md. Installing both layers gives Antigravity persistent Well-Architected awareness across every session plus 11 structured assessment workflows available on demand.

​
What gets installed

.agents/rules/well-architected.md

An always-on rule file (with alwaysApply: true in its frontmatter) that applies all six Well-Architected pillars, design principles, and trade-off guidance to every Antigravity conversation in the project.

.agents/skills/ directory

Eleven skill subdirectories, each containing only a SKILL.md — the lightweight core playbook. Reference directories are not included to keep the install small.
Only SKILL.md is copied into .agents/skills/ — not the full reference subdirectories that accompany each skill in the source repository. This keeps the install lightweight. If you need the full reference material (for example, the 57 per-question Best Practice files for wa-review), copy the relevant references/ directories manually from the source repo.

​
Installation

1

Clone or download the source repo

If you haven’t already, clone the sample repository to a local path you can reference:
git clone https://github.com/aws-samples/sample-well-architected-skills-and-steering.git
2

Copy files into your project

Run the commands below from the root of your project directory, substituting path/to/this-repo with the actual clone location.
mkdir -p .agents/rules .agents/skills
cp -r path/to/this-repo/adapters/antigravity/rules/* .agents/rules/

for skill_dir in path/to/this-repo/skills/*/; do
  skill_name=$(basename "$skill_dir")
  mkdir -p ".agents/skills/$skill_name"
  cp "$skill_dir/SKILL.md" ".agents/skills/$skill_name/SKILL.md"
done
3

Verify the layout

Your project should now contain:
.agents/
  rules/
    well-architected.md
  skills/
    wa-review/SKILL.md
    security-assessment/SKILL.md
    reliability-improvement-plan/SKILL.md
    cost-optimization-review/SKILL.md
    performance-efficiency/SKILL.md
    sustainability-optimization/SKILL.md
    operational-excellence/SKILL.md
    migration-readiness/SKILL.md
    architecture-decision-record/SKILL.md
    wa-builder/SKILL.md
    wa-guardrails/SKILL.md

​
Install via script

If you prefer the one-command approach from a local clone, the install script handles all directory creation and file copying automatically: 
./install.sh ~/my-project --tool antigravity

​
Usage

With .agents/rules/well-architected.md present, Antigravity applies Well-Architected guidance automatically. Invoke a specific skill by describing your needs: 
Run a Well-Architected review of this architecture.
The well-architected.md rule file has alwaysApply: true set in its frontmatter, so WA principles are active for every Antigravity session without any explicit invocation.
Because the rule is always active, Antigravity will proactively surface Well-Architected considerations even when you haven’t explicitly asked for a review. Ask for a “quick review” first to identify the highest-risk pillars before requesting a full deep-dive.

​
Available skills

SkillWhat it does
wa-reviewFull 6-pillar review with prioritized findings report
security-assessmentDeep-dive into IAM, detection, data protection, incident response
reliability-improvement-planFind SPOFs, assess recovery, produce remediation plan
cost-optimization-reviewIdentify waste, right-sizing, pricing model improvements
performance-efficiencyResource selection, scaling, caching, optimization
sustainability-optimizationUtilization, architecture efficiency, carbon reduction
operational-excellenceCI/CD, observability, incident management, operational maturity
migration-readiness7 Rs assessment, dependency analysis, migration plan
architecture-decision-recordADR with WA pillar impact analysis
wa-builderLearn WA for your workload and generate visual artifacts
wa-guardrailsGenerate preventive controls (Config rules, SCPs, CI checks)

Build docs developers (and LLMs) love

Get started for freeTalk to us