agentic-awesome-skills 16.8.0 → 16.9.1

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.
Files changed (84) hide show
  1. package/README.md +44 -28
  2. package/data/aas-v1/catalog-manifest.v1.json +1 -1
  3. package/data/aas-v1/skill-content-index.v1.json +1 -1
  4. package/data/aas-v1/skill-content.v1.ndjson +20 -20
  5. package/data/catalog.json +60 -60
  6. package/data/skills_index.json +7 -7
  7. package/package.json +1 -1
  8. package/skills/antigravity-maintainer-batch-release/SKILL.md +10 -1
  9. package/skills/backend-security-coder/resources/implementation-playbook.md +23 -0
  10. package/skills/business-analyst/resources/implementation-playbook.md +23 -0
  11. package/skills/devops-troubleshooter/resources/implementation-playbook.md +23 -0
  12. package/skills/distributed-tracing/SKILL.md +22 -435
  13. package/skills/distributed-tracing/references/instrumentation.md +13 -0
  14. package/skills/distributed-tracing/references/jaeger-setup.md +13 -0
  15. package/skills/distributed-tracing/resources/implementation-playbook.md +23 -0
  16. package/skills/django-pro/resources/implementation-playbook.md +23 -0
  17. package/skills/embedding-strategies/SKILL.md +40 -64
  18. package/skills/embedding-strategies/resources/implementation-playbook.md +23 -0
  19. package/skills/fastapi-pro/resources/implementation-playbook.md +23 -0
  20. package/skills/find-complementary-founders/scripts/assess_profile.py +7 -1
  21. package/skills/frontend-security-coder/SKILL.md +5 -5
  22. package/skills/frontend-security-coder/resources/implementation-playbook.md +23 -0
  23. package/skills/github-actions-templates/SKILL.md +34 -314
  24. package/skills/github-actions-templates/references/common-workflows.md +13 -0
  25. package/skills/github-actions-templates/resources/implementation-playbook.md +23 -0
  26. package/skills/google-docs-automation/SKILL.md +19 -69
  27. package/skills/google-sheets-automation/SKILL.md +20 -128
  28. package/skills/google-slides-automation/SKILL.md +19 -128
  29. package/skills/grafana-dashboards/SKILL.md +6 -6
  30. package/skills/grafana-dashboards/references/dashboard-design.md +13 -0
  31. package/skills/grafana-dashboards/resources/implementation-playbook.md +23 -0
  32. package/skills/incident-responder/resources/implementation-playbook.md +23 -0
  33. package/skills/instagram/scripts/config.py +33 -8
  34. package/skills/ios-developer/resources/implementation-playbook.md +23 -0
  35. package/skills/junta-leiloeiros/scripts/.snyk +5 -0
  36. package/skills/junta-leiloeiros/scripts/requirements.txt +2 -0
  37. package/skills/kpi-dashboard-design/SKILL.md +7 -67
  38. package/skills/kpi-dashboard-design/resources/implementation-playbook.md +23 -0
  39. package/skills/kpi-dashboard-design/resources/metric-queries.sql +30 -0
  40. package/skills/lint-and-validate/SKILL.md +17 -45
  41. package/skills/lint-and-validate/scripts/lint_runner.py +17 -8
  42. package/skills/lint-and-validate/scripts/type_coverage.py +77 -167
  43. package/skills/mobile-developer/resources/implementation-playbook.md +23 -0
  44. package/skills/multi-platform-apps-multi-platform/resources/implementation-playbook.md +23 -0
  45. package/skills/notebooklm/scripts/config.py +33 -11
  46. package/skills/observability-and-instrumentation/SKILL.md +4 -1
  47. package/skills/observability-and-instrumentation/references/observability-checklist.md +13 -0
  48. package/skills/pci-compliance/SKILL.md +23 -469
  49. package/skills/pci-compliance/resources/implementation-playbook.md +23 -0
  50. package/skills/postmortem-writing/SKILL.md +1 -1
  51. package/skills/postmortem-writing/resources/implementation-playbook.md +23 -0
  52. package/skills/pydantic-models-py/SKILL.md +1 -3
  53. package/skills/secrets-management/SKILL.md +24 -349
  54. package/skills/secrets-management/references/github-secrets.md +13 -0
  55. package/skills/secrets-management/references/vault-setup.md +13 -0
  56. package/skills/security-and-hardening/SKILL.md +8 -6
  57. package/skills/security-and-hardening/references/security-checklist.md +13 -0
  58. package/skills/seo-content-planner/resources/implementation-playbook.md +23 -0
  59. package/skills/seo-content-writer/SKILL.md +2 -2
  60. package/skills/seo-content-writer/resources/implementation-playbook.md +23 -0
  61. package/skills/shopify-development/scripts/.snyk +3 -0
  62. package/skills/slack-gif-creator/.snyk +5 -0
  63. package/skills/slack-gif-creator/requirements.txt +2 -2
  64. package/skills/slo-implementation/SKILL.md +24 -9
  65. package/skills/slo-implementation/references/error-budget.md +13 -0
  66. package/skills/slo-implementation/references/slo-definitions.md +13 -0
  67. package/skills/slo-implementation/resources/implementation-playbook.md +23 -0
  68. package/skills/sql-optimization-patterns/SKILL.md +10 -6
  69. package/skills/sql-optimization-patterns/resources/implementation-playbook.md +52 -56
  70. package/skills/telegram/assets/boilerplate/nodejs/package-lock.json +1888 -0
  71. package/skills/telegram/assets/boilerplate/nodejs/package.json +3 -0
  72. package/skills/vector-database-engineer/resources/implementation-playbook.md +23 -0
  73. package/skills/videodb/scripts/ws_listener.py +8 -1
  74. package/skills/whatsapp-cloud-api/assets/boilerplate/nodejs/package-lock.json +1881 -0
  75. package/skills/whatsapp-cloud-api/assets/boilerplate/nodejs/package.json +3 -0
  76. package/skills/whatsapp-cloud-api/assets/boilerplate/python/.snyk +3 -0
  77. package/skills_index.json +7 -7
  78. package/tools/bin/install.js +36 -6
  79. package/tools/lib/aas-v1/cache/archive.js +13 -4
  80. package/tools/lib/aas-v1/cache/runtime.js +29 -0
  81. package/tools/lib/aas-v1/cli/installation-handoff.js +46 -0
  82. package/tools/lib/aas-v1/cli/main.js +75 -11
  83. package/tools/lib/aas-v1/mcp/server.js +7 -3
  84. package/tools/lib/aas-v1/mcp/stdio.js +32 -8
