AAS Core — Agentic Awesome Skills

Local, deterministic skill-stack composition for coding agents—from an explicit project profile to a reviewable plan before any target change.

Current release: V15.0.0. This release includes AAS Core under the Agent-First Preview claim for local search, inspection, recommendation, manifest validation, planning, and diagnosis. Apply and recovery remain experimental and outside the supported preview path.

Codex or Claude inspects your project using its own capabilities; AAS does not scan it. The agent sends the local, read-only AAS MCP an explicit project profile. AAS Core evaluates that profile and your policy against a verified local catalog, returns an explainable recommendation, and lets the agent propose aas-stack.json. The aas CLI validates that desired state and creates an immutable per-target plan before any skill changes are made.

Read the AAS Core preview guide →

Project
  -> inspected by Codex or Claude (not by AAS)
  -> explicit, allowlisted project profile
  -> AAS MCP (local stdio, read-only)
  -> deterministic AAS Core + verified local catalog
  -> recommendation with evidence, exclusions, coverage, and unknowns
  -> agent proposes aas-stack.json
  -> AAS CLI validate + immutable plan preview
  -> human review (optionally in Workbench)

The 1,967+ reusable SKILL.md playbooks, specialized plugins, bundles, workflows, and direct installers remain important. They are the content, curation, distribution, and compatibility layers around AAS Core—not competing primary products.

This is an independent community project. It is not affiliated with, sponsored by, endorsed by, or authorized by Google. Google, Antigravity, Gemini, and related product names are referenced only to describe compatibility and install targets. The GitHub repository is canonical; the hosted catalog and browser-local Workbench are companion discovery and review surfaces, not a hosted control plane.

AAS Core: Agent-First Preview

The agent composes. You control. AAS keeps the stack reproducible.

AAS Core gives the repository one product model:

• Discover and recommend through the agent. The local MCP exposes search_skills, get_skill, recommend_stack, inspect_stack, and diff_stack; it does not install skills, scan source files, call a remote model, or write to the project.
• Keep approved intent in aas-stack.json. The manifest pins catalog identity, targets, goals, policy, and exact skill IDs without storing repository source or model reasoning.
• Validate and preview through the CLI. aas stack validate checks the proposal, while aas stack plan produces an immutable, per-target plan without applying it.
• Review in Workbench. The hosted Workbench imports and reviews stack/plan JSON in browser memory; it does not access your filesystem or install anything.
• Retain every useful distribution path. Direct installs, plugins, bundles, workflows, and the full catalog remain available as payload and compatibility surfaces.

Read the AAS Core guide for the exact trust boundaries, current preview status, Codex/Claude setup model, and CLI lifecycle.

Why This Repo

• Agent-first, locally controlled: let Codex or Claude compose from structured catalog evidence without uploading your repository to AAS.
• Deterministic and inspectable: the same normalized profile, catalog, schema, and scorer produce the same canonical recommendation.
• Approval before writes: the durable artifacts are an approved stack and immutable plan, not an opaque one-shot install.
• Installable, not just inspirational: use the compatible legacy installer or plugin distributions when direct delivery is the right path.
• Built for major agent workflows: Claude Code, Cursor, Codex CLI, Autohand Code, Gemini CLI, Antigravity, Kiro, OpenCode, Copilot, and more.
• Broad coverage with real utility: 1,968+ skills across development, testing, security, infrastructure, product, and marketing.
• Inspect before installing: the hosted Skill Workbench reviews agent-produced stack manifests and immutable plans without browser-side installation.
• Focused delivery remains available: specialized plugins package proven sets for web, security, data, docs, DevOps, QA, OSS, or agent/MCP workflows.
• Useful whether you want breadth or curation: install the full catalog, choose a specialized plugin, start with bundles, or compare alternatives before installing.

Table of Contents

• AAS Core: Agent-First Preview
• Why This Repo
• Installation
• Recommended Specialized Plugins
• Choose Your Tool
• Quick FAQ
• Bundles & Workflows
• Browse 1,968+ Skills
• Troubleshooting
• Stable Skills Manifest v1
• Support the Project
• Contributing
• Community
• Credits & Sources
• Repo Contributors
• Star History
• License

Installation

For Codex and Claude, start with the AAS Core guide: configure the local MCP through the explicit preview flow, ask the agent for a recommendation, review the proposed aas-stack.json, then run CLI validation and planning. The MCP and validation are read-only. Planning writes only the requested plan artifact; it does not materialize skill payloads or AAS managed state in the target.

Use direct installation when your host does not yet have a native AAS Core adapter, when you already know the exact skill IDs, or when you deliberately prefer manual selection:

• Specialized plugins when the job has a clear domain.
• Full library install when you want every skill available in a local skills directory.
• Bundles and workflows when you want role-based recommendations or ordered execution playbooks.

Full library install

# Default: ~/.agents/skills (Antigravity 2.0 global). Use --path for other locations.
npx agentic-awesome-skills

# Antigravity CLI slash commands (agy): ~/.gemini/antigravity-cli/skills/<skill>/SKILL.md
npx agentic-awesome-skills --agy

The npm installer uses a shallow, release-pinned clone by default so first-run installs stay lighter than a full repository history checkout while matching the published npm package version. Use --tag main only when you intentionally want the current repository tip.

Focused single-skill install with GitHub CLI (preview)

GitHub CLI can preview and install one exact skill for Copilot and other supported hosts. Use an exact SKILL.md path in this large, mirrored repository so the selected source is unambiguous and discovery stays fast:

gh skill preview sickn33/agentic-awesome-skills skills/brainstorming/SKILL.md
gh skill install sickn33/agentic-awesome-skills skills/brainstorming/SKILL.md \
  --agent github-copilot --scope user --pin v14.2.0

gh skill support is currently a GitHub CLI preview and may change. Install a focused skill or plugin surface for the job; do not use --all unless you intentionally want every discovered canonical and mirrored skill.

Verify the install

test -d ~/.agents/skills && echo "Skills installed in ~/.agents/skills"

Run your first skill

Use @brainstorming to plan a SaaS MVP.

Prefer plugins for Claude Code or Codex?

• Use a specialized plugin when you want a focused marketplace-style distribution.
• Use the full-library plugin only when you want the widest plugin-safe catalog.
• Read Plugins for Claude Code and Codex for full-library plugin install vs speci