| Support AAS | What it helps fund |
| --- | --- |
| [β₯ Sponsor AAS](https://github.com/sponsors/sickn33) | Ongoing maintenance, reviews, and release work |
| [Buy Me a Coffee](https://buymeacoffee.com/sickn33) | Small, direct contributions from the community |
Every contribution helps us keep the skills curated, the tooling tested, and the catalog useful for the next project.
*Security tooling support: [Snyk](https://snyk.io/).*
*AI compute & model credits: [Atlas Cloud](https://atlascloud.ai/) (supporting media generation workflows via [`atlas-cloud-media`](skills/atlas-cloud-media/SKILL.md)).*
*This project is tested with BrowserStack.*
[](https://www.atlascloud.ai?ref=M9PEA3)
For a complete setup through your first skill selection and installation preview, follow [Codex setup](docs/users/codex-cli-skills.md) or [Claude Code setup](docs/users/claude-code-skills.md).
## 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](https://aaskills.tech/workbench) reviews stack and plan artifacts in browser memory without accessing your filesystem. See the [Core guide](https://github.com/sickn33/agentic-awesome-skills/blob/v20.0.0/docs/users/aas-core.md) 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](docs/users/codex-cli-skills.md) or [Claude](docs/users/claude-code-skills.md) 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:
```bash
npm exec --yes --ignore-scripts --package=agentic-awesome-skills@20.0.0 -- 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](https://github.com/sickn33/agentic-awesome-skills/blob/v20.0.0/docs/users/aas-core.md#configure-the-local-mcp) 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](docs/users/aas-core.md#use-the-reviewed-selection); 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:
```bash
npm exec --yes --ignore-scripts --package=agentic-awesome-skills@20.0.0 -- \
agentic-awesome-skills --release 20.0.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](docs/users/getting-started.md) and [security guidance](docs/users/security-and-antivirus.md) 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.
| Tool | Install | First Use |
| -------------- | ------------------------------------------------------------------------ | ------------------------------------------------------ |
| Claude Code | [AAS Core local MCP preview](docs/users/claude-code-skills.md), 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](docs/users/codex-cli-skills.md) 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
### Most Commits
Contributors ranked by the number of commits.
| # | Contributor | Commits |
|---:|---|---:|
| 1 |  [@WHOISABHISHEKADHIKARI](https://github.com/WHOISABHISHEKADHIKARI) | 36 |
| 2 |  [@munir-abbasi](https://github.com/munir-abbasi) | 34 |
| 3 |  [@Mohammad-Faiz-Cloud-Engineer](https://github.com/Mohammad-Faiz-Cloud-Engineer) | 33 |
| 4 |  [@zinzied](https://github.com/zinzied) | 24 |
| 5 |  [@beatra-ai](https://github.com/beatra-ai) | 19 |
| 6 |  [@Prince-1652](https://github.com/Prince-1652) | 17 |
| 7 |  [@ssumanbiswas](https://github.com/ssumanbiswas) | 15 |
| 8 |  [@FrancoStino](https://github.com/FrancoStino) | 13 |
| 9 |  [@Champbreed](https://github.com/Champbreed) | 10 |
| 10 |  [@Dokhacgiakhoa](https://github.com/Dokhacgiakhoa) | 10 |
|
### Most Skills Added
Contributors ranked by the number of skills they added.
| # | Contributor | Skills added |
|---:|---|---:|
| 1 | [@FrancoStino](https://github.com/FrancoStino) | 336 |
| 2 | [@WHOISABHISHEKADHIKARI](https://github.com/WHOISABHISHEKADHIKARI) | 125 |
| 3 | [@Prince-1652](https://github.com/Prince-1652) | 91 |
| 4 |  [@sohamganatra](https://github.com/sohamganatra) | 78 |
| 5 |  [@ProgramadorBrasil](https://github.com/ProgramadorBrasil) | 52 |
| 6 |  [@nikolasdehor](https://github.com/nikolasdehor) | 35 |
| 7 | [@beatra-ai](https://github.com/beatra-ai) | 23 |
| 8 |  [@Ranjeet2063](https://github.com/Ranjeet2063) | 20 |
| 9 |  [@MMEHDI0606](https://github.com/MMEHDI0606) | 20 |
| 10 |  [@ShianMike](https://github.com/ShianMike) | 13 |
|