package/README.md CHANGED
@@ -1,13 +1,13 @@
1
- <!-- registry-sync: version=16.8.0; skills=2113; stars=46013; updated_at=2026-09-05T14:34:40+00:00 -->
1
+ <!-- registry-sync: version=16.9.1; skills=2113; stars=46059; updated_at=2026-09-06T14:45:34+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: V16.8.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
+ **Current release: V16.9.1.** 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.
7
7
 
8
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.
9
9
 
10
- **[Read the AAS Core preview guide →](https://github.com/sickn33/agentic-awesome-skills/blob/v16.8.0/docs/users/aas-core.md)**
10
+ **[Read the AAS Core preview guide →](https://github.com/sickn33/agentic-awesome-skills/blob/v16.9.1/docs/users/aas-core.md)**
11
11
 
12
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
13
 
@@ -42,6 +42,20 @@ This is an independent community project. It is not affiliated with, sponsored b
42
42
  [![OpenCode](https://img.shields.io/badge/OpenCode-CLI-gray?style=for-the-badge)](https://github.com/opencode-ai/opencode)
43
43
  [![Antigravity](https://img.shields.io/badge/Antigravity-AI%20IDE-red?style=for-the-badge)](https://github.com/sickn33/agentic-awesome-skills)
44
44
 
45
+ ## Support the Project
46
+
47
+ **We’re looking for sponsors to support Agentic Awesome Skills.** If you or your company would like to support the project, become a sponsor.
48
+
49
+ ### [♥ Sponsor AAS →](https://github.com/sponsors/sickn33)
50
+
51
+ You can also [support AAS on Buy Me a Coffee](https://buymeacoffee.com/sickn33).
52
+
53
+ <a href="https://buymeacoffee.com/sickn33">
54
+ <img src="assets/buy-me-a-coffee-banner.png" alt="Support Agentic Awesome Skills on Buy Me a Coffee" width="420" />
55
+ </a>
56
+
57
+ *Security tooling support: [Snyk](https://snyk.io/).*
58
+
45
59
  ## AAS Core: Agent-First Preview
46
60
 
47
61
  > **The agent composes. You control. AAS keeps the stack reproducible.**
@@ -69,7 +83,7 @@ AAS Core gives the repository one product model:
69
83
  | Apply and recovery | Experimental, explicit opt-in, outside the supported safety claim |
70
84
  | Semantic suitability certification | Not provided |
71
85
 
72
- Read the [AAS Core guide](https://github.com/sickn33/agentic-awesome-skills/blob/v16.8.0/docs/users/aas-core.md) for the exact trust boundaries, current preview status, Codex/Claude setup model, and CLI lifecycle.
86
+ Read the [AAS Core guide](https://github.com/sickn33/agentic-awesome-skills/blob/v16.9.1/docs/users/aas-core.md) for the exact trust boundaries, current preview status, Codex/Claude setup model, and CLI lifecycle.
73
87
 
74
88
  ## Why This Repo
75
89
 
@@ -89,6 +103,7 @@ Direct file search can find candidate prose, but it leaves the result in the con
89
103
 
90
104
  ## Table of Contents
91
105
 
106
+ - [Support the Project](#support-the-project)
92
107
  - [AAS Core: Agent-First Preview](#aas-core-agent-first-preview)
93
108
  - [Why This Repo](#why-this-repo)
94
109
  - [Installation](#installation)
@@ -99,7 +114,6 @@ Direct file search can find candidate prose, but it leaves the result in the con
99
114
  - [Browse 2,113+ Skills](#browse-2113-skills)
100
115
  - [Troubleshooting](#troubleshooting)
101
116
  - [Stable Skills Manifest v1](#stable-skills-manifest-v1)
102
- - [Support the Project](#support-the-project)
103
117
  - [Contributing](#contributing)
104
118
  - [Community](#community)
105
119
  - [Credits & Sources](#credits--sources)
@@ -109,7 +123,7 @@ Direct file search can find candidate prose, but it leaves the result in the con
109
123
 
110
124
  ## Installation
111
125
 
112
- For Codex and Claude, start with the [AAS Core guide](https://github.com/sickn33/agentic-awesome-skills/blob/v16.8.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.
126
+ For Codex and Claude, start with the [AAS Core guide](https://github.com/sickn33/agentic-awesome-skills/blob/v16.9.1/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.
113
127
 
114
128
  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:
115
129
 
@@ -119,6 +133,8 @@ Use direct installation when your host does not yet have a native AAS Core adapt
119
133
 
120
134
  ### From selection to use
121
135
 
136
+ 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).
137
+
122
138
  1. Describe the project outcome to Codex or Claude with the local AAS MCP configured.
123
139
  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.
124
140
  3. Validate the manifest and review a CLI plan when you need an artifact-based check. Workbench can help inspect the artifacts.
@@ -127,8 +143,8 @@ Use direct installation when your host does not yet have a native AAS Core adapt
127
143
  For example, after reviewing `brainstorming` and `systematic-debugging` for a Codex project, run from that project directory:
128
144
 
129
145
  ```bash
130
- npm exec --yes --ignore-scripts --package=agentic-awesome-skills@16.7.0 -- \
131
- agentic-awesome-skills --release 16.7.0 --path .agents/skills \
146
+ npm exec --yes --ignore-scripts --package=agentic-awesome-skills@16.8.0 -- \
147
+ agentic-awesome-skills --release 16.8.0 --path .agents/skills \
132
148
  --skills brainstorming,systematic-debugging --dry-run
133
149
  ```
134
150
 
@@ -222,7 +238,7 @@ All specialized plugins are generated as Claude Code and Codex plugin bundles. B
222
238
  | AAS Web App Builder | 10 | Frontend and full-stack developers shipping modern web apps. |
223
239
  | AAS Product Design Studio | 10 | Product UI, brand, portfolio, accessibility, and richer visual work. |
224
240
  | AAS Security Engineer | 10 | Authorized security testing, audit, and hardening. |
225
- | AAS Secure App Builder | 10 | Developers who want security embedded while building features. |
241
+ | AAS Secure App Builder | 9 | Developers who want security embedded while building features. |
226
242
  | AAS Documents & Presentations | 9 | Office files, document conversion, decks, and slide workflows. |
227
243
  | AAS Data Analytics | 10 | Product analytics, SQL, dashboards, and experiments. |
228
244
  | AAS Agent & MCP Builder | 10 | Agentic apps, MCP tools, RAG systems, and evaluation loops. |
@@ -280,7 +296,7 @@ The supported path covers complete local catalog search and inspection, agent-ow
280
296
 
281
297
  ### How do I install it?
282
298
 
283
- For AAS Core, follow the [preview guide](https://github.com/sickn33/agentic-awesome-skills/blob/v16.8.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.
299
+ For AAS Core, follow the [preview guide](https://github.com/sickn33/agentic-awesome-skills/blob/v16.9.1/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.
284
300
 
285
301
  For direct skill distribution, use a tool-specific flag such as `--codex`,
286
302
  `--cursor`, `--gemini`, or `--claude` to place skills in the directory your
@@ -396,7 +412,7 @@ Use the root repo as a landing page, then jump into the deeper surface that matc
396
412
  Keep the root README short; use the dedicated docs for recovery and platform-specific guidance.
397
413
 
398
414
  - If you are confused after installation, start with the [Usage Guide](docs/users/usage.md).
399
- - For Core setup, trust boundaries, stack manifests, and preview status, use the [AAS Core guide](https://github.com/sickn33/agentic-awesome-skills/blob/v16.8.0/docs/users/aas-core.md).
415
+ - For Core setup, trust boundaries, stack manifests, and preview status, use the [AAS Core guide](https://github.com/sickn33/agentic-awesome-skills/blob/v16.9.1/docs/users/aas-core.md).
400
416
  - 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.
401
417
  - If you integrate agentic-awesome-skills into a host, read the discovery contract first: [Stable Skills Manifest v1](docs/users/discovery-manifest.md).
402
418
  - For Windows truncation or context crash loops, use [docs/users/windows-truncation-recovery.md](docs/users/windows-truncation-recovery.md).
@@ -407,7 +423,7 @@ Keep the root README short; use the dedicated docs for recovery and platform-spe
407
423
 
408
424
  ## Stable Skills Manifest v1
409
425
 
410
- 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/v16.8.0/docs/users/aas-core.md); custom host integrations can continue using the manifest below.
426
+ 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/v16.9.1/docs/users/aas-core.md); custom host integrations can continue using the manifest below.
411
427
 
412
428
  Host integrations should use:
413
429
 
@@ -417,22 +433,6 @@ Host integrations should use:
417
433
 
418
434
  This keeps discovery stable (`id`, `path`, metadata) while ensuring hosts only load `SKILL.md` for requested `@skill-id` values.
419
435
 
420
- ## Support the Project
421
-
422
- The immediate goal is **€100 per month** to help cover the AI tools used to maintain AAS, review contributions, and keep releases moving. Small recurring contributions add up: 20 people giving €5 per month would cover that goal.
423
-
424
- [Support AAS on Buy Me a Coffee](https://buymeacoffee.com/sickn33) and select **Make this monthly** for recurring support. One-time contributions are welcome too. Support is optional; the project stays free and open-source for everyone.
425
-
426
- [![Buy me a coffee](assets/buy-me-a-coffee-banner.png)](https://buymeacoffee.com/sickn33)
427
-
428
- - [Help maintain AAS on Buy Me a Coffee](https://buymeacoffee.com/sickn33)
429
- - Security tooling support: [Snyk](https://snyk.io/)
430
- - Star the repository
431
- - Open reproducible issues
432
- - Contribute docs, fixes, and skills
433
-
434
- ---
435
-
436
436
  ## Contributing
437
437
 
438
438
  - Add new skills under `skills/<skill-name>/SKILL.md`.
@@ -764,6 +764,22 @@ We officially thank the following contributors for their help in making this rep
764
764
 
765
765
  ## Star History
766
766
 
767
+ <a href="https://www.star-history.com/sickn33/agentic-awesome-skills">
768
+ <picture>
769
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/badge?repo=sickn33/agentic-awesome-skills&amp;type=rank&amp;theme=dark" />
770
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/badge?repo=sickn33/agentic-awesome-skills&amp;type=rank" />
771
+ <img alt="Agentic Awesome Skills global rank on Star History" src="https://api.star-history.com/badge?repo=sickn33/agentic-awesome-skills&amp;type=rank" />
772
+ </picture>
773
+ </a>
774
+
775
+ <a href="https://www.star-history.com/?repos=sickn33%2Fagentic-awesome-skills&amp;type=date&amp;legend=top-left">
776
+ <picture>
777
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=sickn33/agentic-awesome-skills&amp;type=date&amp;theme=dark&amp;legend=top-left" />
778
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=sickn33/agentic-awesome-skills&amp;type=date&amp;legend=top-left" />
779
+ <img alt="GitHub star growth over time for Agentic Awesome Skills" src="https://api.star-history.com/chart?repos=sickn33/agentic-awesome-skills&amp;type=date&amp;legend=top-left" />
780
+ </picture>
781
+ </a>
782
+
767
783
  [View the live Star History chart](https://www.star-history.com/?repos=sickn33%2Fagentic-awesome-skills&type=date&legend=top-left).
768
784
 
769
785
  If Agentic Awesome Skills has been useful, consider ⭐ starring the repo!
@@ -1 +1 @@
1
- {"assets":[{"path":"data/aas-v1/skill-content-index.v1.json","sha256":"sha256-953798665a25f76a16b7c393397f80d606535fc9b2cf986471986c23fd147f2d","size":1398766},{"path":"data/aas-v1/skill-content.v1.ndjson","sha256":"sha256-cc5e4bfe31735d7cb80437b322dd26793de7f24289301cb531e3ab99ba9046a3","size":16134671},{"path":"data/catalog.json","sha256":"sha256-9519b17f2e5d000d9ab6e0e3e20219afe0a77f0b1617276d6eca25e6cb3823e1","size":1757567},{"path":"tools/lib/aas-v1/ontology.v1.json","sha256":"sha256-aaecc6a7e1b5fc7d1f8d5577b797982974aca2642e2d716e05fa2aab6a4fa885","size":7221}],"catalogDigest":"sha256-a7db321f2062a10cd9637a711bfbada92a2249fe162b05e9d6e197879125b6cf","catalogSchemaVersion":"2.0.0","digestVersion":1,"package":"agentic-awesome-skills","packageVersion":"16.8.0","schemaVersion":1,"skillCount":2113}
1
+ {"assets":[{"path":"data/aas-v1/skill-content-index.v1.json","sha256":"sha256-79d4ed2882f0be9e03d1c4682bb099c699f238da24a3012764f36d942733f4ad","size":1404572},{"path":"data/aas-v1/skill-content.v1.ndjson","sha256":"sha256-255d2b13bb57881d9ea1d4ebe6b3b91654ecb96208b548cc04443a01be0f082c","size":16103971},{"path":"data/catalog.json","sha256":"sha256-fe2b81c70c322e7524cbb41cb04a45d732c50b72ab4cdda47004b4edca5e85a2","size":1757647},{"path":"tools/lib/aas-v1/ontology.v1.json","sha256":"sha256-aaecc6a7e1b5fc7d1f8d5577b797982974aca2642e2d716e05fa2aab6a4fa885","size":7221}],"catalogDigest":"sha256-c093b522827764ab5af5d07917ee32ccb863ab5149d7029147ef09a84d362e7c","catalogSchemaVersion":"2.0.0","digestVersion":1,"package":"agentic-awesome-skills","packageVersion":"16.9.1","schemaVersion":1,"skillCount":2113}