AAS Core — Agentic Awesome Skills

Find reusable instructions for your project, inspect their complete files, and keep an exact skill set you can review and reuse.

Current release: V17.2.0. This release includes AAS Core for complete local catalog search, agent-owned selection, manifest validation, planning, and diagnosis. Apply and recovery remain experimental and outside the supported preview path.

Codex or Claude inspects your project and chooses exact skills from the complete local AAS catalog. AAS Core does not rank or recommend them: its read-only compose_stack tool validates the agent-owned selection in memory, and a client or the aas CLI can persist it as aas-stack.json and produce an immutable plan before any target change.

Read the AAS Core preview guide →

This README tracks main. Changes under Unreleased, including complete bundle inspection, Workbench evidence import and sparse installer retrieval, require a subsequent release; the linked versioned guide describes the published package.

Project
  -> inspected by Codex or Claude (not by AAS)
  -> agent searches and reads the complete local catalog
  -> AAS MCP (local stdio, read-only)
  -> Codex or Claude chooses exact skill IDs
  -> compose_stack validates the selection in memory (read-only)
  -> client or AAS CLI persists aas-stack.json and optional evidence
  -> AAS CLI validate + immutable plan preview
  -> human review (optionally in Workbench)

The 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.

Support the Project

We’re looking for sponsors to support Agentic Awesome Skills. If you or your company would like to support the project, become a sponsor.

♥ Sponsor AAS →

You can also support AAS on Buy Me a Coffee.

Security tooling support: Snyk.

AAS Core: Agent-First Preview

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

AAS Core gives the repository one product model:

• Let the agent choose. The local MCP offers search_skills, get_skill, list_skill_files, read_skill_file, compose_stack, inspect_stack, and diff_stack, plus read-only export_selection_evidence and inspect_selection_evidence; Core does not rank, recommend, exclude, or hide skills. Bundle files are verified and read as inert text.
• Guide capability coverage. MCP session instructions require the agent to evaluate the full project surface—from architecture, domain behavior, data and integrations through testing, security, UX, deployment, and maintenance—then search each applicable capability, compare multiple candidates, cover it with a non-redundant skill or report a catalog gap, and avoid stopping at a minimal shortlist. Core records and validates the resulting selection, but it does not certify semantic completeness.
• Keep the chosen stack and evidence reviewable. A client or the CLI can persist aas-stack.json and the separate aas-selection-evidence.json sidecar in an artifact-dir; the manifest preserves exact agent-selected IDs, while evidence records factual process trace and the agent-declared capability ledger.
• 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.

[!IMPORTANT]

Structural and identity validity does not certify semantic fit, compatibility, setup correctness, operational safety, or safety to apply.

| Surface | Current status | | --- | --- | | Published package | Current npm release; AAS Core status is agent-first-preview | | Catalog search and inspection | Supported preview; local and read-only | | Agent-owned composition | Supported preview; Core validates IDs and structure, not semantic suitability; manifests have a technical maximum of 128 skills | | Stack validation and plan preview | Supported preview; no target skill changes | | Workbench | Browser-local review of stack and plan artifacts | | Selection evidence | Exported and inspected through MCP/CLI contracts; not yet reviewed in Workbench | | Apply and recovery | Experimental, explicit opt-in, outside the supported safety claim | | Semantic suitability certification | Not provided |

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: Codex or Claude inspects the project and chooses from the complete local catalog without uploading your repository to AAS.
• Complete and inspectable: every catalog skill is searchable, readable, and available for agent selection; Core does not certify suitability, compatibility, or operational safety, and metadata is informational rather than an eligibility gate.
• 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: 2,121+ 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 curated 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.

Why not just search the skills directory?

Direct file search can find candidate prose, but it leaves the result in the conversation. AAS Core adds verified catalog identity, explicit target binding, durable desired state, optional selection evidence, deterministic validation, immutable planning, and dedicated review surfaces. Its value is not choosing better than the coding agent; it is turning the agent's choice into reproducible, inspectable state.

Table of Contents

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

Installation

For Codex and Claude, start with the AAS Core guide: configure the local MCP, ask the agent to inspect the project and choose exact IDs from the full catalog, 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.

From selection to use

On unreleased main, aas stack install-preview --manifest --destination prepares a direct-installer dry run from the agent-selected IDs. It does not execute installation or choose skills; destination names must satisfy the installer's filename restrictions. See the manifest handoff.

