Agentic Awesome Skills — AI Skills & AAS Core

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

Agentic Awesome Skills is a library of 2,877+ installable SKILL.md playbooks for Claude Code, Codex, Cursor, Gemini CLI and other AI coding agents. AAS Core helps Codex or Claude search the complete local catalog, record the skills the agent chooses, and preview a plan you can inspect before changing a target. Core does not rank or recommend skills.

Start here: Explore the skill catalog · Codex setup · Claude Code setup · Install skills directly

Current release: V20.2.0. AAS Core supports local catalog inspection, agent-owned selection, stack validation, and plan preview. Apply and recovery remain experimental. Read the AAS Core preview guide for setup and exact trust boundaries.

This README tracks main. Features listed under Unreleased require a later release; the versioned guide describes the published package.

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

Table of Contents

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

Watch the Introduction

A 40-second introduction to Agentic Awesome Skills. Press play to watch it here on GitHub.

https://github.com/user-attachments/assets/02aa20ca-c3bb-4984-807e-7b06ef77e785

If GitHub’s player stalls, watch the video on the AAS website.

Support the Project

Help keep the catalog open, maintained, and available to the builders who use it.

Every contribution helps us keep the skills curated, the tooling tested, and the catalog useful for the next project.

Security tooling support: Snyk.

AI compute & model credits: Atlas Cloud (supporting media generation workflows via atlas-cloud-media).

This project is tested with BrowserStack.

For a complete setup through your first skill selection and installation preview, follow Codex setup or Claude Code setup.

AAS Core: Agent-First Preview

Codex or Claude inspects your project and chooses exact skills. Every current catalog skill is individually searchable, readable, and available for agent selection. The read-only compose_stack tool validates the chosen IDs and structure in memory; a client or the aas CLI can persist aas-stack.json and optional selection evidence. aas stack validate checks the manifest, while aas stack plan writes an immutable preview for your review. Manifests have a technical maximum of 128 skills; Core does not rank or recommend candidates or install skills in this supported preview path.

[!IMPORTANT] Structural and identity validity does not certify semantic fit, compatibility, setup correctness, operational safety, or safety to apply. Apply and recovery require experimental opt-in and remain outside the supported preview.

The Workbench reviews stack and plan artifacts in browser memory without accessing your filesystem. See the Core guide for tool contracts, capability coverage, and limits.

Installation

From selection to use

Start with AAS Core in Codex or Claude. Configure the local MCP using the Codex or Claude guide. With the MCP available, ask the agent to inspect your project, compare relevant skills, and save the exact selection. Then validate its manifest and review the resulting plan before any installation. The first configuration command previews a change and returns an approval digest:

npm exec --yes --ignore-scripts [email protected] -- aas mcp configure \
  --host codex \
  --scope user \
  --config /absolute/path/to/codex/config.toml \
  --cache-root /absolute/path/to/aas-cache

Use --host claude and its configuration path for Claude. The Core setup guide explains approval, reconnection, validation, and planning. To hand the reviewed IDs to the direct installer, use aas stack install-preview as described in the manifest handoff; that command only prepares a --dry-run preview and does not apply a Core plan.

Install selected skills directly

If you already know the IDs, preview a focused install into your host’s skill directory:

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

Review the preview, then repeat without --dry-run when ready. The direct installer does not consume or apply a Core plan. Antigravity’s watched skill directory can overload its context, so its default target requires a selected set, a filter, or an explicit --all override. See the installation guide and security guidance for other targets, auditing, and failure modes.

Choose Your Tool

Use the path for your agent. Core setup is available for Codex and Claude; the other rows show direct install targets or plugin options.

See the host guides, including Claude Code, Cursor, Codex, and Gemini CLI, for complete setup.

Recommended Specialized Plugins

Choose a focused plugin for the domain you are working in. These packages are available for Claude Code and Codex; compatible bundles also have a standard Agent Plugins manifest. See the plugin guide for installation and host support.

Browse the plugin roadmap, live plugin catalog, or generated plugins/ tree for the full set.

Bundles & Workflows

Bundles suggest related skills; workflows describe the order to use them. They are guidance for selecting and running skills, not additional packages to install.

• Bundles group skills by role or goal, such as Web Wizard, Security Engineer, and OSS Maintainer.
• Workflows give ordered playbooks for planning, shipping, testing, and auditing; workflow metadata is available for integrations.
• If too many installed skills overload Antigravity, follow the selective activation guide. For other hosts, preview a smaller exact install or use the installer’s --risk, --category, and --tags filters.

Browse 2,877+ Skills

Explore the complete library in the hosted catalog or CATALOG.md. The canonical playbooks live in skills/; skills_index.json provides machine-readable discovery. Use Getting Started and Usage for first steps, or the Workbench to inspect a saved Core stack and plan in your browser.

For narrower comparisons, see Claude Code skills, Cursor skills, and the library comparison.

Troubleshooting

• Core setup and trust boundaries
• Installation and everyday use
• Windows context and truncation recovery
• Linux/macOS overload and selective activation
• Plugin compatibility and installation
• Security and antivirus alerts

Stable Skills Manifest v1

Host integrations that load individual SKILL.md files can use skills_index.json, the v1 schema, and the compatibility mirror. This direct-host discovery manifest is separate from aas-stack.json and the AAS Core catalog. Read the discovery contract before integrating.

Contributing

• Add new skills under skills//SKILL.md and follow CONTRIBUTING.md.
• Start from the skill template and run npm run validate before a PR.
• Keep source PRs free of generated registry artifacts. Skill content and risky guidance require manual logic and safety review alongside automated checks.

Community

• Discussions for questions, ideas, and examples.
• Issues for reproducible bugs and actionable improvements.
• Follow @AASkills_ on X for project updates and examples, or @sickn33 for releases.
• CODE_OF_CONDUCT.md for community expectations; SECURITY.md for security reports.

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

Catalog dashboard search, filters, shortlist, and discovery were originally contributed by @zinzied in #1111, then repaired and integrated through #1118 under the repository’s fork-safety policy.

Top Contributors

Thanks to everyone who has helped build this project—especially the contributors below.

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

View the live Star History chart.

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.

---

Consolidated plugin packs

The focused offer unifies overlapping historical bundles with the AAS packs. Use the plugin migration guide to find replacements. Existing installations require a manual switch after verifying the destination; activation aliases do not create duplicate marketplace plugins. Changes on main become available through the next published release.