opencode-skills-collection 4.0.7 → 4.0.8
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/bundled-skills/.antigravity-install-manifest.json +19 -1
- package/bundled-skills/antigravity-maintainer-batch-release/SKILL.md +15 -6
- package/bundled-skills/docs/integrations/jetski-cortex.md +3 -3
- package/bundled-skills/docs/integrations/jetski-gemini-loader/README.md +1 -1
- package/bundled-skills/docs/maintainers/aas-agent-first-control-plane-preview-profile.md +2 -2
- package/bundled-skills/docs/maintainers/aas-agent-first-control-plane-v1-worklog.md +1 -1
- package/bundled-skills/docs/maintainers/release-process.md +15 -0
- package/bundled-skills/docs/maintainers/repo-growth-seo.md +3 -3
- package/bundled-skills/docs/maintainers/skills-update-guide.md +1 -1
- package/bundled-skills/docs/users/aas-core.md +32 -3
- package/bundled-skills/docs/users/bundles.md +1 -1
- package/bundled-skills/docs/users/claude-code-skills.md +1 -1
- package/bundled-skills/docs/users/gemini-cli-skills.md +1 -1
- package/bundled-skills/docs/users/kiro-integration.md +1 -1
- package/bundled-skills/docs/users/usage.md +4 -4
- package/bundled-skills/docs/users/visual-guide.md +4 -4
- package/bundled-skills/docs/vietnamese/README.vi.md +4 -4
- package/bundled-skills/hf-cloud-aws-context-discovery/SKILL.md +96 -0
- package/bundled-skills/markstream-angular/SKILL.md +76 -0
- package/bundled-skills/markstream-custom-components/SKILL.md +74 -0
- package/bundled-skills/markstream-custom-components/references/patterns.md +14 -0
- package/bundled-skills/markstream-install/SKILL.md +3 -1
- package/bundled-skills/markstream-migration/SKILL.md +78 -0
- package/bundled-skills/markstream-migration/references/adoption-checklist.md +10 -0
- package/bundled-skills/markstream-nuxt/SKILL.md +71 -0
- package/bundled-skills/markstream-react/SKILL.md +74 -0
- package/bundled-skills/markstream-svelte/SKILL.md +68 -0
- package/bundled-skills/markstream-vue/SKILL.md +71 -0
- package/bundled-skills/markstream-vue2/SKILL.md +70 -0
- package/bundled-skills/markstream-vue2-cli/SKILL.md +70 -0
- package/bundled-skills/markstream-vue2-vite/SKILL.md +69 -0
- package/bundled-skills/n8n-agents/SKILL.md +301 -0
- package/bundled-skills/n8n-agents/references/CHAT_AGENT_PATTERNS.md +228 -0
- package/bundled-skills/n8n-agents/references/EXAMPLES.md +432 -0
- package/bundled-skills/n8n-agents/references/HUMAN_REVIEW.md +180 -0
- package/bundled-skills/n8n-agents/references/MEMORY.md +139 -0
- package/bundled-skills/n8n-agents/references/RAG.md +102 -0
- package/bundled-skills/n8n-agents/references/STRUCTURED_OUTPUT.md +163 -0
- package/bundled-skills/n8n-agents/references/SUBWORKFLOW_AS_TOOL.md +199 -0
- package/bundled-skills/n8n-agents/references/SYSTEM_PROMPT.md +151 -0
- package/bundled-skills/n8n-agents/references/TOOLS.md +199 -0
- package/bundled-skills/n8n-binary-and-data/SKILL.md +269 -0
- package/bundled-skills/n8n-binary-and-data/references/AGENT_TOOL_BINARY.md +227 -0
- package/bundled-skills/n8n-binary-and-data/references/BINARY_BASICS.md +187 -0
- package/bundled-skills/n8n-binary-and-data/references/CDN_REQUIREMENT.md +109 -0
- package/bundled-skills/n8n-binary-and-data/references/MERGE_FOR_CONTEXT.md +130 -0
- package/bundled-skills/n8n-code-tool/SKILL.md +358 -0
- package/bundled-skills/n8n-code-tool/references/ERROR_PATTERNS.md +178 -0
- package/bundled-skills/n8n-code-tool/references/INPUT_SCHEMA.md +132 -0
- package/bundled-skills/n8n-error-handling/SKILL.md +289 -0
- package/bundled-skills/n8n-error-handling/references/API_WORKFLOWS.md +256 -0
- package/bundled-skills/n8n-error-handling/references/ERROR_WORKFLOWS.md +178 -0
- package/bundled-skills/n8n-error-handling/references/NODE_ERROR_OUTPUTS.md +171 -0
- package/bundled-skills/n8n-error-handling/references/RESPONSE_SHAPES.md +220 -0
- package/bundled-skills/n8n-multi-instance/SKILL.md +208 -0
- package/bundled-skills/n8n-node-configuration/references/NODE_FAMILY_GOTCHAS.md +241 -0
- package/bundled-skills/n8n-subworkflows/SKILL.md +271 -0
- package/bundled-skills/n8n-subworkflows/references/NAMING_AND_DISCOVERY.md +130 -0
- package/bundled-skills/n8n-subworkflows/references/SUBWORKFLOW_PATTERNS.md +147 -0
- package/bundled-skills/using-n8n-mcp-skills/SKILL.md +193 -0
- package/package.json +1 -1
- package/skills_index.json +547 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 1,
|
|
3
|
-
"updatedAt": "2026-07-
|
|
3
|
+
"updatedAt": "2026-07-22T01:22:01.835Z",
|
|
4
4
|
"entries": [
|
|
5
5
|
"00-andruia-consultant",
|
|
6
6
|
"007",
|
|
@@ -931,6 +931,7 @@
|
|
|
931
931
|
"helium-mcp",
|
|
932
932
|
"helm-chart-scaffolding",
|
|
933
933
|
"helpdesk-automation",
|
|
934
|
+
"hf-cloud-aws-context-discovery",
|
|
934
935
|
"hf-mcp",
|
|
935
936
|
"hf-mem",
|
|
936
937
|
"hierarchical-agent-memory",
|
|
@@ -1162,7 +1163,17 @@
|
|
|
1162
1163
|
"marketing-ideas",
|
|
1163
1164
|
"marketing-plan",
|
|
1164
1165
|
"marketing-psychology",
|
|
1166
|
+
"markstream-angular",
|
|
1167
|
+
"markstream-custom-components",
|
|
1165
1168
|
"markstream-install",
|
|
1169
|
+
"markstream-migration",
|
|
1170
|
+
"markstream-nuxt",
|
|
1171
|
+
"markstream-react",
|
|
1172
|
+
"markstream-svelte",
|
|
1173
|
+
"markstream-vue",
|
|
1174
|
+
"markstream-vue2",
|
|
1175
|
+
"markstream-vue2-cli",
|
|
1176
|
+
"markstream-vue2-vite",
|
|
1166
1177
|
"matematico-tao",
|
|
1167
1178
|
"mathguard",
|
|
1168
1179
|
"matplotlib",
|
|
@@ -1229,11 +1240,17 @@
|
|
|
1229
1240
|
"multi-agent-task-orchestrator",
|
|
1230
1241
|
"multi-cloud-architecture",
|
|
1231
1242
|
"multi-platform-apps-multi-platform",
|
|
1243
|
+
"n8n-agents",
|
|
1244
|
+
"n8n-binary-and-data",
|
|
1232
1245
|
"n8n-code-javascript",
|
|
1233
1246
|
"n8n-code-python",
|
|
1247
|
+
"n8n-code-tool",
|
|
1248
|
+
"n8n-error-handling",
|
|
1234
1249
|
"n8n-expression-syntax",
|
|
1235
1250
|
"n8n-mcp-tools-expert",
|
|
1251
|
+
"n8n-multi-instance",
|
|
1236
1252
|
"n8n-node-configuration",
|
|
1253
|
+
"n8n-subworkflows",
|
|
1237
1254
|
"n8n-validation-expert",
|
|
1238
1255
|
"n8n-workflow-patterns",
|
|
1239
1256
|
"nanobanana-ppt-skills",
|
|
@@ -1851,6 +1868,7 @@
|
|
|
1851
1868
|
"use-dom",
|
|
1852
1869
|
"user-thoughts",
|
|
1853
1870
|
"using-git-worktrees",
|
|
1871
|
+
"using-n8n-mcp-skills",
|
|
1854
1872
|
"using-neon",
|
|
1855
1873
|
"using-superpowers",
|
|
1856
1874
|
"uv-package-manager",
|
|
@@ -106,12 +106,21 @@ For AAS CLI, MCP, stack, catalog-cache, or Workbench changes:
|
|
|
106
106
|
|
|
107
107
|
Release only when requested.
|
|
108
108
|
|
|
109
|
+
Every stable or prerelease version requires full release alignment. Creating the tag, GitHub Release, or npm package is an intermediate milestone, never the completion condition.
|
|
110
|
+
|
|
109
111
|
1. Include the target changelog entry in the maintainer batch PR so it is already on protected `main`; avoid a separate release-notes-only PR.
|
|
110
112
|
2. From clean, current `main`, run `npm run release:preflight` and required security checks.
|
|
111
|
-
3. Run `npm run release:
|
|
112
|
-
4.
|
|
113
|
-
5.
|
|
114
|
-
6.
|
|
113
|
+
3. Run the release-state generator and its explicit plugin gates. Require a second no-drift pass before publication: `npm run sync:release-state`, `npm run plugin-compat:check`, and `npm run bundles:check` must leave a clean tree. Inspect `package.json`, `package-lock.json`, generated registries and the offline catalog, tracked web assets, `.agents/plugins/marketplace.json`, `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json`, and every published Codex/Claude plugin mirror and editorial-bundle manifest. Every release-owned manifest version must equal `X.Y.Z`.
|
|
114
|
+
4. Run `npm run release:prepare -- X.Y.Z`. This creates and pushes `release/vX.Y.Z` and opens the protected release PR.
|
|
115
|
+
5. Merge that release PR through its required checks, update local `main` to equal `origin/main`, and wait for every source, release, or canonical-sync PR in the release path to close. Re-run the release-state and plugin gates if protected `main` moved.
|
|
116
|
+
6. Run `npm run release:publish -- X.Y.Z`. It verifies the exact protected merge before creating or reusing the tag and GitHub Release.
|
|
117
|
+
7. Wait for publishing workflows, then bind every proof to the exact released commit: verify the tag/ref, GitHub Release, npm version and intended dist-tag, required CI, CodeQL, and the explicitly dispatched release-only Pages build. Verify live `llms.txt`, `skills.json`, catalog and plugin routes, and the legacy redirect bridge; do not accept a successful run for a different SHA.
|
|
118
|
+
8. After npm confirms `X.Y.Z` as the published dist-tag, discover every already-configured local AAS MCP host from its real configuration and update each one to the exact same package version before declaring the release complete. Updating existing AAS host entries is part of the release; creating a previously absent host configuration still requires explicit authorization.
|
|
119
|
+
- Use the published package's `aas mcp configure` two-pass flow: first preview the change, then repeat the identical command with its approval digest. Supply absolute host-config, cache, and backup paths; require a backup when replacing an existing configuration.
|
|
120
|
+
- Pin `agentic-awesome-skills@X.Y.Z` and `--version X.Y.Z`; never use `latest`, reuse an older cached runtime, or create a previously absent host configuration without explicit authorization.
|
|
121
|
+
- Verify that the managed host configuration points to a content-addressed `X.Y.Z` runtime, that the runtime package metadata reports `X.Y.Z`, and that a real MCP `initialize` plus `tools/list` handshake reports catalog package version `X.Y.Z`.
|
|
122
|
+
- Restart the host or open a fresh client session when required so the new MCP process is actually loaded. If configuration access, approval, or runtime verification is blocked, report the exact blocker and keep the maintainer task incomplete even though the package itself is already public.
|
|
123
|
+
9. Fetch `origin/main` again after automation settles, fast-forward the maintainer checkout, and repeat the release-state, plugin, version, public-surface, and MCP parity checks. The final generator pass must be idempotent, the tree must stay clean, and `git rev-list --left-right --count main...origin/main` must end at `0 0`.
|
|
115
124
|
|
|
116
125
|
Never rebase a published release tag, force stale release state, reuse a failed published version, or claim npm publication from the GitHub Release alone.
|
|
117
126
|
|
|
@@ -121,10 +130,10 @@ Finish only when:
|
|
|
121
130
|
|
|
122
131
|
- every in-scope PR, issue, and alert is resolved or has one exact blocker;
|
|
123
132
|
- no open source or canonical-sync PR remains unintentionally;
|
|
124
|
-
- `main`, `origin/main`,
|
|
133
|
+
- for every stable or prerelease version, clean local `main`, `origin/main`, the released commit, canonical generated state, every Codex/Claude plugin mirror, bundle, manifest, marketplace, compatibility report, tag, GitHub Release, npm dist-tag, required workflow, and live public surface agree exactly;
|
|
125
134
|
- the source and legacy repositories have no unintended infrastructure PR, their protected branches and Actions settings remain enforced, and the live manifest identifies the source repository;
|
|
126
135
|
- the user worktree is unchanged except for files the user explicitly placed in scope;
|
|
127
|
-
- release proof is complete when a release was requested.
|
|
136
|
+
- release proof is complete when a release was requested, including an idempotent no-drift regeneration and exact runtime parity between the published npm package and every already-configured local AAS MCP host. Any mismatch keeps the release incomplete.
|
|
128
137
|
|
|
129
138
|
## Failure Rules
|
|
130
139
|
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Jetski/Cortex + Gemini Integration Guide
|
|
3
|
-
description: "Use agentic-awesome-skills with Jetski/Cortex without hitting context-window overflow with 1,
|
|
3
|
+
description: "Use agentic-awesome-skills with Jetski/Cortex without hitting context-window overflow with 1,987+ skills."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Jetski/Cortex + Gemini: safe integration with 1,
|
|
6
|
+
# Jetski/Cortex + Gemini: safe integration with 1,987+ skills
|
|
7
7
|
|
|
8
8
|
> **Custom-host integration:** This guide documents a low-level, direct-manifest lazy loader for Jetski/Cortex and similar hosts. For Codex or Claude Code, the recommended path is [AAS Core](../users/aas-core.md), which provides neutral, deterministic catalog retrieval and validates exact agent-selected IDs through a bounded, read-only MCP server.
|
|
9
9
|
|
|
@@ -25,7 +25,7 @@ Never do:
|
|
|
25
25
|
- concatenate all `SKILL.md` content into a single system prompt;
|
|
26
26
|
- re-inject the entire library for **every** request.
|
|
27
27
|
|
|
28
|
-
With 1,
|
|
28
|
+
With 1,987+ skills, this approach fills the context window before user messages are even added, causing truncation.
|
|
29
29
|
|
|
30
30
|
---
|
|
31
31
|
|
|
@@ -23,7 +23,7 @@ This example shows one way to integrate **agentic-awesome-skills** with a Jetski
|
|
|
23
23
|
- How to enforce a **maximum number of skills per turn** via `maxSkillsPerTurn`.
|
|
24
24
|
- How to choose whether to **truncate or error** when too many skills are requested via `overflowBehavior`.
|
|
25
25
|
|
|
26
|
-
This pattern avoids context overflow when you have 1,
|
|
26
|
+
This pattern avoids context overflow when you have 1,987+ skills installed.
|
|
27
27
|
|
|
28
28
|
Manifest contract references:
|
|
29
29
|
|
|
@@ -13,7 +13,7 @@ The earlier deterministic recommendation design and goal documents are retained
|
|
|
13
13
|
|
|
14
14
|
## Supported surfaces
|
|
15
15
|
|
|
16
|
-
- A complete, integrity-verified local catalog in which every canonical skill is searchable, readable,
|
|
16
|
+
- A complete, integrity-verified local catalog in which every canonical skill is searchable, readable, and available for agent selection.
|
|
17
17
|
- Local stdio MCP tools `search_skills`, `get_skill`, `compose_stack`, `inspect_stack`, and `diff_stack`, plus `aas://skills/{id}`.
|
|
18
18
|
- Minimal, schema-validated `aas-stack.json` with pinned catalog identity, targets, goals, and exact agent-selected skill IDs.
|
|
19
19
|
- CLI manifest validation, immutable plan preview, and read-only diagnosis.
|
|
@@ -23,7 +23,7 @@ The earlier deterministic recommendation design and goal documents are retained
|
|
|
23
23
|
|
|
24
24
|
1. The coding agent owns semantic selection. It may inspect the project with its normal local capabilities, search broadly, read full skill content when useful, compare alternatives, and choose exact IDs.
|
|
25
25
|
2. AAS Core does not rank, recommend, promote, demote, exclude, or abstain on skills.
|
|
26
|
-
3. Catalog metadata is informational only. Missing, incomplete, cautionary, or manually reviewed metadata must never make a canonical skill unsearchable
|
|
26
|
+
3. Catalog metadata is informational only. Missing, incomplete, cautionary, or manually reviewed metadata must never make a canonical skill unsearchable or unavailable for agent selection.
|
|
27
27
|
4. `compose_stack` validates catalog identity, target shape, goals, exact IDs, and structural limits, then returns the pinned stack shape. It does not substitute a different selection.
|
|
28
28
|
5. `aas-stack.json` has no Core selection policy. User constraints can guide the agent's reasoning, but they are not an MCP eligibility filter or manifest gate.
|
|
29
29
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# AAS Agent-First Control Plane v1 Worklog
|
|
2
2
|
|
|
3
|
-
- 2026-07-19: Semantic skill selection moved to Codex and Claude. Core now exposes the complete catalog and validates/pins exact agent-selected IDs through `compose_stack`; selection policy and metadata eligibility gates were retired. Every canonical skill must remain searchable, readable,
|
|
3
|
+
- 2026-07-19: Semantic skill selection moved to Codex and Claude. Core now exposes the complete catalog and validates/pins exact agent-selected IDs through `compose_stack`; selection policy and metadata eligibility gates were retired. Every canonical skill must remain searchable, readable, and available for agent selection. Earlier recommendation entries below are historical.
|
|
4
4
|
|
|
5
5
|
## 2026-07-18 — Baseline workflow retired
|
|
6
6
|
|
|
@@ -60,7 +60,9 @@ This command:
|
|
|
60
60
|
- checks `CHANGELOG.md` for `X.Y.Z`
|
|
61
61
|
- aligns `package.json` / `package-lock.json`
|
|
62
62
|
- runs the full release suite
|
|
63
|
+
- explicitly proves `plugin-compat:check` and `bundles:check` after regeneration
|
|
63
64
|
- refreshes release metadata in `README.md`
|
|
65
|
+
- regenerates canonical registries, tracked web assets, both plugin marketplaces, every Codex/Claude mirror and editorial bundle, and every release-owned plugin manifest
|
|
64
66
|
- stages canonical release files
|
|
65
67
|
- creates and pushes `release/vX.Y.Z`
|
|
66
68
|
- opens a release PR containing the scripted canonical release state
|
|
@@ -89,6 +91,19 @@ npm view agentic-awesome-skills dist-tags --json
|
|
|
89
91
|
|
|
90
92
|
The workflow reruns `sync:release-state`, installs Python dependencies from `tools/requirements.txt`, refreshes tracked web assets, fails on canonical drift via `git diff --exit-code`, executes tests and docs security checks, runs the web-app coverage gate, enforces `npm audit --audit-level=high`, builds the web app, and dry-runs the npm package before publishing.
|
|
91
93
|
|
|
94
|
+
8. Complete the mandatory full-release-alignment gate.
|
|
95
|
+
|
|
96
|
+
A stable or prerelease version is not complete when only its tag, GitHub Release, or npm package exists. After publication:
|
|
97
|
+
|
|
98
|
+
- rerun `npm run sync:release-state`, `npm run plugin-compat:check`, and `npm run bundles:check`, then require an idempotent second pass and a clean tree;
|
|
99
|
+
- verify every release-owned Codex/Claude plugin manifest and Claude marketplace entry equals `X.Y.Z`, without treating nested third-party skill manifests as AAS release manifests;
|
|
100
|
+
- bind local and remote `main`, the tag, GitHub Release, npm version and intended dist-tag, required CI, CodeQL, and the explicitly dispatched release-only Pages deployment to the exact released commit;
|
|
101
|
+
- read back live `llms.txt`, `skills.json`, catalog/plugin routes, and the legacy redirect bridge;
|
|
102
|
+
- discover every already-configured local AAS MCP host from real configuration, update each existing entry with the digest-bound two-pass `aas mcp configure` flow, pin `agentic-awesome-skills@X.Y.Z` and `--version X.Y.Z`, preserve a backup, restart or reconnect the host, and prove a real `initialize` plus `tools/list` handshake reports `X.Y.Z`;
|
|
103
|
+
- fetch and fast-forward `main` again after automation settles, require `git rev-list --left-right --count main...origin/main` to return `0 0`, and repeat the no-drift, public-surface, and MCP parity checks.
|
|
104
|
+
|
|
105
|
+
A release request covers updates to existing AAS MCP host entries only. Creating a previously absent host configuration still needs separate authorization. Any mismatch, inaccessible configured host, or stale public surface keeps the release incomplete.
|
|
106
|
+
|
|
92
107
|
## Canonical Sync Bot
|
|
93
108
|
|
|
94
109
|
`main` still uses the repository's auto-sync model for canonical generated artifacts, but through a protected pull-request contract:
|
|
@@ -6,7 +6,7 @@ This document keeps the repository's GitHub-facing discovery copy aligned with t
|
|
|
6
6
|
|
|
7
7
|
Preferred positioning:
|
|
8
8
|
|
|
9
|
-
> AAS Core is the local, deterministic boundary that exposes the complete catalog, validates exact skill IDs selected by the coding agent from an explicit project profile, and produces an immutable preview plan, backed by
|
|
9
|
+
> AAS Core is the local, deterministic boundary that exposes the complete catalog, validates exact skill IDs selected by the coding agent from an explicit project profile, and produces an immutable preview plan, backed by the current catalog.
|
|
10
10
|
|
|
11
11
|
Key framing:
|
|
12
12
|
|
|
@@ -20,7 +20,7 @@ Key framing:
|
|
|
20
20
|
|
|
21
21
|
Preferred description:
|
|
22
22
|
|
|
23
|
-
> Local, deterministic AAS Core for explainable coding-agent skill stacks, backed by
|
|
23
|
+
> Local, deterministic AAS Core for explainable coding-agent skill stacks, backed by the current catalog. Includes a read-only MCP, stack CLI, Workbench review, plugins, bundles, workflows, and direct distribution.
|
|
24
24
|
|
|
25
25
|
Preferred homepage:
|
|
26
26
|
|
|
@@ -29,7 +29,7 @@ Preferred homepage:
|
|
|
29
29
|
Preferred social preview:
|
|
30
30
|
|
|
31
31
|
- lead with `AAS Core` and the profile → stack → plan flow;
|
|
32
|
-
- present `1,
|
|
32
|
+
- present `1,987+ Agentic Skills` as supporting catalog evidence, not a second product;
|
|
33
33
|
- mention Codex and Claude as the current Core agent path, with broader host compatibility as distribution support;
|
|
34
34
|
- avoid dense text and tiny logos that disappear in social cards.
|
|
35
35
|
|
|
@@ -72,7 +72,7 @@ The update process refreshes:
|
|
|
72
72
|
- Canonical skills index (`skills_index.json`)
|
|
73
73
|
- Compatibility mirror (`data/skills_index.json`)
|
|
74
74
|
- Web app skills data (`apps\web-app\public\skills.json`)
|
|
75
|
-
- All 1,
|
|
75
|
+
- All 1,987+ skills from the skills directory
|
|
76
76
|
|
|
77
77
|
## When to Update
|
|
78
78
|
|
|
@@ -20,14 +20,17 @@ your project
|
|
|
20
20
|
-> aas stack plan (preview; no skill changes)
|
|
21
21
|
```
|
|
22
22
|
|
|
23
|
-
AAS MCP does not scan the repository and does not decide which skills are best. Codex or Claude uses its own project understanding and judgment.
|
|
23
|
+
AAS MCP does not scan the repository and does not decide which skills are best. Codex or Claude uses its own project understanding and judgment. Every current catalog skill remains individually searchable, readable, and available for agent selection; missing or incomplete metadata never makes a skill ineligible. Core has no semantic policy that favors a small stack, while every stack manifest has an explicit technical maximum of 128 skills.
|
|
24
|
+
|
|
25
|
+
> [!IMPORTANT]
|
|
26
|
+
> Structural and identity validity does not certify semantic fit, compatibility, setup correctness, operational safety, or safety to apply.
|
|
24
27
|
|
|
25
28
|
## Configure the local MCP
|
|
26
29
|
|
|
27
30
|
> **Release boundary:** AAS Core landed after release 14.6.0. Use an exact Core-capable release rather than an unreviewed moving tag.
|
|
28
31
|
|
|
29
32
|
```bash
|
|
30
|
-
npm exec --yes --ignore-scripts --package=agentic-awesome-skills@
|
|
33
|
+
npm exec --yes --ignore-scripts --package=agentic-awesome-skills@15.2.0 -- aas mcp configure \
|
|
31
34
|
--host codex \
|
|
32
35
|
--scope user \
|
|
33
36
|
--config /absolute/path/to/codex/config.toml \
|
|
@@ -42,6 +45,15 @@ Use `--host claude` with the appropriate absolute Claude MCP configuration path
|
|
|
42
45
|
|
|
43
46
|
Configuration is explicit and integrity-bound. AAS installs or reuses an exact content-addressed runtime, verifies it, and changes only its managed MCP configuration section. Restart the host if it does not reload MCP configuration automatically.
|
|
44
47
|
|
|
48
|
+
## Quick path
|
|
49
|
+
|
|
50
|
+
1. Run the exact-version MCP configuration command above, review its approval digest, and repeat it with `--approve <approval-digest>`.
|
|
51
|
+
2. Give Codex or Claude the project outcome, target, constraints, and the selection prompt below.
|
|
52
|
+
3. Let the agent search and inspect candidates, choose exact IDs, and call `compose_stack`; review the returned manifest before persisting it.
|
|
53
|
+
4. Persist the selection as `aas-stack.json`, optionally with the separate evidence sidecar for an audit-enabled flow.
|
|
54
|
+
5. Run `aas stack validate`, then `aas stack plan` with explicit absolute paths and integrity inputs.
|
|
55
|
+
6. Review the immutable plan and stop. Apply and recovery remain experimental opt-in paths.
|
|
56
|
+
|
|
45
57
|
## Ask the agent to choose the stack
|
|
46
58
|
|
|
47
59
|
Give the agent the desired outcome and constraints, and leave selection judgment with the agent:
|
|
@@ -163,7 +175,7 @@ Stop after reviewing the plan unless you are deliberately participating in contr
|
|
|
163
175
|
- MCP is local stdio, process-per-session, read-only, offline-capable, and contains no model credentials or telemetry.
|
|
164
176
|
- Codex or Claude owns semantic selection. Different agents or project observations may reasonably produce different stacks.
|
|
165
177
|
- Catalog integrity and manifest validation are deterministic; skill suitability is an agent judgment, not a Core score.
|
|
166
|
-
- Core does not impose a semantic skill-count target. The technical manifest maximum is 128 skills, and every
|
|
178
|
+
- Core does not impose a semantic skill-count target. The technical manifest maximum is 128 skills, and every current catalog skill remains individually searchable, readable, and available for agent selection. Metadata remains visible but informational.
|
|
167
179
|
- Evidence exports include raw `search_skills` queries; keep secrets and sensitive project content out of those queries.
|
|
168
180
|
- Catalog updates and runtime changes are explicit. There is no resident daemon or implicit auto-update.
|
|
169
181
|
- Skill prose is untrusted content and does not gain instruction authority by being returned through MCP.
|
|
@@ -172,6 +184,23 @@ Stop after reviewing the plan unless you are deliberately participating in contr
|
|
|
172
184
|
|
|
173
185
|
Direct installs, specialized plugins, bundles, workflows, and the legacy installer remain available. These surfaces distribute or curate catalog content; AAS Core adds complete local access, durable agent-owned selection, manifest validation, and a reviewable plan.
|
|
174
186
|
|
|
187
|
+
## Current preview status
|
|
188
|
+
|
|
189
|
+
| Surface | Current status |
|
|
190
|
+
| --- | --- |
|
|
191
|
+
| Published package | Current npm release; AAS Core status is `agent-first-preview` |
|
|
192
|
+
| Catalog search and inspection | Supported preview; local and read-only |
|
|
193
|
+
| Agent-owned composition | Supported preview; Core validates IDs and structure, not semantic suitability |
|
|
194
|
+
| Stack validation and plan preview | Supported preview; no target skill changes |
|
|
195
|
+
| Workbench | Browser-local review of stack and plan artifacts |
|
|
196
|
+
| Selection evidence | Exported and inspected through MCP/CLI contracts; not yet reviewed in Workbench |
|
|
197
|
+
| Apply and recovery | Experimental, explicit opt-in, outside the supported safety claim |
|
|
198
|
+
| Semantic suitability certification | Not provided |
|
|
199
|
+
|
|
200
|
+
## Why not just search the skills directory?
|
|
201
|
+
|
|
202
|
+
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.
|
|
203
|
+
|
|
175
204
|
## Next reads
|
|
176
205
|
|
|
177
206
|
- [Getting Started](getting-started.md)
|
|
@@ -17,7 +17,7 @@ Configure AAS Core for Claude Code, describe the task and constraints, let Claud
|
|
|
17
17
|
- It lets Claude search the verified local catalog without loading the full library into context.
|
|
18
18
|
- It preserves Claude's exact selection without using metadata as an eligibility gate.
|
|
19
19
|
- It keeps MCP discovery read-only and CLI changes approval-gated.
|
|
20
|
-
- It includes 1,
|
|
20
|
+
- It includes 1,987+ skills instead of a narrow single-domain starter pack.
|
|
21
21
|
- It supports the standard `.claude/skills/` path and the Claude Code plugin marketplace flow.
|
|
22
22
|
- It also ships generated bundle plugins so teams can install focused packs like `Essentials` or `Security Developer` from the marketplace metadata.
|
|
23
23
|
- It includes onboarding docs, bundles, and workflows so new users do not need to guess where to begin.
|
|
@@ -12,7 +12,7 @@ Install into the Gemini skills path, then ask Gemini to apply one skill at a tim
|
|
|
12
12
|
|
|
13
13
|
- It installs directly into the expected Gemini skills path.
|
|
14
14
|
- It includes both core software engineering skills and deeper agent/LLM-oriented skills.
|
|
15
|
-
- It helps new users get started with bundles and workflows rather than forcing a cold start from 1,
|
|
15
|
+
- It helps new users get started with bundles and workflows rather than forcing a cold start from 1,987+ files.
|
|
16
16
|
- It is useful whether you want a broad internal skill library or a single repo to test many workflows quickly.
|
|
17
17
|
|
|
18
18
|
## Install Gemini CLI Skills
|
|
@@ -18,7 +18,7 @@ Kiro is AWS's agentic AI IDE that combines:
|
|
|
18
18
|
|
|
19
19
|
Kiro's agentic capabilities are enhanced by skills that provide:
|
|
20
20
|
|
|
21
|
-
- **Domain expertise** across 1,
|
|
21
|
+
- **Domain expertise** across 1,987+ specialized areas
|
|
22
22
|
- **Best practices** from Anthropic, OpenAI, Google, Microsoft, and AWS
|
|
23
23
|
- **Workflow automation** for common development tasks
|
|
24
24
|
- **AWS-specific patterns** for serverless, infrastructure, and cloud architecture
|
|
@@ -21,7 +21,7 @@ use compose_stack with a project profile, inspect the schema 2 manifest returned
|
|
|
21
21
|
in memory, and do not apply it.
|
|
22
22
|
```
|
|
23
23
|
|
|
24
|
-
The agent must use `search_skills` and `get_skill` across the complete catalog, build a capability-to-skill coverage map, continue searching while a primary capability remains uncovered, choose the exact IDs itself, call `compose_stack`, then check the in-memory proposal with `inspect_stack` before presenting it.
|
|
24
|
+
The agent must use `search_skills` and `get_skill` across the complete catalog, build a capability-to-skill coverage map, continue searching while a primary capability remains uncovered, choose the exact IDs itself, call `compose_stack`, then check the in-memory proposal with `inspect_stack` before presenting it. Every current catalog skill remains individually searchable, readable, and selectable. A client or the CLI can persist the reviewed `aas-stack.json`; an audit-enabled flow can then call `export_selection_evidence`, validate it with `inspect_selection_evidence`, and atomically publish the manifest and separate `aas-selection-evidence.json` sidecar in an `artifact-dir`. Use `aas stack plan` to preview the exact operations without materializing skills or managed state in the target.
|
|
25
25
|
|
|
26
26
|
Selection evidence contains the raw `search_skills` queries observed during the MCP session. Do not place secrets, credentials, private source text, or personal data in catalog queries.
|
|
27
27
|
|
|
@@ -39,7 +39,7 @@ If you came in through a **Claude Code** or **Codex** plugin instead of AAS Core
|
|
|
39
39
|
|
|
40
40
|
When you ran `npx agentic-awesome-skills` or cloned the repository, you:
|
|
41
41
|
|
|
42
|
-
✅ **Downloaded 1,
|
|
42
|
+
✅ **Downloaded 1,987+ skill files** to your computer (default: `~/.agents/skills/`; or a custom path like `~/.agent/skills/` if you used `--path`)
|
|
43
43
|
✅ **Made them available** to your AI assistant
|
|
44
44
|
❌ **Did NOT enable them all automatically** (they're just sitting there, waiting)
|
|
45
45
|
|
|
@@ -231,7 +231,7 @@ Let's actually use a skill right now. Follow these steps:
|
|
|
231
231
|
|
|
232
232
|
## Direct-install Step 5: Pick Skills Manually
|
|
233
233
|
|
|
234
|
-
Don't try to use all 1,
|
|
234
|
+
Don't try to use all 1,987+ skills at once. Here's a sensible approach:
|
|
235
235
|
|
|
236
236
|
If you want a tool-specific starting point before choosing skills, use:
|
|
237
237
|
|
|
@@ -362,7 +362,7 @@ Usually no, but if your AI doesn't recognize a skill:
|
|
|
362
362
|
|
|
363
363
|
### "Can I load all skills into the model at once?"
|
|
364
364
|
|
|
365
|
-
No. Even though you have 1,
|
|
365
|
+
No. Even though you have 1,987+ skills installed locally, you should **not** concatenate every `SKILL.md` into a single system prompt or context block.
|
|
366
366
|
|
|
367
367
|
The intended pattern is:
|
|
368
368
|
|
|
@@ -40,7 +40,7 @@ agentic-awesome-skills/
|
|
|
40
40
|
├── 📄 CONTRIBUTING.md ← Contributor workflow
|
|
41
41
|
├── 📄 CATALOG.md ← Full generated catalog
|
|
42
42
|
│
|
|
43
|
-
├── 📁 skills/ ← 1,
|
|
43
|
+
├── 📁 skills/ ← 1,987+ skills live here
|
|
44
44
|
│ │
|
|
45
45
|
│ ├── 📁 brainstorming/
|
|
46
46
|
│ │ └── 📄 SKILL.md ← Skill definition
|
|
@@ -53,7 +53,7 @@ agentic-awesome-skills/
|
|
|
53
53
|
│ │ └── 📁 2d-games/
|
|
54
54
|
│ │ └── 📄 SKILL.md ← Nested skills also supported
|
|
55
55
|
│ │
|
|
56
|
-
│ └── ... (1,
|
|
56
|
+
│ └── ... (1,987+ total)
|
|
57
57
|
│
|
|
58
58
|
├── 📁 apps/
|
|
59
59
|
│ └── 📁 web-app/ ← Interactive browser
|
|
@@ -106,7 +106,7 @@ agentic-awesome-skills/
|
|
|
106
106
|
|
|
107
107
|
```
|
|
108
108
|
┌─────────────────────────┐
|
|
109
|
-
│ 1,
|
|
109
|
+
│ 1,987+ SKILLS │
|
|
110
110
|
└────────────┬────────────┘
|
|
111
111
|
│
|
|
112
112
|
┌────────────────────────┼────────────────────────┐
|
|
@@ -207,7 +207,7 @@ If you want a workspace-style manual install instead, cloning into `.agent/skill
|
|
|
207
207
|
│ ├── 📁 brainstorming/ │
|
|
208
208
|
│ ├── 📁 stripe-integration/ │
|
|
209
209
|
│ ├── 📁 react-best-practices/ │
|
|
210
|
-
│ └── ... (1,
|
|
210
|
+
│ └── ... (1,987+ total) │
|
|
211
211
|
└─────────────────────────────────────────┘
|
|
212
212
|
```
|
|
213
213
|
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
Codex hoặc Claude tự kiểm tra dự án; AAS không quét repository. Agent tìm kiếm catalog cục bộ đầy đủ theo thứ tự ổn định, tự đánh giá kết quả không có điểm số hay xếp hạng, rồi gửi `profile` cùng chính xác các ID đã chọn tới `compose_stack`. AAS Core ghi nhận lựa chọn trong `aas-stack.json` schema 2; CLI xác thực manifest và tạo kế hoạch preview bất biến trước khi thay đổi kỹ năng.
|
|
6
6
|
|
|
7
|
-
> **Ranh giới phát hành:**
|
|
7
|
+
> **Ranh giới phát hành:** Dòng 15.x hiện tại bao gồm AAS Core. Chỉ dùng một phiên bản chính xác có release notes tuyên bố rõ rằng nó bao gồm Core. Luồng preview được hỗ trợ dừng sau khi xem kế hoạch; `apply` và `recover` vẫn mang tính thử nghiệm. [Tìm hiểu AAS Core](AAS_CORE.vi.md).
|
|
8
8
|
|
|
9
9
|
[](https://opensource.org/licenses/MIT)
|
|
10
10
|
[](https://claude.ai)
|
|
@@ -15,7 +15,7 @@ Codex hoặc Claude tự kiểm tra dự án; AAS không quét repository. Agent
|
|
|
15
15
|
[](https://github.com/opencode-ai/opencode)
|
|
16
16
|
[](https://github.com/sickn33/agentic-awesome-skills)
|
|
17
17
|
|
|
18
|
-
|
|
18
|
+
Các playbook `SKILL.md`, plugin chuyên biệt, bundle, workflow và installer trực tiếp vẫn rất quan trọng. Chúng là lớp nội dung, tuyển chọn, phân phối và tương thích xung quanh AAS Core, không phải sản phẩm chính cạnh tranh với Core:
|
|
19
19
|
|
|
20
20
|
- 🟣 **Claude Code** (Anthropic CLI)
|
|
21
21
|
- 🔵 **Gemini CLI** (Google DeepMind)
|
|
@@ -26,7 +26,7 @@ Catalog gồm **1,968+ kỹ năng `SKILL.md`**, plugin chuyên biệt, bundle, w
|
|
|
26
26
|
- ⚪ **OpenCode** (Mã nguồn mở CLI)
|
|
27
27
|
- 🟡 **Kiro CLI / IDE** và **AdaL CLI**
|
|
28
28
|
|
|
29
|
-
**Ranh giới phiên bản:** Dòng 14.x là baseline phân phối kỹ năng trực tiếp và không chứa AAS Core;
|
|
29
|
+
**Ranh giới phiên bản:** Dòng 14.x là baseline phân phối kỹ năng trực tiếp và không chứa AAS Core; dòng 15.x hiện tại chứa Core. GitHub là nguồn chuẩn cho Core, catalog, plugin và tài liệu; website được host chỉ là bề mặt duyệt catalog và review trong trình duyệt, không phải control plane được host.
|
|
30
30
|
|
|
31
31
|
### 1. 🐣 Bối cảnh: Đây là gì?
|
|
32
32
|
|
|
@@ -59,7 +59,7 @@ Repository được tổ chức thành các lĩnh vực chuyên biệt để bi
|
|
|
59
59
|
|
|
60
60
|
[Xem các Gói khởi đầu tại docs/vietnamese/BUNDLES.md](BUNDLES.vi.md) để tìm bộ công cụ hoàn hảo cho vai trò của bạn.
|
|
61
61
|
|
|
62
|
-
## Duyệt
|
|
62
|
+
## Duyệt kỹ năng
|
|
63
63
|
|
|
64
64
|
Chúng tôi đã chuyển danh sách đầy đủ các kỹ năng sang một danh mục riêng biệt để giữ cho file README này gọn gàng.
|
|
65
65
|
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hf-cloud-aws-context-discovery
|
|
3
|
+
description: "Discover the effective local AWS profile, region, account, and caller identity before any AWS task without exposing credentials."
|
|
4
|
+
risk: safe
|
|
5
|
+
source: https://github.com/huggingface/skills/tree/main/skills/hf-cloud-aws-context-discovery
|
|
6
|
+
source_repo: huggingface/skills
|
|
7
|
+
source_type: official
|
|
8
|
+
date_added: "2026-07-21"
|
|
9
|
+
author: Hugging Face
|
|
10
|
+
license: Apache-2.0
|
|
11
|
+
license_source: https://github.com/huggingface/skills/blob/main/LICENSE
|
|
12
|
+
tags: [hugging-face, aws, credentials, discovery, cloud]
|
|
13
|
+
tools: [claude, codex, cursor]
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
# AWS Context Discovery
|
|
17
|
+
|
|
18
|
+
Before doing any AWS work, read the user's local AWS config. Don't guess the region, and don't ask the user for things their config already answers.
|
|
19
|
+
|
|
20
|
+
## When to Use
|
|
21
|
+
|
|
22
|
+
- Establish the effective AWS profile, region, account, and caller before AWS work.
|
|
23
|
+
- Diagnose expired SSO sessions, missing profiles, or configuration overrides.
|
|
24
|
+
- Provide verified context to later SageMaker planning and deployment skills.
|
|
25
|
+
|
|
26
|
+
## What to discover
|
|
27
|
+
|
|
28
|
+
Run these at the start of the AWS work and remember the results for the rest of the session.
|
|
29
|
+
|
|
30
|
+
### 1. Active profile
|
|
31
|
+
|
|
32
|
+
`AWS_PROFILE` env var, else `default`. If the user mentioned a profile in their prompt, that overrides. If the named profile doesn't exist in `~/.aws/config`, surface that clearly.
|
|
33
|
+
|
|
34
|
+
### 2. Region
|
|
35
|
+
|
|
36
|
+
Resolution order — stop at the first one that produces a value:
|
|
37
|
+
1. Region the user explicitly named in this conversation
|
|
38
|
+
2. `AWS_REGION` env var
|
|
39
|
+
3. `AWS_DEFAULT_REGION` env var
|
|
40
|
+
4. `region` field on the active profile in `~/.aws/config`
|
|
41
|
+
5. Ask the user — but only after the first four have failed
|
|
42
|
+
|
|
43
|
+
Do not fall back to `us-east-1` or any other hardcoded default.
|
|
44
|
+
|
|
45
|
+
### 3. Credentials, account ID, caller ARN
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
aws sts get-caller-identity --profile <profile> --region <region>
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
Three purposes in one call: confirms credentials are valid (stop if not), returns the `Account` ID (needed for ARN construction), returns the `Arn` of the caller.
|
|
52
|
+
|
|
53
|
+
### 4. Identify SSO / assumed-role principals
|
|
54
|
+
|
|
55
|
+
The `Arn` field tells you what kind of principal this is. The pattern matters because it determines what IAM operations the caller can do.
|
|
56
|
+
|
|
57
|
+
| ARN pattern | Type | IAM write capability |
|
|
58
|
+
|---|---|---|
|
|
59
|
+
| `arn:aws:iam::<acct>:user/<name>` | IAM user | Depends on attached policies |
|
|
60
|
+
| `arn:aws:sts::<acct>:assumed-role/AWSReservedSSO_<...>/<email>` | **SSO assumed-role** | Typically **none** — can't create/modify IAM roles |
|
|
61
|
+
| `arn:aws:sts::<acct>:assumed-role/<role>/<session>` | Regular assumed-role | Depends on the role |
|
|
62
|
+
|
|
63
|
+
**If the caller is SSO**, surface this immediately before later skills hit `iam:CreateRole` and fail:
|
|
64
|
+
|
|
65
|
+
> Heads up: you're authenticated via SSO (`AWSReservedSSO_<PermissionSet>_...`). SSO principals usually can't create IAM roles directly. If we need a SageMaker execution role, I'll look for an existing one first — if none exists, you'll need to ask whoever manages your AWS access to create one.
|
|
66
|
+
|
|
67
|
+
This is the highest-leverage thing this skill does. Surfacing it now turns a confusing mid-deployment error into a five-second conversation.
|
|
68
|
+
|
|
69
|
+
## Commands to run
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
# Effective profile and region (faster than parsing config files)
|
|
73
|
+
aws configure list
|
|
74
|
+
|
|
75
|
+
# Validate credentials and get identity
|
|
76
|
+
aws sts get-caller-identity
|
|
77
|
+
aws sts get-caller-identity --profile <profile-name> # if a profile was named
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
`aws configure list` handles env-var overrides and shows the resolved effective values. Prefer it over parsing `~/.aws/config` yourself. If you need to read raw config (e.g. to list profiles), `~/.aws/config` and `~/.aws/credentials` are plain INI files — read-only.
|
|
81
|
+
|
|
82
|
+
## What to report back
|
|
83
|
+
|
|
84
|
+
One or two lines, not a wall of text:
|
|
85
|
+
|
|
86
|
+
> Working with profile `my-profile` in `eu-west-1`, account `123456789012`. You're authenticated via SSO, so we'll need to use an existing IAM role rather than create one.
|
|
87
|
+
|
|
88
|
+
Don't ask the user to confirm the region you just read from their config — they configured it; that is the confirmation.
|
|
89
|
+
|
|
90
|
+
If something is wrong (credentials expired, profile doesn't exist, no region anywhere), stop and surface the specific error before continuing.
|
|
91
|
+
|
|
92
|
+
## Limitations
|
|
93
|
+
|
|
94
|
+
- Discovery may reveal account IDs, role ARNs, or profile names; report only what the task needs and never expose secrets or session tokens.
|
|
95
|
+
- STS identity checks require network access and valid credentials.
|
|
96
|
+
- A valid identity does not imply permission to change resources.
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: markstream-angular
|
|
3
|
+
description: "Integrate the alpha markstream-angular renderer into Angular 20+ applications with standalone components, signals, safe HTML defaults, and optional peer features."
|
|
4
|
+
category: frontend
|
|
5
|
+
risk: critical
|
|
6
|
+
source: https://github.com/Simon-He95/markstream-vue/tree/main/.agents/skills/markstream-angular
|
|
7
|
+
source_repo: Simon-He95/markstream-vue
|
|
8
|
+
source_type: official
|
|
9
|
+
date_added: "2026-07-21"
|
|
10
|
+
author: Simon-He95
|
|
11
|
+
tags: [angular, markdown, streaming, ai-chat, frontend]
|
|
12
|
+
tools: [claude, cursor, gemini, codex]
|
|
13
|
+
license: MIT
|
|
14
|
+
license_source: https://github.com/Simon-He95/markstream-vue/blob/main/license
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# Markstream Angular
|
|
18
|
+
|
|
19
|
+
## Overview
|
|
20
|
+
|
|
21
|
+
Add Markstream to Angular 20+ while preserving standalone-component patterns, signal-friendly bindings, safe rendering defaults, and explicit optional dependencies. Use `markstream-install` for framework selection; use this skill once Angular is confirmed.
|
|
22
|
+
|
|
23
|
+
## When to Use
|
|
24
|
+
|
|
25
|
+
Use for Angular-specific standalone imports, CSS, signals, custom tags or components, streaming state, and optional peers. Do not use below Angular 20 or when the application cannot accept an alpha renderer API.
|
|
26
|
+
|
|
27
|
+
## Workflow
|
|
28
|
+
|
|
29
|
+
Before changing dependencies or source files, inspect the existing package manager and project conventions, preview the intended edits, and obtain explicit user approval.
|
|
30
|
+
|
|
31
|
+
1. Confirm Angular 20+ and record that `markstream-angular` is alpha.
|
|
32
|
+
2. Install the package plus only requested peers. Import `markstream-angular/index.css`; add KaTeX CSS only for math.
|
|
33
|
+
3. Import `MarkstreamAngularComponent` into the standalone component's `imports`.
|
|
34
|
+
4. Start with `[content]` and `[smoothStreaming]="'auto'"`. Use `nodes` plus `final` only when another layer owns the AST.
|
|
35
|
+
5. For live chat use `[fade]="false"` and opt into `[typewriter]="true"`. On completion set `[final]="true"`, disable pacing/cursor, and enable fade only if desired.
|
|
36
|
+
6. Use `[customHtmlTags]` and `[customComponents]` only for trusted tag workflows.
|
|
37
|
+
7. Keep `[htmlPolicy]="'safe'"` and Mermaid strict mode unless a narrowly scoped trusted legacy surface requires otherwise.
|
|
38
|
+
8. Validate with the smallest Angular build, typecheck, or dev command.
|
|
39
|
+
|
|
40
|
+
## Example
|
|
41
|
+
|
|
42
|
+
```ts
|
|
43
|
+
import { Component, signal } from '@angular/core'
|
|
44
|
+
import { MarkstreamAngularComponent } from 'markstream-angular'
|
|
45
|
+
import 'markstream-angular/index.css'
|
|
46
|
+
|
|
47
|
+
@Component({
|
|
48
|
+
selector: 'app-answer',
|
|
49
|
+
standalone: true,
|
|
50
|
+
imports: [MarkstreamAngularComponent],
|
|
51
|
+
template: `
|
|
52
|
+
<markstream-angular
|
|
53
|
+
[content]="markdown()"
|
|
54
|
+
[final]="done()"
|
|
55
|
+
[fade]="done()"
|
|
56
|
+
[typewriter]="!done()"
|
|
57
|
+
[smoothStreaming]="done() ? false : 'auto'"
|
|
58
|
+
[htmlPolicy]="'safe'"
|
|
59
|
+
/>
|
|
60
|
+
`,
|
|
61
|
+
})
|
|
62
|
+
export class AnswerComponent {
|
|
63
|
+
markdown = signal('# Streaming answer')
|
|
64
|
+
done = signal(false)
|
|
65
|
+
}
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## Limitations
|
|
69
|
+
|
|
70
|
+
- Requires Angular 20+ and an alpha package.
|
|
71
|
+
- Browser-heavy peers may need bundler or client-boundary work.
|
|
72
|
+
- This skill does not design the host chat architecture or visual system.
|
|
73
|
+
|
|
74
|
+
## Security & Safety Notes
|
|
75
|
+
|
|
76
|
+
Review dependency changes before installation. Never broaden HTML or Mermaid trust settings for untrusted model output.
|