1. Describe the project outcome to Codex or Claude with the local AAS MCP configured. 2. Have the agent compare candidates and read the selected instructions and support files. Preserve the exact IDs in aas-stack.json and review their prerequisites. 3. Validate the manifest and review a CLI plan when you need an artifact-based check. Workbench can help inspect the artifacts. 4. For actual use, preview the supported direct installer with those same IDs, an exact release and the intended host directory. Review its own changes, then repeat without --dry-run when installation is authorized. Invoke the skill in a real task and keep the resulting check or artifact for reuse.

For example, after reviewing brainstorming and systematic-debugging for a Codex project, run from that project directory:

npm exec --yes --ignore-scripts [email protected] -- \
  agentic-awesome-skills --release 16.8.0 --path .agents/skills \
  --skills brainstorming,systematic-debugging --dry-run

Replace the example IDs with the reviewed selection. The direct installer has its own preview and ownership format; it does not consume or apply a Core plan. Core apply/recovery remain experimental. Worked cases show observed inputs and outputs without claiming guaranteed model performance.

Direct skill install

# Antigravity: preview an exact, agent-selected set before writing.
npx agentic-awesome-skills --antigravity --skills brainstorming,systematic-debugging --dry-run
Antigravity CLI slash commands (agy): ~/.gemini/antigravity-cli/skills//SKILL.md
npx agentic-awesome-skills --agy

On main, the npm installer uses a shallow partial clone and checks out the canonical skills/ tree after verifying the cloned commit against the immutable gitHead recorded for that exact npm package version. Git 2.25+ is required. Plugin mirrors, documentation and app assets are excluded from that temporary checkout; every canonical skill and support file remains available. See the measured distribution comparison. If the GitHub tag moved or npm identity metadata is unavailable, installation stops before copying content. Use --tag main only when you intentionally accept a mutable, explicitly unverified repository ref.

Antigravity watches ~/.agents/skills and may load enough installed instructions to exhaust its context, slow startup, trigger truncation errors, or enter a crash loop. For that target, the installer stops before cloning or writing unless you provide --skills, a metadata filter, or the explicit --all override. The bare npx agentic-awesome-skills command uses the same protected Antigravity target.

The recommended flow is to ask Codex or Claude with the read-only AAS Core MCP configured to inspect the project, search the complete catalog, and choose exact skill IDs. The agent selects the IDs; AAS MCP validates them without installing; the agent or user then previews the direct installation with the command above and repeats it without --dry-run after review.

Other direct-install targets retain the legacy-compatible full-catalog behavior when no selectors are supplied. The CLI prints the catalog's risk summary first: a full install includes critical and authorized-use-only offensive instructions. Installation copies files; it does not execute their commands, but an agent may act on an installed skill later. Prefer an exact reviewed set:

npx agentic-awesome-skills audit --skills brainstorming,backend-dev-guidelines
npx agentic-awesome-skills --skills brainstorming,backend-dev-guidelines --dry-run

If you deliberately accept the context and crash-loop risk, the complete Antigravity catalog remains available through explicit consent:

npx agentic-awesome-skills --antigravity --all

The audit reads the selected skill directories without executing them and reports command, network, credential, filesystem, privileged, destructive, symlink, and binary signals. It is a review aid, not a safety certificate. See Security, trust, and antivirus alerts.

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, Codex, or another compatible client?

• 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 compatible agent clients for host-specific installs, portable Agent Plugins bundles, and direct skills installs.

Recommended Specialized Plugins

Do not install everything first if you already know the work. Start with the focused plugin for your job, then add more only when the task expands.

All specialized plugins are generated as Claude Code and Codex plugin bundles. Bundles with flat, cross-host-safe skill layouts also receive a standard Agent Plugins 1.0 root manifest. For Antigravity, use the same SKILL.md content through the installer or supported skills paths.

| Plugin | Skills | Best for | | --- | ---: | --- | | AAS Web App Builder | 10 | Frontend and full-stack developers shipping modern web apps. | | AAS Product Design Studio | 10 | Product UI, brand, portfolio, accessibility, and richer visual work. | | AAS Security Engineer | 10 | Authorized security testing, audit, and hardening. | | AAS Secure App Builder | 9 | Developers who want security embedded while building features. | | AAS Documents & Presentations | 9 | Office files, document conversion, decks, and slide workflows. | | AAS Data Analytics | 10 | Product analytics, SQL, dashboards, and experiments. | | AAS Agent & MCP Builder | 10 | Agentic apps, MCP tools, RAG systems, and evaluation loops. | | AAS QA & Test Automation | 10 | Test suites, browser automation, and QA stabilization. | | AAS DevOps & Cloud | 10 | Infrastructure, deployments, and operational workflows. | | AAS Accessibility & Inclusive UX | 8 | WCAG audits, automated scans, screen-reader checks, and accessible QA. | | AAS API Platform Builder | 10 | API design, OpenAPI contracts, auth, security, load tests, and observability. | | AAS SaaS Launch & Revenue | 10 | SaaS MVPs, pricing, payments, analytics, lifecycle, referrals, and SEO. | | AAS AI Product & Evaluation Ops | 10 | AI product metrics, evals, tracing, experiments, and model-quality loops. |

