agentic-awesome-skills 16.8.0 → 16.9.0

package/README.md

@@ -1,13 +1,13 @@
-<!-- registry-sync: version=16.8.0; skills=2113; stars=46013; updated_at=2026-09-05T14:34:40+00:00 -->
+<!-- registry-sync: version=16.9.0; skills=2113; stars=46043; updated_at=2026-09-06T10:30:08+00:00 -->
 # AAS Core — Agentic Awesome Skills
 
 > **Find reusable instructions for your project, inspect their complete files, and keep an exact skill set you can review and reuse.**
 
-**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.
+**Current release: V16.9.0.** This release includes AAS Core for complete local catalog search, agent-owned selection, manifest validation, planning, and diagnosis. Apply and recovery remain experimental and outside the supported preview path.
 
 Codex or Claude inspects your project and chooses exact skills from the complete local AAS catalog. AAS Core does not rank or recommend them: its read-only `compose_stack` tool validates the agent-owned selection in memory, and a client or the `aas` CLI can persist it as `aas-stack.json` and produce an immutable plan before any target change.
 
-**[Read the AAS Core preview guide →](https://github.com/sickn33/agentic-awesome-skills/blob/v16.8.0/docs/users/aas-core.md)**
+**[Read the AAS Core preview guide →](https://github.com/sickn33/agentic-awesome-skills/blob/v16.9.0/docs/users/aas-core.md)**
 
 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.
 
@@ -69,7 +69,7 @@ AAS Core gives the repository one product model:
 | Apply and recovery | Experimental, explicit opt-in, outside the supported safety claim |
 | Semantic suitability certification | Not provided |
 
-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.
+Read the [AAS Core guide](https://github.com/sickn33/agentic-awesome-skills/blob/v16.9.0/docs/users/aas-core.md) for the exact trust boundaries, current preview status, Codex/Claude setup model, and CLI lifecycle.
 
 ## Why This Repo
 
@@ -109,7 +109,7 @@ Direct file search can find candidate prose, but it leaves the result in the con
 
 ## Installation
 
-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.
+For Codex and Claude, start with the [AAS Core guide](https://github.com/sickn33/agentic-awesome-skills/blob/v16.9.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.
 
 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:
 
@@ -119,6 +119,8 @@ Use direct installation when your host does not yet have a native AAS Core adapt
 
 ### From selection to use
 
+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).
+
 1. Describe the project outcome to Codex or Claude with the local AAS MCP configured.
 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.
 3. Validate the manifest and review a CLI plan when you need an artifact-based check. Workbench can help inspect the artifacts.
@@ -127,8 +129,8 @@ Use direct installation when your host does not yet have a native AAS Core adapt
 For example, after reviewing `brainstorming` and `systematic-debugging` for a Codex project, run from that project directory:
 
 ```bash
-npm exec --yes --ignore-scripts --package=agentic-awesome-skills@16.7.0 -- \
-  agentic-awesome-skills --release 16.7.0 --path .agents/skills \
+npm exec --yes --ignore-scripts --package=agentic-awesome-skills@16.8.0 -- \
+  agentic-awesome-skills --release 16.8.0 --path .agents/skills \
   --skills brainstorming,systematic-debugging --dry-run
 ```
 
@@ -222,7 +224,7 @@ All specialized plugins are generated as Claude Code and Codex plugin bundles. B
 | AAS Web App Builder | 10 | Frontend and full-stack developers shipping modern web apps. |
 | AAS Product Design Studio | 10 | Product UI, brand, portfolio, accessibility, and richer visual work. |
 | AAS Security Engineer | 10 | Authorized security testing, audit, and hardening. |
-| AAS Secure App Builder | 10 | Developers who want security embedded while building features. |
+| AAS Secure App Builder | 9 | Developers who want security embedded while building features. |
 | AAS Documents & Presentations | 9 | Office files, document conversion, decks, and slide workflows. |
 | AAS Data Analytics | 10 | Product analytics, SQL, dashboards, and experiments. |
 | AAS Agent & MCP Builder | 10 | Agentic apps, MCP tools, RAG systems, and evaluation loops. |
@@ -280,7 +282,7 @@ The supported path covers complete local catalog search and inspection, agent-ow
 
 ### How do I install it?
 
-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.
+For AAS Core, follow the [preview guide](https://github.com/sickn33/agentic-awesome-skills/blob/v16.9.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.
 
 For direct skill distribution, use a tool-specific flag such as `--codex`,
 `--cursor`, `--gemini`, or `--claude` to place skills in the directory your
@@ -396,7 +398,7 @@ Use the root repo as a landing page, then jump into the deeper surface that matc
 Keep the root README short; use the dedicated docs for recovery and platform-specific guidance.
 
 - If you are confused after installation, start with the [Usage Guide](docs/users/usage.md).
-- 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).
+- 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.0/docs/users/aas-core.md).
 - On native Windows, `AAS_ADAPTER_WINDOWS_ACL_FAILED` refers to the configuration path checked with PowerShell `Get-Acl`, not the cache and not `icacls`; do not approve until preview returns an approval digest.
 - If you integrate agentic-awesome-skills into a host, read the discovery contract first: [Stable Skills Manifest v1](docs/users/discovery-manifest.md).
 - For Windows truncation or context crash loops, use [docs/users/windows-truncation-recovery.md](docs/users/windows-truncation-recovery.md).
@@ -407,7 +409,7 @@ Keep the root README short; use the dedicated docs for recovery and platform-spe
 
 ## Stable Skills Manifest v1
 
-This is the stable **direct-host discovery manifest** for integrations that load individual `SKILL.md` files. It is not `aas-stack.json`, the verified AAS Core catalog, or the Core composition contract. Core users should start with the [AAS Core guide](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.
+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.0/docs/users/aas-core.md); custom host integrations can continue using the manifest below.
 
 Host integrations should use:
 

package/data/aas-v1/catalog-manifest.v1.json

@@ -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}
+{"assets":[{"path":"data/aas-v1/skill-content-index.v1.json","sha256":"sha256-0abadf4ea16f627bfbf98d2f9da6b4c9ac0d14d637cfb368475a8e2b409260f9","size":1403702},{"path":"data/aas-v1/skill-content.v1.ndjson","sha256":"sha256-255d2b13bb57881d9ea1d4ebe6b3b91654ecb96208b548cc04443a01be0f082c","size":16103971},{"path":"data/catalog.json","sha256":"sha256-80428267683fff24ef2a238ad5c07747783bf49f8139d5a1c817c1345d6203e6","size":1757647},{"path":"tools/lib/aas-v1/ontology.v1.json","sha256":"sha256-aaecc6a7e1b5fc7d1f8d5577b797982974aca2642e2d716e05fa2aab6a4fa885","size":7221}],"catalogDigest":"sha256-07bb571c62e96c8e3d5d673f409982d57f380f18933dc43f791f31dd715fc18e","catalogSchemaVersion":"2.0.0","digestVersion":1,"package":"agentic-awesome-skills","packageVersion":"16.9.0","schemaVersion":1,"skillCount":2113}