agentic-awesome-skills 18.6.0 → 18.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,31 +1,15 @@
1
- <!-- registry-sync: version=18.6.0; skills=2472; stars=46935; updated_at=2026-09-26T11:02:22+00:00 -->
1
+ <!-- registry-sync: version=18.8.0; skills=2476; stars=47005; updated_at=2026-09-28T06:59:25+00:00 -->
2
2
  # AAS Core — Agentic Awesome Skills
3
3
 
4
4
  > **Find reusable instructions for your project, inspect their complete files, and keep an exact skill set you can review and reuse.**
5
5
 
6
- **Current release: V18.6.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.
6
+ Agentic Awesome Skills is a library of 2,476+ installable `SKILL.md` playbooks. 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.
7
7
 
8
- 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.
8
+ **Current release: V18.8.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](https://github.com/sickn33/agentic-awesome-skills/blob/v18.8.0/docs/users/aas-core.md) for setup and exact trust boundaries.
9
9
 
10
- **[Read the AAS Core preview guide →](https://github.com/sickn33/agentic-awesome-skills/blob/v18.6.0/docs/users/aas-core.md)**
10
+ This README tracks `main`. Features listed under [Unreleased](CHANGELOG.md#unreleased) require a later release; the versioned guide describes the published package.
11
11
 
12
- This README tracks `main`. Changes under [Unreleased](CHANGELOG.md#unreleased), including complete bundle inspection, Workbench evidence import and sparse installer retrieval, require a subsequent release; the linked versioned guide describes the published package.
13
-
14
- ```text
15
- Project
16
- -> inspected by Codex or Claude (not by AAS)
17
- -> agent searches and reads the complete local catalog
18
- -> AAS MCP (local stdio, read-only)
19
- -> Codex or Claude chooses exact skill IDs
20
- -> compose_stack validates the selection in memory (read-only)
21
- -> client or AAS CLI persists aas-stack.json and optional evidence
22
- -> AAS CLI validate + immutable plan preview
23
- -> human review (optionally in Workbench)
24
- ```
25
-
26
- 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.
27
-
28
- 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.
12
+ 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](https://aaskills.tech/) and browser-local Workbench are companion discovery and review surfaces.
29
13
 
30
14
  [![GitHub stars](https://img.shields.io/badge/⭐%2047%2C000%2B%20Stars-gold?style=for-the-badge)](https://github.com/sickn33/agentic-awesome-skills/stargazers)
31
15
  [![Follow @AASkills_ on X](https://img.shields.io/badge/Follow-%40AASkills__-black?style=for-the-badge&logo=x)](https://x.com/AASkills_)
@@ -42,236 +26,94 @@ This is an independent community project. It is not affiliated with, sponsored b
42
26
  [![OpenCode](https://img.shields.io/badge/OpenCode-CLI-gray?style=for-the-badge)](https://github.com/opencode-ai/opencode)
43
27
  [![Antigravity](https://img.shields.io/badge/Antigravity-AI%20IDE-red?style=for-the-badge)](https://github.com/sickn33/agentic-awesome-skills)
44
28
 
45
- ## Watch the Introduction
46
-
47
- A 40-second introduction to Agentic Awesome Skills. Press play to watch it here on GitHub.
48
-
49
- https://github.com/user-attachments/assets/02aa20ca-c3bb-4984-807e-7b06ef77e785
50
-
51
- If GitHub's player stalls, [watch the video on the AAS website](https://aaskills.tech/).
52
-
53
- ## Support the Project
54
-
55
- **We’re looking for sponsors to support Agentic Awesome Skills.** If you or your company would like to support the project, become a sponsor.
56
-
57
- ### [♥ Sponsor AAS →](https://github.com/sponsors/sickn33)
58
-
59
- You can also [support AAS on Buy Me a Coffee](https://buymeacoffee.com/sickn33).
60
-
61
- <a href="https://buymeacoffee.com/sickn33">
62
- <img src="assets/buy-me-a-coffee-banner.png" alt="Support Agentic Awesome Skills on Buy Me a Coffee" width="420" />
63
- </a>
64
-
65
- *Security tooling support: [Snyk](https://snyk.io/).*
66
- *AI compute & model credits: [Atlas Cloud](https://atlascloud.ai/) (supporting media generation workflows via [`atlas-cloud-media`](skills/atlas-cloud-media/SKILL.md)).*
67
- *This project is tested with BrowserStack.*
68
-
69
- [![Powered by Atlas Cloud](https://www.atlascloud.ai/oss-program/powered-by-atlas-cloud.svg)](https://www.atlascloud.ai/)
70
-
71
- ## AAS Core: Agent-First Preview
72
-
73
- > **The agent composes. You control. AAS keeps the stack reproducible.**
74
-
75
- AAS Core gives the repository one product model:
76
-
77
- - **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.
78
- - **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.
79
- - **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.
80
- - **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.
81
- - **Review in Workbench.** The hosted Workbench imports and reviews stack/plan JSON in browser memory; it does not access your filesystem or install anything.
82
- - **Retain every useful distribution path.** Direct installs, plugins, bundles, workflows, and the full catalog remain available as payload and compatibility surfaces.
83
-
84
- > [!IMPORTANT]
85
- > Structural and identity validity does not certify semantic fit, compatibility, setup correctness, operational safety, or safety to apply.
86
-
87
- | Surface | Current status |
88
- | --- | --- |
89
- | Published package | Current npm release; AAS Core status is `agent-first-preview` |
90
- | Catalog search and inspection | Supported preview; local and read-only |
91
- | Agent-owned composition | Supported preview; Core validates IDs and structure, not semantic suitability; manifests have a technical maximum of 128 skills |
92
- | Stack validation and plan preview | Supported preview; no target skill changes |
93
- | Workbench | Browser-local review of stack and plan artifacts |
94
- | Selection evidence | Exported and inspected through MCP/CLI contracts; not yet reviewed in Workbench |
95
- | Apply and recovery | Experimental, explicit opt-in, outside the supported safety claim |
96
- | Semantic suitability certification | Not provided |
97
-
98
- Read the [AAS Core guide](https://github.com/sickn33/agentic-awesome-skills/blob/v18.6.0/docs/users/aas-core.md) for the exact trust boundaries, current preview status, Codex/Claude setup model, and CLI lifecycle.
99
-
100
- ## Why This Repo
101
-
102
- - **Agent-first, locally controlled**: Codex or Claude inspects the project and chooses from the complete local catalog without uploading your repository to AAS.
103
- - **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.
104
- - **Approval before writes**: the durable artifacts are an approved stack and immutable plan, not an opaque one-shot install.
105
- - **Installable, not just inspirational**: use the compatible legacy installer or plugin distributions when direct delivery is the right path.
106
- - **Built for major agent workflows**: Claude Code, Cursor, Codex CLI, Autohand Code, Gemini CLI, Antigravity, Kiro, OpenCode, Copilot, and more.
107
- - **Broad coverage with real utility**: 2,472+ skills across development, testing, security, infrastructure, product, and marketing.
108
- - **Inspect before installing**: the hosted [Skill Workbench](https://aaskills.tech/workbench) reviews agent-produced stack manifests and immutable plans without browser-side installation.
109
- - **Focused delivery remains available**: specialized plugins package curated sets for web, security, data, docs, DevOps, QA, OSS, or agent/MCP workflows.
110
- - **Useful whether you want breadth or curation**: install the full catalog, choose a specialized plugin, start with bundles, or compare alternatives before installing.
111
-
112
- ### Why not just search the skills directory?
113
-
114
- 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.
115
-
116
29
  ## Table of Contents
117
30
 
118
31
  - [Watch the Introduction](#watch-the-introduction)
119
32
  - [Support the Project](#support-the-project)
120
33
  - [AAS Core: Agent-First Preview](#aas-core-agent-first-preview)
121
- - [Why This Repo](#why-this-repo)
122
34
  - [Installation](#installation)
123
- - [Recommended Specialized Plugins](#recommended-specialized-plugins)
124
35
  - [Choose Your Tool](#choose-your-tool)
125
- - [Quick FAQ](#quick-faq)
36
+ - [Recommended Specialized Plugins](#recommended-specialized-plugins)
126
37
  - [Bundles & Workflows](#bundles--workflows)
127
- - [Browse 2,472+ Skills](#browse-2472-skills)
38
+ - [Browse 2,476+ Skills](#browse-2476-skills)
128
39
  - [Troubleshooting](#troubleshooting)
129
40
  - [Stable Skills Manifest v1](#stable-skills-manifest-v1)
130
41
  - [Contributing](#contributing)
131
42
  - [Community](#community)
132
43
  - [Credits & Sources](#credits--sources)
44
+ - [Top Contributors](#top-contributors)
133
45
  - [Repo Contributors](#repo-contributors)
134
46
  - [Star History](#star-history)
135
47
  - [License](#license)
136
48
 
137
- ## Installation
138
-
139
- For Codex and Claude, start with the [AAS Core guide](https://github.com/sickn33/agentic-awesome-skills/blob/v18.6.0/docs/users/aas-core.md): 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.
140
-
141
- 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:
142
-
143
- - **Specialized plugins** when the job has a clear domain.
144
- - **Full library install** when you want every skill available in a local skills directory.
145
- - **Bundles and workflows** when you want role-based recommendations or ordered execution playbooks.
49
+ ## Watch the Introduction
146
50
 
147
- ### From selection to use
51
+ A 40-second introduction to Agentic Awesome Skills. Press play to watch it here on GitHub.
148
52
 
149
- On unreleased `main`, `aas stack install-preview --manifest <file> --destination <skill-directory>` 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](docs/users/aas-core.md#use-the-reviewed-selection).
53
+ https://github.com/user-attachments/assets/02aa20ca-c3bb-4984-807e-7b06ef77e785
150
54
 
151
- 1. Describe the project outcome to Codex or Claude with the local AAS MCP configured.
152
- 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.
153
- 3. Validate the manifest and review a CLI plan when you need an artifact-based check. Workbench can help inspect the artifacts.
154
- 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.
55
+ If GitHub's player stalls, [watch the video on the AAS website](https://aaskills.tech/).
155
56
 
156
- For example, after reviewing `brainstorming` and `systematic-debugging` for a Codex project, run from that project directory:
57
+ ## Support the Project
157
58
 
158
- ```bash
159
- npm exec --yes --ignore-scripts --package=agentic-awesome-skills@16.8.0 -- \
160
- agentic-awesome-skills --release 16.8.0 --path .agents/skills \
161
- --skills brainstorming,systematic-debugging --dry-run
162
- ```
59
+ **We’re looking for sponsors to support Agentic Awesome Skills.** If you or your company would like to support the project, become a sponsor.
163
60
 
164
- 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](docs/users/workflows.md#recorded-worked-cases) show observed inputs and outputs without claiming guaranteed model performance.
61
+ ### [♥ Sponsor AAS →](https://github.com/sponsors/sickn33)
165
62
 
166
- ### Direct skill install
63
+ You can also [support AAS on Buy Me a Coffee](https://buymeacoffee.com/sickn33).
167
64
 
168
- ```bash
169
- # Antigravity: preview an exact, agent-selected set before writing.
170
- npx agentic-awesome-skills --antigravity --skills brainstorming,systematic-debugging --dry-run
65
+ <a href="https://buymeacoffee.com/sickn33">
66
+ <img src="assets/buy-me-a-coffee-banner.png" alt="Support Agentic Awesome Skills on Buy Me a Coffee" width="420" />
67
+ </a>
171
68
 
172
- # Antigravity CLI slash commands (agy): ~/.gemini/antigravity-cli/skills/<skill>/SKILL.md
173
- npx agentic-awesome-skills --agy
174
- ```
69
+ *Security tooling support: [Snyk](https://snyk.io/).*
175
70
 
176
- 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](docs/maintainers/distribution-efficiency.md). 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.
71
+ *AI compute & model credits: [Atlas Cloud](https://atlascloud.ai/) (supporting media generation workflows via [`atlas-cloud-media`](skills/atlas-cloud-media/SKILL.md)).*
177
72
 
178
- Antigravity watches `~/.agents/skills` and may load enough installed instructions
179
- to exhaust its context, slow startup, trigger truncation errors, or enter a crash
180
- loop. For that target, the installer stops before cloning or writing unless you
181
- provide `--skills`, a metadata filter, or the explicit `--all` override. The bare
182
- `npx agentic-awesome-skills` command uses the same protected Antigravity target.
73
+ *This project is tested with BrowserStack.*
183
74
 
184
- The recommended flow is to ask Codex or Claude with the read-only AAS Core MCP
185
- configured to inspect the project, search the complete catalog, and choose exact
186
- skill IDs. The agent selects the IDs; AAS MCP validates them without installing; the agent
187
- or user then previews the direct installation with the command above and repeats
188
- it without `--dry-run` after review.
75
+ [![Powered by Atlas Cloud](https://www.atlascloud.ai/oss-program/powered-by-atlas-cloud.svg)](https://www.atlascloud.ai/)
189
76
 
190
- Other direct-install targets retain the legacy-compatible full-catalog behavior
191
- when no selectors are supplied. The CLI prints the catalog's risk summary first:
192
- a full install includes `critical` and authorized-use-only `offensive`
193
- instructions. Installation copies files; it does not execute their commands,
194
- but an agent may act on an installed skill later. Prefer an exact reviewed set:
77
+ ## AAS Core: Agent-First Preview
195
78
 
196
- ```bash
197
- npx agentic-awesome-skills audit --skills brainstorming,backend-dev-guidelines
198
- npx agentic-awesome-skills --skills brainstorming,backend-dev-guidelines --dry-run
199
- ```
79
+ 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.
200
80
 
201
- If you deliberately accept the context and crash-loop risk, the complete
202
- Antigravity catalog remains available through explicit consent:
81
+ > [!IMPORTANT]
82
+ > 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.
203
83
 
204
- ```bash
205
- npx agentic-awesome-skills --antigravity --all
206
- ```
84
+ 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/v18.8.0/docs/users/aas-core.md) for tool contracts, capability coverage, and limits.
207
85
 
208
- The audit reads the selected skill directories without executing them and
209
- reports command, network, credential, filesystem, privileged, destructive,
210
- symlink, and binary signals. It is a review aid, not a safety certificate. See
211
- [Security, trust, and antivirus alerts](docs/users/security-and-antivirus.md).
86
+ ## Installation
212
87
 
213
- ### Focused single-skill install with GitHub CLI (preview)
88
+ ### From selection to use
214
89
 
215
- 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:
90
+ 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:
216
91
 
217
92
  ```bash
218
- gh skill preview sickn33/agentic-awesome-skills skills/brainstorming/SKILL.md
219
- gh skill install sickn33/agentic-awesome-skills skills/brainstorming/SKILL.md \
220
- --agent github-copilot --scope user --pin v14.2.0
93
+ npm exec --yes --ignore-scripts --package=agentic-awesome-skills@18.8.0 -- aas mcp configure \
94
+ --host codex \
95
+ --scope user \
96
+ --config /absolute/path/to/codex/config.toml \
97
+ --cache-root /absolute/path/to/aas-cache
221
98
  ```
222
99
 
223
- `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.
100
+ Use `--host claude` and its configuration path for Claude. The [Core setup guide](https://github.com/sickn33/agentic-awesome-skills/blob/v18.8.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.
224
101
 
225
- ### Verify the install
226
-
227
- ```bash
228
- test -d ~/.agents/skills && echo "Skills installed in ~/.agents/skills"
229
- ```
102
+ ### Install selected skills directly
230
103
 
231
- ### Run your first skill
104
+ If you already know the IDs, preview a focused install into your host's skill directory:
232
105
 
233
- ```text
234
- Use @brainstorming to plan a SaaS MVP.
106
+ ```bash
107
+ npm exec --yes --ignore-scripts --package=agentic-awesome-skills@18.8.0 -- \
108
+ agentic-awesome-skills --release 18.8.0 --path .agents/skills \
109
+ --skills brainstorming,systematic-debugging --dry-run
235
110
  ```
236
111
 
237
- ### Prefer plugins for Claude Code, Codex, or another compatible client?
238
-
239
- - Use a specialized plugin when you want a focused marketplace-style distribution.
240
- - Use the full-library plugin only when you want the widest plugin-safe catalog.
241
- - Read [Plugins for compatible agent clients](docs/users/plugins.md) for host-specific installs, portable Agent Plugins bundles, and direct skills installs.
242
-
243
- ## Recommended Specialized Plugins
244
-
245
- 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.
246
-
247
- 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.
248
-
249
- | Plugin | Skills | Best for |
250
- | --- | ---: | --- |
251
- | AAS Web App Builder | 10 | Frontend and full-stack developers shipping modern web apps. |
252
- | AAS Product Design Studio | 10 | Product UI, brand, portfolio, accessibility, and richer visual work. |
253
- | AAS Security Engineer | 10 | Authorized security testing, audit, and hardening. |
254
- | AAS Secure App Builder | 9 | Developers who want security embedded while building features. |
255
- | AAS Documents & Presentations | 9 | Office files, document conversion, decks, and slide workflows. |
256
- | AAS Data Analytics | 10 | Product analytics, SQL, dashboards, and experiments. |
257
- | AAS Agent & MCP Builder | 10 | Agentic apps, MCP tools, RAG systems, and evaluation loops. |
258
- | AAS QA & Test Automation | 10 | Test suites, browser automation, and QA stabilization. |
259
- | AAS DevOps & Cloud | 10 | Infrastructure, deployments, and operational workflows. |
260
- | AAS Accessibility & Inclusive UX | 8 | WCAG audits, automated scans, screen-reader checks, and accessible QA. |
261
- | AAS API Platform Builder | 10 | API design, OpenAPI contracts, auth, security, load tests, and observability. |
262
- | AAS SaaS Launch & Revenue | 10 | SaaS MVPs, pricing, payments, analytics, lifecycle, referrals, and SEO. |
263
- | AAS AI Product & Evaluation Ops | 10 | AI product metrics, evals, tracing, experiments, and model-quality loops. |
264
-
265
- Next-wave plugins cover marketing/SEO/growth, automation, observability/incident response, Python APIs, mobile apps, data engineering, privacy/compliance, and localization/international growth.
266
-
267
- - Read the [specialized plugin roadmap](docs/users/specialized-plugin-roadmap.md).
268
- - Read the [plugin guide for compatible agent clients](docs/users/plugins.md).
269
- - Compare the hosted [specialized plugin landing page](https://aaskills.tech/plugins).
270
- - Browse the generated plugin folders in [`plugins/`](plugins/).
112
+ 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.
271
113
 
272
114
  ## Choose Your Tool
273
115
 
274
- Use the same repository, but install or invoke it in the way your host expects.
116
+ Use the path for your agent. Core setup is available for Codex and Claude; the other rows show direct install targets or plugin options.
275
117
 
276
118
  | Tool | Install | First Use |
277
119
  | -------------- | ------------------------------------------------------------------------ | ------------------------------------------------------ |
@@ -289,181 +131,69 @@ Use the same repository, but install or invoke it in the way your host expects.
289
131
  | AdaL CLI | `npx agentic-awesome-skills --path .adal/skills` | `Use brainstorming to plan a feature` |
290
132
  | Custom path | `npx agentic-awesome-skills --path ./my-skills` | Depends on your tool |
291
133
 
292
- 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.
293
-
294
- - [Claude Code skills](docs/users/claude-code-skills.md): install paths, starter skills, prompt examples, and plugin marketplace flow.
295
- - [Cursor skills](docs/users/cursor-skills.md): `.cursor/skills/` setup, UI-heavy work, and pair-programming flows.
296
- - [Codex CLI skills](docs/users/codex-cli-skills.md): planning, implementation, debugging, and review skills for local coding loops.
297
- - [Gemini CLI skills](docs/users/gemini-cli-skills.md): research, agent systems, integrations, and engineering workflows.
298
- - [AI agent skills guide](docs/users/ai-agent-skills.md): breadth vs curation, skill-library evaluation, and starting-point selection.
299
-
300
- ## Quick FAQ
301
-
302
- ### What is Agentic Awesome Skills?
303
-
304
- **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.
305
-
306
- ### Is AAS Core fully certified?
307
-
308
- 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.
309
-
310
- ### How do I install it?
311
-
312
- For AAS Core, follow the [preview guide](https://github.com/sickn33/agentic-awesome-skills/blob/v18.6.0/docs/users/aas-core.md) 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.
313
-
314
- For direct skill distribution, use a tool-specific flag such as `--codex`,
315
- `--cursor`, `--gemini`, or `--claude` to place skills in the directory your
316
- assistant watches. The default target is Antigravity; it requires `--skills`, a
317
- metadata filter, or explicit `--all` consent before cloning or writing because a
318
- full watched catalog can exhaust context or trigger a crash loop.
134
+ See the host guides, including [Claude Code](docs/users/claude-code-skills.md), [Cursor](docs/users/cursor-skills.md), [Codex](docs/users/codex-cli-skills.md), and [Gemini CLI](docs/users/gemini-cli-skills.md), for complete setup.
319
135
 
320
- For Autohand Code, use the installer with a custom path:
321
-
322
- ```bash
323
- npx agentic-awesome-skills --path ~/.autohand/skills
324
- npx agentic-awesome-skills --path .autohand/skills
325
- ```
326
-
327
- ### What are AAS specialized plugins?
328
-
329
- 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.
330
-
331
- ### Should I use the full library or a plugin?
332
-
333
- 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](docs/users/plugins.md).
334
-
335
- ### How are plugins, bundles, and workflows different?
336
-
337
- 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.
136
+ ## Recommended Specialized Plugins
338
137
 
339
- ### Where do I browse plugins, bundles, workflows, and the full catalog?
138
+ 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](docs/users/plugins.md) for installation and host support.
340
139
 
341
- Start with [Specialized Plugins](#recommended-specialized-plugins) when you want an installable domain pack. Use [Bundles](docs/users/bundles.md) for role-based recommendations, [Workflows](docs/users/workflows.md) for ordered execution playbooks, [CATALOG.md](CATALOG.md) for the full registry, and the hosted [GitHub Pages catalog](https://aaskills.tech/) for searchable browsing.
140
+ | Plugin | Skills | Best for |
141
+ | --- | ---: | --- |
142
+ | AAS Web App Builder | 10 | Frontend and full-stack developers shipping modern web apps. |
143
+ | AAS Product Design Studio | 10 | Product UI, brand, portfolio, accessibility, and richer visual work. |
144
+ | AAS Security Engineer | 10 | Authorized security testing, audit, and hardening. |
145
+ | AAS Secure App Builder | 9 | Developers who want security embedded while building features. |
146
+ | AAS Documents & Presentations | 9 | Office files, document conversion, decks, and slide workflows. |
147
+ | AAS Data Analytics | 10 | Product analytics, SQL, dashboards, and experiments. |
148
+ | AAS Agent & MCP Builder | 10 | Agentic apps, MCP tools, RAG systems, and evaluation loops. |
149
+ | AAS QA & Test Automation | 10 | Test suites, browser automation, and QA stabilization. |
150
+ | AAS DevOps & Cloud | 10 | Infrastructure, deployments, and operational workflows. |
151
+ | AAS Accessibility & Inclusive UX | 8 | WCAG audits, automated scans, screen-reader checks, and accessible QA. |
152
+ | AAS API Platform Builder | 10 | API design, OpenAPI contracts, auth, security, load tests, and observability. |
153
+ | AAS SaaS Launch & Revenue | 10 | SaaS MVPs, pricing, payments, analytics, lifecycle, referrals, and SEO. |
154
+ | AAS AI Product & Evaluation Ops | 10 | AI product metrics, evals, tracing, experiments, and model-quality loops. |
342
155
 
156
+ Browse the [plugin roadmap](docs/users/specialized-plugin-roadmap.md), [live plugin catalog](https://aaskills.tech/plugins), or generated [`plugins/`](plugins/) tree for the full set.
343
157
 
344
158
  ## Bundles & Workflows
345
159
 
346
- 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.
347
-
348
- | Surface | Answers | Use it for |
349
- | --- | --- | --- |
350
- | 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. |
351
- | Specialized plugin | What should I install or activate for this domain? | Focused Claude Code/Codex plugin packaging and Antigravity-compatible skill selection. |
352
- | Bundle | Which skills naturally belong together? | Role-based discovery after a full-library install or when building a custom subset. |
353
- | Workflow | What order should the agent run skills in? | Planning, shipping, auditing, testing, or incident-style execution. |
354
-
355
- 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.
356
-
357
- ### Start with bundles
358
-
359
- Bundles are curated groups of recommended skills for a role or goal such as `Web Wizard`, `Security Engineer`, or `OSS Maintainer`.
360
-
361
- - Bundles are recommendations, not separate installs.
362
- - Install the closest specialized plugin when one matches your work, or install the repository once and use [docs/users/bundles.md](docs/users/bundles.md) to pick a starting set.
363
- - Good starter combinations:
364
- - SaaS MVP: `Essentials` + `Full-Stack Developer` + `QA & Testing`
365
- - Production hardening: `Security Developer` + `DevOps & Cloud` + `Observability & Monitoring`
366
- - OSS shipping: `Essentials` + `OSS Maintainer`
160
+ Bundles suggest related skills; workflows describe the order to use them. They are guidance for selecting and running skills, not additional packages to install.
367
161
 
368
- ### Use workflows for outcome-driven execution
162
+ - [Bundles](docs/users/bundles.md) group skills by role or goal, such as `Web Wizard`, `Security Engineer`, and `OSS Maintainer`.
163
+ - [Workflows](docs/users/workflows.md) give ordered playbooks for planning, shipping, testing, and auditing; [workflow metadata](data/workflows.json) is available for integrations.
164
+ - If too many installed skills overload Antigravity, follow the [selective activation guide](docs/users/agent-overload-recovery.md). For other hosts, preview a smaller exact install or use the installer's `--risk`, `--category`, and `--tags` filters.
369
165
 
370
- - Read [docs/users/workflows.md](docs/users/workflows.md) for human-readable playbooks.
371
- - Use [data/workflows.json](data/workflows.json) for machine-readable workflow metadata.
372
- - Initial workflows include shipping a SaaS MVP, security audits, AI agent systems, QA/browser automation, and DDD-oriented design work.
166
+ ## Browse 2,476+ Skills
373
167
 
374
- ### Need fewer active skills at runtime?
168
+ Explore the complete library in the [hosted catalog](https://aaskills.tech/) or [`CATALOG.md`](CATALOG.md). The canonical playbooks live in [`skills/`](skills/); [`skills_index.json`](skills_index.json) provides machine-readable discovery. Use [Getting Started](docs/users/getting-started.md) and [Usage](docs/users/usage.md) for first steps, or the [Workbench](https://aaskills.tech/workbench) to inspect a saved Core stack and plan in your browser.
375
169
 
376
- If Antigravity starts hitting context limits with too many active skills, the activation guidance in [docs/users/agent-overload-recovery.md](docs/users/agent-overload-recovery.md) can materialize only the bundles or skill ids you want in the live Antigravity directory.
377
-
378
- 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.
379
-
380
- For a reproducible exact set, pin the package and catalog release and preview the full per-target plan before writing:
381
-
382
- ```bash
383
- npx agentic-awesome-skills@14.3.0 --codex --release 14.3.0 --skills frontend-design,game-development/2d-games --dry-run
384
- ```
385
-
386
- 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.
387
-
388
- The hosted [Skill Workbench](https://aaskills.tech/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.
389
-
390
- ## Browse 2,472+ Skills
391
-
392
- Use the root repo as a landing page, then jump into the deeper surface that matches your intent.
393
-
394
- ### What you get in this repository
395
-
396
- - **Skills library** in [`skills/`](skills/)
397
- - **AAS Core** in [`tools/lib/aas-v1`](tools/lib/aas-v1), exposed through the `aas` CLI and local `aas-mcp` server
398
- - **Versioned stack and result schemas** in [`schemas/aas-v1`](schemas/aas-v1)
399
- - **Compatible legacy installer CLI** powered by the npm package in [`package.json`](package.json)
400
- - **Generated catalog and metadata** in [`CATALOG.md`](CATALOG.md), `skills_index.json`, and [`data/`](data/)
401
- - **Hosted and local web app** in [`apps/web-app`](apps/web-app) and on [GitHub Pages](https://aaskills.tech/)
402
- - **Role-based bundles** in [docs/users/bundles.md](docs/users/bundles.md)
403
- - **Specialized plugin surfaces** in [docs/users/specialized-plugin-roadmap.md](docs/users/specialized-plugin-roadmap.md), [docs/users/plugins.md](docs/users/plugins.md), and [`plugins/`](plugins/)
404
- - **Execution workflows** in [docs/users/workflows.md](docs/users/workflows.md)
405
- - **User, contributor, and maintainer docs** under [`docs/`](docs/)
406
- - **Project visuals** in [`assets/`](assets/), including the [hero](assets/aas-readme-hero.jpeg), [social card](assets/aas-social-card.jpeg), [logo](assets/aas-logo.jpeg), and [support banner](assets/buy-me-a-coffee-banner.png)
407
-
408
- ### Best ways to explore
409
-
410
- - Read the full catalog in [`CATALOG.md`](CATALOG.md).
411
- - Browse the hosted catalog at [https://aaskills.tech/](https://aaskills.tech/).
412
- - Start with [Getting Started](docs/users/getting-started.md) and [Usage](docs/users/usage.md) if you are new after installation.
413
- - Use [Bundles](docs/users/bundles.md) for role-based discovery and [Workflows](docs/users/workflows.md) for step-by-step execution.
414
- - Use [Plugins for Claude Code and Codex](docs/users/plugins.md) when you care about marketplace-safe distribution, and the [Specialized Plugin Roadmap](docs/users/specialized-plugin-roadmap.md) when you want the best plugin candidates.
415
-
416
- ### Compare alternatives
417
-
418
- - **[Agentic Awesome Skills vs Awesome Claude Skills](docs/users/agentic-awesome-skills-vs-awesome-claude-skills.md)** for breadth vs curated-list tradeoffs.
419
- - **[Best Claude Code skills on GitHub](docs/users/best-claude-code-skills-github.md)** for a high-intent shortlist.
420
- - **[Best Cursor skills on GitHub](docs/users/best-cursor-skills-github.md)** for Cursor-compatible options and selection criteria.
421
- - **[Vexilo · A field guide to Claude Code](https://vexilo.app/?lang=en)** — different scope: a visual, searchable index of every Claude Code primitive (31 agents / 99 commands / 123 skills / 13 rules), organized around the 5-step workflow. Useful as a navigation layer *over* any skill library, not as a skill library itself. ([companion repo](https://github.com/lilhawk7077/claude-code-resources))
170
+ For narrower comparisons, see [Claude Code skills](docs/users/best-claude-code-skills-github.md), [Cursor skills](docs/users/best-cursor-skills-github.md), and the [library comparison](docs/users/agentic-awesome-skills-vs-awesome-claude-skills.md).
422
171
 
423
172
  ## Troubleshooting
424
173
 
425
- Keep the root README short; use the dedicated docs for recovery and platform-specific guidance.
426
-
427
- - If you are confused after installation, start with the [Usage Guide](docs/users/usage.md).
428
- - For Core setup, trust boundaries, stack manifests, and preview status, use the [AAS Core guide](https://github.com/sickn33/agentic-awesome-skills/blob/v18.6.0/docs/users/aas-core.md).
429
- - 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.
430
- - If you integrate agentic-awesome-skills into a host, read the discovery contract first: [Stable Skills Manifest v1](docs/users/discovery-manifest.md).
431
- - For Windows truncation or context crash loops, use [docs/users/windows-truncation-recovery.md](docs/users/windows-truncation-recovery.md).
432
- - For Linux/macOS overload or selective activation, use [docs/users/agent-overload-recovery.md](docs/users/agent-overload-recovery.md).
433
- - 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`.
434
- - For plugin install details, host compatibility, and marketplace-safe distribution, use [docs/users/plugins.md](docs/users/plugins.md).
435
- - For contributor expectations and guardrails, use [CONTRIBUTING.md](CONTRIBUTING.md), [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md), and [`SECURITY.md`](SECURITY.md).
174
+ - [Core setup and trust boundaries](https://github.com/sickn33/agentic-awesome-skills/blob/v18.8.0/docs/users/aas-core.md)
175
+ - [Installation and everyday use](docs/users/usage.md)
176
+ - [Windows context and truncation recovery](docs/users/windows-truncation-recovery.md)
177
+ - [Linux/macOS overload and selective activation](docs/users/agent-overload-recovery.md)
178
+ - [Plugin compatibility and installation](docs/users/plugins.md)
179
+ - [Security and antivirus alerts](docs/users/security-and-antivirus.md)
436
180
 
437
181
  ## Stable Skills Manifest v1
438
182
 
439
- 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](https://github.com/sickn33/agentic-awesome-skills/blob/v18.6.0/docs/users/aas-core.md); custom host integrations can continue using the manifest below.
440
-
441
- Host integrations should use:
442
-
443
- - [`skills_index.json`](./skills_index.json) as the **canonical array-format manifest**.
444
- - [`schemas/skills-index.v1.schema.json`](./schemas/skills-index.v1.schema.json) for the JSON shape.
445
- - [`data/skills_index.json`](./data/skills_index.json) as the compatibility mirror.
446
-
447
- This keeps discovery stable (`id`, `path`, metadata) while ensuring hosts only load `SKILL.md` for requested `@skill-id` values.
183
+ Host integrations that load individual `SKILL.md` files can use [`skills_index.json`](skills_index.json), the [v1 schema](schemas/skills-index.v1.schema.json), and the [compatibility mirror](data/skills_index.json). This direct-host discovery manifest is separate from `aas-stack.json` and the AAS Core catalog. Read the [discovery contract](docs/users/discovery-manifest.md) before integrating.
448
184
 
449
185
  ## Contributing
450
186
 
451
- - Add new skills under `skills/<skill-name>/SKILL.md`.
452
- - Follow the contributor guide in [`CONTRIBUTING.md`](CONTRIBUTING.md).
453
- - Use the template in [`docs/contributors/skill-template.md`](docs/contributors/skill-template.md).
454
- - Validate with `npm run validate` before opening a PR.
455
- - Keep community PRs source-only: do not commit generated registry artifacts like `CATALOG.md`, `skills_index.json`, or `data/*.json`.
456
- - If your PR changes `SKILL.md`, expect the automated `skill-review` check on GitHub in addition to the usual validation and security scans.
457
- - If your PR changes skills or risky guidance, manual logic review is still required even when the automated checks are green.
187
+ - Add new skills under `skills/<skill-name>/SKILL.md` and follow [`CONTRIBUTING.md`](CONTRIBUTING.md).
188
+ - Start from the [skill template](docs/contributors/skill-template.md) and run `npm run validate` before a PR.
189
+ - Keep source PRs free of generated registry artifacts. Skill content and risky guidance require manual logic and safety review alongside automated checks.
458
190
 
459
191
  ## Community
460
192
 
461
- - [Discussions](https://github.com/sickn33/agentic-awesome-skills/discussions) for questions, ideas, showcase posts, and community feedback.
462
- - [Issues](https://github.com/sickn33/agentic-awesome-skills/issues) for reproducible bugs and concrete, actionable improvement requests.
463
- - [Follow @AASkills_ on X](https://x.com/AASkills_) for daily skills, practical workflows, and example prompts from the repo.
464
- - [Follow @sickn33 on X](https://x.com/sickn33) for project updates and releases.
465
- - [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md) for community expectations and moderation standards.
466
- - [`SECURITY.md`](SECURITY.md) for security reporting.
193
+ - [Discussions](https://github.com/sickn33/agentic-awesome-skills/discussions) for questions, ideas, and examples.
194
+ - [Issues](https://github.com/sickn33/agentic-awesome-skills/issues) for reproducible bugs and actionable improvements.
195
+ - [Follow @AASkills_ on X](https://x.com/AASkills_) for project updates and examples, or [@sickn33](https://x.com/sickn33) for releases.
196
+ - [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md) for community expectations; [`SECURITY.md`](SECURITY.md) for security reports.
467
197
 
468
198
  ## Credits & Sources
469
199
 
@@ -484,6 +214,7 @@ Key source families include:
484
214
 
485
215
  ### Official Sources
486
216
 
217
+ - **[Spicy-API/nsfw-ai-skill](https://github.com/Spicy-API/nsfw-ai-skill)**: Official SpicyAPI source for the [`nsfw-ai-spicyapi`](skills/nsfw-ai-spicyapi/SKILL.md) skill — adult (18+) image, image-to-video and image-edit generation through the SpicyAPI API with quote-before-spend and adults-only / consent rules (MIT).
487
218
  - **[Atlas Cloud](https://atlascloud.ai/)**: Official source for the [`atlas-cloud-media`](skills/atlas-cloud-media/SKILL.md) skill — asynchronous image and video generation through the Atlas Cloud API.
488
219
  - **[sandbaseai/cli](https://github.com/sandbaseai/cli)**: Official source for the `sandbase-mcp` skill - discover, inspect, and invoke 2,000+ AI models and APIs through a local MCP bridge with explicit schema and cost checks (Apache-2.0).
489
220
  - **[vostride/agent-qa](https://github.com/vostride/agent-qa)**: Official Agent QA skills for authoring natural-language web and mobile tests, evidence-backed run triage, and scoped debug/fix workflows (FSL-1.1-ALv2, Apache-2.0 after two years).
@@ -526,6 +257,7 @@ Key source families include:
526
257
  - **[happy520ai/unified-ai-system](https://github.com/happy520ai/unified-ai-system)**: Official source for the `unified-ai-gateway` skill - governed Codex MCP tools for provider-free prompt enhancement, credential-free gateway health, readiness, fake-provider chat, knowledge, workflow, and workforce evidence (Apache-2.0).
527
258
  - **[testdriverai/testdriverai](https://github.com/testdriverai/testdriverai)**: Official TestDriver source for the `testdriver-e2e-testing` skill - author, run, and debug end-to-end tests that drive browsers and native apps in a real desktop sandbox with AI vision and natural-language element descriptions (Apache-2.0).
528
259
  - **[HEOJUNFO/ai-film-crew](https://github.com/HEOJUNFO/ai-film-crew)**: Official source for the `film-crew` skill - run a video idea past seven film-crew roles and get a shot list with one model-ready prompt per shot, plus prompt fixes and reroll diagnosis for Wan, LTX, Kling, Veo, Seedance, Hailuo, and Runway (MIT).
260
+ - **[hermes-labs-ai/lintlang](https://github.com/hermes-labs-ai/lintlang)**: Official source for the `lintlang-audit` skill - deterministic, zero-LLM static auditing of agent instructions, tool definitions, and embedded Python prompts, reporting finding codes and locations without editing files or calling a model (Apache-2.0).
529
261
 
530
262
  </details>
531
263
 
@@ -570,6 +302,7 @@ Key source families include:
570
302
  - **[agentbody/skills](https://github.com/agentbody/skills)**: Source for the `people-data` skill - LinkedIn and YouTube professional-profile and public business-contact research via the Agent Body MCP server (MIT).
571
303
  - **[sudosubin/gh-attach](https://github.com/sudosubin/gh-attach)**: Source for the `gh-attach` skill - GitHub CLI uploads and downloads of `user-attachments` (screenshots, PDFs, zips, videos), producing repo-scoped URLs for PRs, issues, and READMEs, with GitHub Enterprise Server support (MIT).
572
304
  - **[Continuum-AI-Corp/OrcaReplay](https://github.com/Continuum-AI-Corp/OrcaReplay)**: Source for the `orca-replay` skill - reading, replaying, and forking recorded coding-agent runs, so a question about what a past run did is answered from its trace rather than from memory (Apache-2.0).
305
+ - **[Continuum-AI-Corp/OrcaPromptVault](https://github.com/Continuum-AI-Corp/OrcaPromptVault)**: Source for the `system-prompt-lookup` skill - a dated archive of shipped AI products' system prompts and tool schemas, each labelled captured or vendor-reported, so a claim about what an agent was instructed to do is answered from the artifact rather than from memory (AGPL-3.0).
573
306
  - **[amElnagdy/review-skills](https://github.com/amElnagdy/review-skills)**: Source for the `debate-review` and `babysit-pr` skills - two-model debate review of PRs/MRs with inline comments and automated babysitting of review rounds for GitHub, GitLab and Azure DevOps (MIT, docs-only — runtime not bundled).
574
307
  - **[yylo-dev/yylo-skills](https://github.com/yylo-dev/yylo-skills)**: Source for 7 YYLO skills (`ledger-tasks-yylo`, `plan-ledger-tasks-yylo`, `ralph-loop-yylo`, `understand-project-yylo`, `wiki-yylo`, `workflow-yylo`, `artifact-yylo`) - repo-resident Kanban/task ledger, PDR planning, validated single-task execution loop, and wiki/workflow/artifact records with fail-closed Ledger boundaries (MIT, docs-only — `scripts/kanban.sh` runtime not bundled).
575
308
  - **[addyosmani/agent-skills](https://github.com/addyosmani/agent-skills)**: Source for `constraint-driven-development`, `interview-me`, `using-agent-skills` — only names not already in the catalog (22/25 overlap with existing entries) (MIT).
@@ -802,6 +535,55 @@ Key source families include:
802
535
 
803
536
  Catalog dashboard search, filters, shortlist, and discovery were originally contributed by [@zinzied](https://github.com/zinzied) in [#1111](https://github.com/sickn33/agentic-awesome-skills/pull/1111), then repaired and integrated through [#1118](https://github.com/sickn33/agentic-awesome-skills/pull/1118) under the repository's fork-safety policy.
804
537
 
538
+ ## Top Contributors
539
+
540
+ Thanks to everyone who has helped build this project—especially the contributors below.
541
+
542
+ <table>
543
+ <tr>
544
+ <td valign="top" width="50%">
545
+
546
+ ### Most Commits
547
+
548
+ Contributors ranked by the number of commits.
549
+
550
+ | # | Contributor | Commits |
551
+ |---:|---|---:|
552
+ | 1 | <a href="https://github.com/munir-abbasi"><img src="https://github.com/munir-abbasi.png?size=48" width="32" height="32" alt="" /></a> [@munir-abbasi](https://github.com/munir-abbasi) | 34 |
553
+ | 2 | <a href="https://github.com/Mohammad-Faiz-Cloud-Engineer"><img src="https://github.com/Mohammad-Faiz-Cloud-Engineer.png?size=48" width="32" height="32" alt="" /></a> [@Mohammad-Faiz-Cloud-Engineer](https://github.com/Mohammad-Faiz-Cloud-Engineer) | 33 |
554
+ | 3 | <a href="https://github.com/WHOISABHISHEKADHIKARI"><img src="https://github.com/WHOISABHISHEKADHIKARI.png?size=48" width="32" height="32" alt="" /></a> [@WHOISABHISHEKADHIKARI](https://github.com/WHOISABHISHEKADHIKARI) | 24 |
555
+ | 4 | <a href="https://github.com/zinzied"><img src="https://github.com/zinzied.png?size=48" width="32" height="32" alt="" /></a> [@zinzied](https://github.com/zinzied) | 24 |
556
+ | 5 | <a href="https://github.com/Prince-1652"><img src="https://github.com/Prince-1652.png?size=48" width="32" height="32" alt="" /></a> [@Prince-1652](https://github.com/Prince-1652) | 17 |
557
+ | 6 | <a href="https://github.com/ssumanbiswas"><img src="https://github.com/ssumanbiswas.png?size=48" width="32" height="32" alt="" /></a> [@ssumanbiswas](https://github.com/ssumanbiswas) | 15 |
558
+ | 7 | <a href="https://github.com/FrancoStino"><img src="https://github.com/FrancoStino.png?size=48" width="32" height="32" alt="" /></a> [@FrancoStino](https://github.com/FrancoStino) | 13 |
559
+ | 8 | <a href="https://github.com/Champbreed"><img src="https://github.com/Champbreed.png?size=48" width="32" height="32" alt="" /></a> [@Champbreed](https://github.com/Champbreed) | 10 |
560
+ | 9 | <a href="https://github.com/Dokhacgiakhoa"><img src="https://github.com/Dokhacgiakhoa.png?size=48" width="32" height="32" alt="" /></a> [@Dokhacgiakhoa](https://github.com/Dokhacgiakhoa) | 10 |
561
+ | 10 | <a href="https://github.com/sx4im"><img src="https://github.com/sx4im.png?size=48" width="32" height="32" alt="" /></a> [@sx4im](https://github.com/sx4im) | 10 |
562
+
563
+ </td>
564
+ <td valign="top" width="50%">
565
+
566
+ ### Most Skills Added
567
+
568
+ Contributors ranked by the number of skills they added.
569
+
570
+ | # | Contributor | Skills added |
571
+ |---:|---|---:|
572
+ | 1 | <a href="https://github.com/Prince-1652"><img src="https://github.com/Prince-1652.png?size=48" width="32" height="32" alt="" /></a> [@Prince-1652](https://github.com/Prince-1652) | 92 |
573
+ | 2 | <a href="https://github.com/sohamganatra"><img src="https://github.com/sohamganatra.png?size=48" width="32" height="32" alt="" /></a> [@sohamganatra](https://github.com/sohamganatra) | 78 |
574
+ | 3 | <a href="https://github.com/FrancoStino"><img src="https://github.com/FrancoStino.png?size=48" width="32" height="32" alt="" /></a> [@FrancoStino](https://github.com/FrancoStino) | 61 |
575
+ | 4 | <a href="https://github.com/ProgramadorBrasil"><img src="https://github.com/ProgramadorBrasil.png?size=48" width="32" height="32" alt="" /></a> [@ProgramadorBrasil](https://github.com/ProgramadorBrasil) | 52 |
576
+ | 5 | <a href="https://github.com/nikolasdehor"><img src="https://github.com/nikolasdehor.png?size=48" width="32" height="32" alt="" /></a> [@nikolasdehor](https://github.com/nikolasdehor) | 35 |
577
+ | 6 | <a href="https://github.com/RamonRiosJr"><img src="https://github.com/RamonRiosJr.png?size=48" width="32" height="32" alt="" /></a> [@RamonRiosJr](https://github.com/RamonRiosJr) | 26 |
578
+ | 7 | <a href="https://github.com/MMEHDI0606"><img src="https://github.com/MMEHDI0606.png?size=48" width="32" height="32" alt="" /></a> [@MMEHDI0606](https://github.com/MMEHDI0606) | 20 |
579
+ | 8 | <a href="https://github.com/WHOISABHISHEKADHIKARI"><img src="https://github.com/WHOISABHISHEKADHIKARI.png?size=48" width="32" height="32" alt="" /></a> [@WHOISABHISHEKADHIKARI](https://github.com/WHOISABHISHEKADHIKARI) | 19 |
580
+ | 9 | <a href="https://github.com/ar27111994"><img src="https://github.com/ar27111994.png?size=48" width="32" height="32" alt="" /></a> [@ar27111994](https://github.com/ar27111994) | 13 |
581
+ | 10 | <a href="https://github.com/xi-kari"><img src="https://github.com/xi-kari.png?size=48" width="32" height="32" alt="" /></a> [@xi-kari](https://github.com/xi-kari) | 12 |
582
+
583
+ </td>
584
+ </tr>
585
+ </table>
586
+
805
587
  ## Repo Contributors
806
588
 
807
589
  <a href="https://github.com/sickn33/agentic-awesome-skills/graphs/contributors">