Next-wave plugins cover marketing/SEO/growth, automation, observability/incident response, Python APIs, mobile apps, data engineering, privacy/compliance, and localization/international growth.

• Read the specialized plugin roadmap.
• Read the plugin guide for compatible agent clients.
• Compare the hosted specialized plugin landing page.
• Browse the generated plugin folders in plugins/.

Choose Your Tool

Use the same repository, but install or invoke it in the way your host expects.

| Tool | Install | First Use | | -------------- | ------------------------------------------------------------------------ | ------------------------------------------------------ | | Claude Code | AAS Core local MCP preview, direct install, or Claude plugin marketplace | Ask Claude to choose and compose an AAS stack | | Cursor | npx agentic-awesome-skills --cursor | @brainstorming help me plan a feature | | Gemini CLI | npx agentic-awesome-skills --gemini | Use brainstorming to plan a feature | | Codex CLI | AAS Core local MCP preview or npx agentic-awesome-skills --codex | Ask Codex to choose and compose an AAS stack | | Autohand Code | npx agentic-awesome-skills --path ~/.autohand/skills or --path .autohand/skills | Use brainstorming to plan a feature | | Antigravity IDE | npx agentic-awesome-skills --antigravity --skills --dry-run | Ask an MCP-enabled agent to choose exact IDs first | | Antigravity CLI (agy) | npx agentic-awesome-skills --agy | /brainstorming help me plan a feature | | Kiro CLI | npx agentic-awesome-skills --kiro | Use brainstorming to plan a feature | | Kiro IDE | npx agentic-awesome-skills --path ~/.kiro/skills | Use @brainstorming to plan a feature | | GitHub Copilot | gh skill install sickn33/agentic-awesome-skills skills/brainstorming/SKILL.md --agent github-copilot --scope user --pin v14.2.0 (preview) | Ask Copilot to use brainstorming to plan a feature | | OpenCode | npx agentic-awesome-skills --path .agents/skills --category development,backend --risk safe,none | opencode run @brainstorming help me plan a feature | | AdaL CLI | npx agentic-awesome-skills --path .adal/skills | Use brainstorming to plan a feature | | Custom path | npx agentic-awesome-skills --path ./my-skills | Depends on your tool |

Use the Codex and Claude guides for the AAS Core MCP preview path. For other hosts—or when you deliberately want manual delivery—use the table's direct install targets, specialized plugins, and host-specific path guidance.

• Claude Code skills: install paths, starter skills, prompt examples, and plugin marketplace flow.
• Cursor skills: .cursor/skills/ setup, UI-heavy work, and pair-programming flows.
• Codex CLI skills: planning, implementation, debugging, and review skills for local coding loops.
• Gemini CLI skills: research, agent systems, integrations, and engineering workflows.
• AI agent skills guide: breadth vs curation, skill-library evaluation, and starting-point selection.

Quick FAQ

What is Agentic Awesome Skills?

Agentic Awesome Skills is the repository behind AAS Core, a local agent-first control plane for recording and validating agent-chosen skill stacks. The read-only AAS MCP gives Codex and Claude complete catalog search and skill inspection; the stack CLI and Workbench make the chosen state reproducible and reviewable. Direct installers, specialized plugins, bundles, and workflows remain supported distribution and discovery surfaces.

Is AAS Core fully certified?

The supported path covers complete local catalog search and inspection, agent-owned selection, stack composition and validation, immutable planning, and diagnosis. Transactional apply/recovery safety remains outside the supported claim; apply and recovery are explicitly experimental and disabled without additional opt-in flags.

How do I install it?

For AAS Core, follow the preview guide and use only a package release whose notes explicitly state that it includes Core. Release 14.6.0 predates Core; Core-capable releases begin with the 15.x line.

For direct skill distribution, use a tool-specific flag such as