AAS Core — Agentic Awesome Skills
Local, agent-owned skill stacks for coding agents—from complete catalog access to a reproducible, reviewable plan.
Current release: V15.3.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 →
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.
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 preserves
search_skills, get_skill, compose_stack, inspect_stack, and diff_stack, and adds read-only export_selection_evidence and inspect_selection_evidence; Core does not rank, recommend, exclude, or hide skills.
- 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: 1,988+ 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.
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
- AAS Core: Agent-First Preview
- Why This Repo
- Installation
- Recommended Specialized Plugins
- Choose Your Tool
- Quick FAQ
- Bundles & Workflows
- Browse 1,988+ 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, 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.
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 specialized plugin install vs direct skills install.
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. 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 | 10 | 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.
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 | Use @brainstorming to plan a feature |
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 |
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, run npx agentic-awesome-skills for the default full-library install. Use a tool-specific flag such as --codex, --cursor, --gemini, --claude, or --antigravity when you want the legacy installer to place skills in the directory your assistant already watches.
For Autohand Code, use the installer with a custom path:
npx agentic-awesome-skills --path ~/.autohand/skills
npx agentic-awesome-skills --path .autohand/skills
What are AAS specialized plugins?
AAS specialized plugins are focused, domain-specific distributions of the skill library. They package the most relevant skills for web apps, security, data analytics, documents, DevOps, QA, OSS maintenance, and agent or MCP work so users can start with the right surface instead of activating the entire catalog.
Should I use the full library or a plugin?
Use the full library if you want the biggest catalog and direct filesystem control. Use a specialized plugin when you want a smaller, marketplace-style distribution for a specific workflow in Claude Code or Codex. For Antigravity, install the matching skills into the supported skills path. The complete explanation lives in Plugins for Claude Code and Codex.
How are plugins, bundles, and workflows different?
Plugins are installable packaging surfaces, bundles are curated skill recommendations, and workflows are ordered execution playbooks. Start with a plugin when the domain is clear, use bundles to compare adjacent skills, and use workflows when the important part is sequencing planning, coding, testing, auditing, or release work.
Where do I browse plugins, bundles, workflows, and the full catalog?
Start with Specialized Plugins when you want an installable domain pack. Use Bundles for role-based recommendations, Workflows for ordered execution playbooks, CATALOG.md for the full registry, and the hosted GitHub Pages catalog for searchable browsing.
Bundles & Workflows
Core, plugins, bundles, and workflows answer different questions. Codex or Claude selects skills; AAS Core records and validates that selection; plugins package a focused delivery surface; bundles are curated starting points; workflows are ordered playbooks for getting a result.
| Surface | Answers | Use it for |
|---|
| AAS Core | How do I search the full catalog and preserve the agent's chosen stack? | Agent-owned selection, a pinned aas-stack.json, validation, and immutable plan preview. |
| Specialized plugin | What should I install or activate for this domain? | Focused Claude Code/Codex plugin packaging and Antigravity-compatible skill selection. |
| Bundle | Which skills naturally belong together? | Role-based discovery after a full-library install or when building a custom subset. |
| Workflow | What order should the agent run skills in? | Planning, shipping, auditing, testing, or incident-style execution. |
Use a specialized plugin first when your domain is clear. Use bundles to explore adjacent skills or assemble a custom install. Use workflows when the hard part is sequencing the work.
Start with bundles
Bundles are curated groups of recommended skills for a role or goal such as Web Wizard, Security Engineer, or OSS Maintainer.
- Bundles are recommendations, not separate installs.
- Install the closest specialized plugin when one matches your work, or install the repository once and use docs/users/bundles.md to pick a starting set.
- Good starter combinations:
- SaaS MVP:
Essentials + Full-Stack Developer + QA & Testing
- Production hardening:
Security Developer + DevOps & Cloud + Observability & Monitoring
- OSS shipping:
Essentials + OSS Maintainer
Use workflows for outcome-driven execution
- Read docs/users/workflows.md for human-readable playbooks.
- Use data/workflows.json for machine-readable workflow metadata.
- Initial workflows include shipping a SaaS MVP, security audits, AI agent systems, QA/browser automation, and DDD-oriented design work.
Need fewer active skills at runtime?
If Antigravity starts hitting context limits with too many active skills, the activation guidance in docs/users/agent-overload-recovery.md can materialize only the bundles or skill ids you want in the live Antigravity directory.
If you use OpenCode or another .agents/skills host, prefer a reduced install up front instead of copying the full library into a context-sensitive runtime. The installer now supports --risk, --category, and --tags so you can keep the installed set narrow.
For a reproducible exact set, pin the package and catalog release and preview the full per-target plan before writing:
npx agentic-awesome-skills@14.3.0 --codex --release 14.3.0 --skills frontend-design,game-development/2d-games --dry-run
Remove --dry-run only after reviewing the install, update, and removal plan. Unknown or ambiguous skill identifiers fail closed, and metadata filters combine with --skills using AND.
The hosted Skill Workbench imports and reviews AAS Core stack manifests and immutable plans in browser memory. It does not access the filesystem, generate an approved plan, or install skills.
Browse 1,988+ Skills
Use the root repo as a landing page, then jump into the deeper surface that matches your intent.
What you get in this repository
Best ways to explore
Compare alternatives
Troubleshooting
Keep the root README short; use the dedicated docs for recovery and platform-specific guidance.
- If you are confused after installation, start with the Usage Guide.
- For Core setup, trust boundaries, stack manifests, and preview status, use the AAS Core guide.
- On native Windows,
AAS_ADAPTER_WINDOWS_ACL_FAILED refers to the configuration path checked with PowerShell Get-Acl, not the cache and not icacls; do not approve until preview returns an approval digest.
- If you integrate agentic-awesome-skills into a host, read the discovery contract first: Stable Skills Manifest v1.
- For Windows truncation or context crash loops, use docs/users/windows-truncation-recovery.md.
- For Linux/macOS overload or selective activation, use docs/users/agent-overload-recovery.md.
- For OpenCode or other
.agents/skills installs, prefer a reduced install such as npx agentic-awesome-skills --path .agents/skills --category development,backend --risk safe,none.
- For plugin install details, host compatibility, and marketplace-safe distribution, use docs/users/plugins.md.
- For contributor expectations and guardrails, use CONTRIBUTING.md,
CODE_OF_CONDUCT.md, and SECURITY.md.
Stable Skills Manifest v1
This is the stable direct-host discovery manifest for integrations that load individual SKILL.md files. It is not aas-stack.json, the verified AAS Core catalog, or the Core composition contract. Core users should start with the AAS Core guide; custom host integrations can continue using the manifest below.
Host integrations should use:
This keeps discovery stable (id, path, metadata) while ensuring hosts only load SKILL.md for requested @skill-id values.
Support the Project
Support is optional. The project stays free and open-source for everyone.
Contributing
- Add new skills under
skills/<skill-name>/SKILL.md.
- Follow the contributor guide in
CONTRIBUTING.md.
- Use the template in
docs/contributors/skill-template.md.
- Validate with
npm run validate before opening a PR.
- Keep community PRs source-only: do not commit generated registry artifacts like
CATALOG.md, skills_index.json, or data/*.json.
- If your PR changes
SKILL.md, expect the automated skill-review check on GitHub in addition to the usual validation and security scans.
- If your PR changes skills or risky guidance, manual logic review is still required even when the automated checks are green.
Community
Credits & Sources
We stand on the shoulders of giants.
👉 View the Full Attribution Ledger
Source credits stay here for attribution and auditability. Repository contributor credit lives separately in Repo Contributors.
Key source families include:
- Official AI platform and tool repositories
- Security, web, infrastructure, data, design, and automation communities
- Independent skill authors and open-source maintainers
Official Sources
- aislon/uizze-mcp: Official source for the
uizze-ui-research skill and UIZZE MCP-assisted UI research workflows.
- anthropics/skills: Official Anthropic skills repository - Document manipulation (DOCX, PDF, PPTX, XLSX), Brand Guidelines, Internal Communications.
- anthropics/claude-cookbooks: Official notebooks and recipes for building with Claude.
- remotion-dev/skills: Official Remotion skills - Video creation in React with 28 modular rules.
- vercel-labs/agent-skills: Vercel Labs official skills - React Best Practices, Web Design Guidelines.
- openai/skills: OpenAI Codex skills catalog - Agent skills, Skill Creator, Concise Planning.
- supabase/agent-skills: Supabase official skills - Postgres Best Practices.
- microsoft/skills: Official Microsoft skills - Azure cloud services, Bot Framework, Cognitive Services, and enterprise development patterns across .NET, Python, TypeScript, Go, Rust, and Java.
- Simon-He95/markstream-vue: Official Markstream skill for installing streaming Markdown renderers across Vue, React, Svelte, Angular, Nuxt, Next.js, and Vue 2 applications (MIT).
- nowork-studio/NotFair: Official source for the
seo-drift skill - dated SEO baselines and regression detection across rankings, indexation, metadata, directives, schema, and on-page elements (MIT).
- MiniMax-AI/cli: Official MiniMax CLI - text, image, video, speech, music, vision, and web-search workflows for MiniMax models and APIs.
- google-gemini/gemini-skills: Official Gemini skills - Gemini API, SDK and model interactions.
Community Contributors
-
0xsarwagya/ontoly: Source for the ontoly-software-graph skill - deterministic TypeScript software graphs, MCP-backed architecture review, request tracing, impact analysis, and dependency analysis (MIT).
-
amElnagdy/guard-skills — Code Quality & Testing Guard Skills (by amElnagdy)
-
cloudflare/security-audit-skill — Cloudflare Web Security Audit Skill (by Cloudflare)
-
gooseworks-ai/goose-skills: Source for the competitor-ad-intelligence and ad-campaign-analyzer skills - evidence-labeled public ad research plus uncertainty-aware campaign diagnostics and bounded budget tests (MIT).
-
supernovae-st/nika-agents: Official upstream source for the nika skill and its deterministic, budget-aware AI workflow runner (MIT skill content; AGPL-3.0 engine).
-
atdy/maoxuan-product-agent: Source for the product-decision-agent skill - Chinese-first product judgment across prioritization, growth, operations, data, delivery, and cross-functional collaboration, with 36 tested scenarios (MIT).
-
hafiz-actyte/idea-autopsy: Source for the idea-autopsy skill - business-idea validation that hunts the one sentence that kills an idea before you build: kill-list check, five hard filters, free-AI one-prompt test, and live ad-market verification (MIT).
-
cruisekkk/trading-ledger: Source for the trading-ledger skill - decision-quality trade journaling that captures entry thesis, plan, and emotion into the user's own Notion database (MIT).
-
cruisekkk/time-ledger: Source for the time-ledger skill - natural-language time tracking parsed into the user's own Notion database with ask-instead-of-guessing reconciliation (MIT).
Inspirations
Additional Sources
- agent-cards/skill: Manage prepaid virtual Visa cards for AI agents. Create cards, check balances, view credentials, close cards, and get support via MCP tools.
Repo Contributors
Made with contrib.rocks. (Image may be cached; view live contributors on GitHub.)
We officially thank the following contributors for their help in making this repository awesome!
Star History
If Agentic Awesome Skills has been useful, consider ⭐ starring the repo!
License
Original code and tooling are licensed under the MIT License. See LICENSE.
Original documentation and other non-code written content are licensed under CC BY 4.0, unless a more specific upstream notice says otherwise. See docs/sources/sources.md for attributions and third-party license details.
