opencode-skills-antigravity 1.0.68 → 1.0.70
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 +1 -1
- package/bundled-skills/docs/integrations/jetski-cortex.md +75 -75
- package/bundled-skills/docs/maintainers/audit.md +18 -18
- package/bundled-skills/docs/users/getting-started.md +1 -1
- package/bundled-skills/docs/users/workflows.md +17 -17
- package/bundled-skills/docs/vietnamese/README.vi.md +3 -4
- package/package.json +1 -1
|
@@ -1,54 +1,54 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Jetski/Cortex + Gemini Integration Guide
|
|
3
|
-
description: "
|
|
3
|
+
description: "Use antigravity-awesome-skills with Jetski/Cortex without hitting context-window overflow with 1.340+ skills."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Jetski/Cortex + Gemini:
|
|
6
|
+
# Jetski/Cortex + Gemini: safe integration with 1,1.340+ skills
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
This guide shows how to integrate the `antigravity-awesome-skills` repository with an agent based on **Jetski/Cortex + Gemini** (or similar frameworks) **without exceeding the model context window**.
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
The common error seen in Jetski/Cortex is:
|
|
11
11
|
|
|
12
12
|
> `TrajectoryChatConverter: could not convert a single message before hitting truncation`
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
The issue is not with the skills themselves, but **with how they are loaded**.
|
|
15
15
|
|
|
16
16
|
---
|
|
17
17
|
|
|
18
|
-
## 1.
|
|
18
|
+
## 1. Anti-pattern to avoid
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
Never do:
|
|
21
21
|
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
-
|
|
22
|
+
- read **all** `skills/*/SKILL.md` directories at startup;
|
|
23
|
+
- concatenate all `SKILL.md` content into a single system prompt;
|
|
24
|
+
- re-inject the entire library for **every** request.
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
With over 1,1.340 skills, this approach fills the context window before user messages are even added, causing truncation.
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
|
30
|
-
## 2.
|
|
30
|
+
## 2. Recommended pattern
|
|
31
31
|
|
|
32
|
-
|
|
32
|
+
Core principles:
|
|
33
33
|
|
|
34
|
-
- **
|
|
35
|
-
- **Lazy loading**:
|
|
36
|
-
- **
|
|
37
|
-
- **Path safety**:
|
|
34
|
+
- **Light manifest**: use `data/skills_index.json` to know *which* skills exist without loading full text.
|
|
35
|
+
- **Lazy loading**: read `SKILL.md` **only** for skills actually invoked in a conversation (for example, when `@skill-id` appears).
|
|
36
|
+
- **Explicit limits**: enforce a maximum number of skills/tokens loaded per turn, with clear fallbacks.
|
|
37
|
+
- **Path safety**: verify manifest paths remain inside `SKILLS_ROOT` before reading `SKILL.md`.
|
|
38
38
|
|
|
39
|
-
|
|
39
|
+
The recommended flow is:
|
|
40
40
|
|
|
41
|
-
1. **Bootstrap**:
|
|
42
|
-
2. **
|
|
43
|
-
3. **
|
|
44
|
-
4. **Lazy load**:
|
|
45
|
-
5. **Prompt building**:
|
|
41
|
+
1. **Bootstrap**: on agent startup, read `data/skills_index.json` and build an `id -> meta` map.
|
|
42
|
+
2. **Message parsing**: before calling the model, extract all `@skill-id` references from user/system messages.
|
|
43
|
+
3. **Resolution**: map the found IDs into `SkillMeta` objects using the bootstrap map.
|
|
44
|
+
4. **Lazy load**: read `SKILL.md` files only for these IDs (up to a configurable maximum).
|
|
45
|
+
5. **Prompt building**: build model system messages including only the selected skill definitions.
|
|
46
46
|
|
|
47
47
|
---
|
|
48
48
|
|
|
49
|
-
## 3.
|
|
49
|
+
## 3. Structure of `skills_index.json`
|
|
50
50
|
|
|
51
|
-
|
|
51
|
+
The file `data/skills_index.json` is an array of objects, for example:
|
|
52
52
|
|
|
53
53
|
```json
|
|
54
54
|
{
|
|
@@ -63,24 +63,24 @@ Il file `data/skills_index.json` è un array di oggetti, ad esempio:
|
|
|
63
63
|
}
|
|
64
64
|
```
|
|
65
65
|
|
|
66
|
-
|
|
66
|
+
Key fields:
|
|
67
67
|
|
|
68
|
-
- **`id`**:
|
|
69
|
-
- **`path`**: directory
|
|
68
|
+
- **`id`**: identifier used in `@id` mentions (for example, `@brainstorming`).
|
|
69
|
+
- **`path`**: directory containing `SKILL.md` (for example, `skills/brainstorming/`).
|
|
70
70
|
|
|
71
|
-
|
|
71
|
+
To resolve the path to a skill definition:
|
|
72
72
|
|
|
73
73
|
- `fullPath = path.join(SKILLS_ROOT, meta.path, "SKILL.md")`.
|
|
74
74
|
|
|
75
|
-
>
|
|
75
|
+
> Note: `SKILLS_ROOT` is the root directory where you installed the repository (for example, `~/.agent/skills`).
|
|
76
76
|
|
|
77
77
|
---
|
|
78
78
|
|
|
79
|
-
## 4.
|
|
79
|
+
## 4. Integration pseudocode (TypeScript)
|
|
80
80
|
|
|
81
|
-
>
|
|
81
|
+
> Full example in: [`docs/integrations/jetski-gemini-loader/`](../../docs/integrations/jetski-gemini-loader/).
|
|
82
82
|
|
|
83
|
-
### 4.1.
|
|
83
|
+
### 4.1. Core Types
|
|
84
84
|
|
|
85
85
|
```ts
|
|
86
86
|
type SkillMeta = {
|
|
@@ -93,7 +93,7 @@ type SkillMeta = {
|
|
|
93
93
|
};
|
|
94
94
|
```
|
|
95
95
|
|
|
96
|
-
### 4.2. Bootstrap:
|
|
96
|
+
### 4.2. Bootstrap: load the manifest
|
|
97
97
|
|
|
98
98
|
```ts
|
|
99
99
|
function loadSkillIndex(indexPath: string): Map<string, SkillMeta> {
|
|
@@ -107,7 +107,7 @@ function loadSkillIndex(indexPath: string): Map<string, SkillMeta> {
|
|
|
107
107
|
}
|
|
108
108
|
```
|
|
109
109
|
|
|
110
|
-
### 4.3.
|
|
110
|
+
### 4.3. Parse messages to find `@skill-id`
|
|
111
111
|
|
|
112
112
|
```ts
|
|
113
113
|
const SKILL_ID_REGEX = /@([a-zA-Z0-9-_./]+)/g;
|
|
@@ -140,7 +140,7 @@ function resolveSkillsFromMessages(
|
|
|
140
140
|
}
|
|
141
141
|
```
|
|
142
142
|
|
|
143
|
-
### 4.4. Lazy loading
|
|
143
|
+
### 4.4. Lazy loading `SKILL.md` files
|
|
144
144
|
|
|
145
145
|
```ts
|
|
146
146
|
async function loadSkillBodies(
|
|
@@ -159,9 +159,9 @@ async function loadSkillBodies(
|
|
|
159
159
|
}
|
|
160
160
|
```
|
|
161
161
|
|
|
162
|
-
### 4.5.
|
|
162
|
+
### 4.5. Build the Jetski/Cortex prompt
|
|
163
163
|
|
|
164
|
-
|
|
164
|
+
Pseudocode for the pre-processing phase before `TrajectoryChatConverter`:
|
|
165
165
|
|
|
166
166
|
```ts
|
|
167
167
|
async function buildModelMessages(
|
|
@@ -203,70 +203,70 @@ async function buildModelMessages(
|
|
|
203
203
|
}
|
|
204
204
|
```
|
|
205
205
|
|
|
206
|
-
>
|
|
207
|
-
>
|
|
206
|
+
> Tip: Add token estimation to trim or summarize `SKILL.md` files when the context window approaches its limit.
|
|
207
|
+
> This repository's reference loader also supports an explicit fallback: `overflowBehavior: "error"`.
|
|
208
208
|
|
|
209
209
|
---
|
|
210
210
|
|
|
211
|
-
## 5.
|
|
211
|
+
## 5. Context overflow handling
|
|
212
212
|
|
|
213
|
-
|
|
213
|
+
To avoid unclear errors for the user, set:
|
|
214
214
|
|
|
215
|
-
-
|
|
216
|
-
-
|
|
215
|
+
- a **safety threshold** (for example, 70–80% of the context window);
|
|
216
|
+
- a **maximum number of skills per turn** (for example, 5–10).
|
|
217
217
|
|
|
218
|
-
|
|
218
|
+
Strategies when the threshold is exceeded:
|
|
219
219
|
|
|
220
|
-
-
|
|
221
|
-
-
|
|
220
|
+
- reduce the number of included skills (for example, by recency or priority); or
|
|
221
|
+
- return a clear error to the user, for example:
|
|
222
222
|
|
|
223
|
-
> "
|
|
223
|
+
> "Too many skills were requested in a single turn. Reduce the number of `@skill-id` references in your message or split them into multiple turns."
|
|
224
224
|
|
|
225
225
|
---
|
|
226
226
|
|
|
227
|
-
## 6.
|
|
227
|
+
## 6. Recommended test scenarios
|
|
228
228
|
|
|
229
|
-
- **Scenario 1 –
|
|
230
|
-
-
|
|
231
|
-
- **Scenario 2 –
|
|
232
|
-
-
|
|
233
|
-
- **Scenario 3 –
|
|
234
|
-
-
|
|
229
|
+
- **Scenario 1 – Simple message ("hi")**
|
|
230
|
+
- No `@skill-id` → no `SKILL.md` loaded → prompt remains small → no error.
|
|
231
|
+
- **Scenario 2 – Few skills**
|
|
232
|
+
- Message with 1–2 `@skill-id` references → only related `SKILL.md` files are loaded → no overflow.
|
|
233
|
+
- **Scenario 3 – Many skills**
|
|
234
|
+
- Message with many `@skill-id` references → `maxSkillsPerTurn` or token guardrails trigger → no silent overflow.
|
|
235
235
|
|
|
236
236
|
---
|
|
237
237
|
|
|
238
|
-
## 7.
|
|
238
|
+
## 7. Skill subsets and bundles
|
|
239
239
|
|
|
240
|
-
|
|
240
|
+
For additional control:
|
|
241
241
|
|
|
242
|
-
-
|
|
243
|
-
-
|
|
242
|
+
- move unnecessary skills into `skills/.disabled/` to exclude them in certain environments;
|
|
243
|
+
- use the **bundles** described in [`docs/users/bundles.md`](../users/bundles.md) to load only focused groups.
|
|
244
244
|
|
|
245
|
-
## 8.
|
|
245
|
+
## 8. Windows crash-loop recovery
|
|
246
246
|
|
|
247
|
-
|
|
247
|
+
If the host keeps reopening the same corrupted trajectory after a truncation error:
|
|
248
248
|
|
|
249
|
-
-
|
|
250
|
-
-
|
|
251
|
-
-
|
|
252
|
-
-
|
|
249
|
+
- remove the problematic skill or package;
|
|
250
|
+
- clear Antigravity Local Storage / Session Storage / IndexedDB;
|
|
251
|
+
- clear `%TEMP%`;
|
|
252
|
+
- restart with lazy loading and explicit limits.
|
|
253
253
|
|
|
254
|
-
|
|
254
|
+
Complete guide:
|
|
255
255
|
|
|
256
256
|
- [`docs/users/windows-truncation-recovery.md`](../users/windows-truncation-recovery.md)
|
|
257
257
|
|
|
258
|
-
|
|
258
|
+
To prevent recurrence:
|
|
259
259
|
|
|
260
|
-
-
|
|
261
|
-
-
|
|
260
|
+
- keep `overflowBehavior: "error"` when you prefer explicit failure;
|
|
261
|
+
- continue validating that resolved paths remain inside `skillsRoot`.
|
|
262
262
|
|
|
263
263
|
---
|
|
264
264
|
|
|
265
|
-
## 9.
|
|
265
|
+
## 9. Summary
|
|
266
266
|
|
|
267
|
-
-
|
|
268
|
-
-
|
|
269
|
-
-
|
|
270
|
-
-
|
|
267
|
+
- Do not concatenate all `SKILL.md` files into a single prompt.
|
|
268
|
+
- Use `data/skills_index.json` as a lightweight manifest.
|
|
269
|
+
- Load skills **on demand** based on `@skill-id`.
|
|
270
|
+
- Set clear limits (max skills per turn, token threshold).
|
|
271
271
|
|
|
272
|
-
|
|
272
|
+
Following this pattern, Jetski/Cortex + Gemini can use the full `antigravity-awesome-skills` library safely, at scale, and within modern model context-window limits.
|
|
@@ -4,24 +4,24 @@ This document summarizes the repository coherence audit performed after the `app
|
|
|
4
4
|
|
|
5
5
|
## Scope
|
|
6
6
|
|
|
7
|
-
-
|
|
8
|
-
-
|
|
7
|
+
- Counts and numbers (README, package.json, CATALOG)
|
|
8
|
+
- Skill validation (frontmatter, risk, "When to Use", link)
|
|
9
9
|
- Audit repo-wide per skill (conformance + baseline usability)
|
|
10
|
-
-
|
|
11
|
-
-
|
|
12
|
-
-
|
|
13
|
-
-
|
|
10
|
+
- Cross references (workflows.json, bundles.json, `docs/users/bundles.md`)
|
|
11
|
+
- Documentation (`docs/contributors/quality-bar.md`, `docs/contributors/skill-anatomy.md`, security/licenses)
|
|
12
|
+
- Scripts and build (validate, index, readme, catalog, test)
|
|
13
|
+
- Notes on data/ and test YAML
|
|
14
14
|
|
|
15
15
|
## Outcomes
|
|
16
16
|
|
|
17
|
-
### 1.
|
|
17
|
+
### 1. Counts
|
|
18
18
|
|
|
19
19
|
- `README.md`, `package.json`, and generated artifacts are aligned to the current collection size.
|
|
20
20
|
- `npm run sync:repo-state` is the canonical maintainer command for keeping counts, generated files, contributors, and tracked web assets synchronized on local `main`.
|
|
21
21
|
- `npm run sync:release-state` is the canonical release-facing variant when you want the same sync without the contributor refresh step.
|
|
22
22
|
- `npm run sync:all` remains a legacy alias for the core chain, not the full maintainer sync surface.
|
|
23
23
|
|
|
24
|
-
### 2.
|
|
24
|
+
### 2. Skill validation
|
|
25
25
|
|
|
26
26
|
- `npm run validate` is the operational contributor gate.
|
|
27
27
|
- `npm run validate:strict` is currently a diagnostic hardening pass: it still surfaces repository-wide legacy metadata/content gaps across many older skills.
|
|
@@ -45,22 +45,22 @@ This document summarizes the repository coherence audit performed after the `app
|
|
|
45
45
|
- The intended maintainer loop is: `audit:skills` to inspect `suggested_risk`, `sync:risk-labels` for the safe automated subset, then manual review for the ambiguous tail that should not be batch-classified.
|
|
46
46
|
- Use `npm run audit:skills` for the maintainer view and `npm run audit:skills -- --json-out ... --markdown-out ...` when you want artifacts for triage or cleanup tracking.
|
|
47
47
|
|
|
48
|
-
### 3.
|
|
48
|
+
### 3. Cross references
|
|
49
49
|
|
|
50
50
|
- Added `tools/scripts/validate_references.py` (also exposed as `npm run validate:references`), which verifies:
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
51
|
+
- every `recommendedSkills` in data/workflows.json exists in skills/;
|
|
52
|
+
- every `relatedBundles` exists in data/bundles.json;
|
|
53
|
+
- every slug in data/bundles.json (skills list) exists in skills/;
|
|
54
54
|
- every skill link in `docs/users/bundles.md` points to an existing skill.
|
|
55
55
|
- Execution: `npm run validate:references`. Result: all references valid.
|
|
56
56
|
|
|
57
|
-
### 4.
|
|
57
|
+
### 4. Documentation
|
|
58
58
|
|
|
59
59
|
- Canonical contributor docs now live under `docs/contributors/`.
|
|
60
60
|
- Canonical maintainer docs now live under `docs/maintainers/`.
|
|
61
61
|
- README, security docs, licenses, and internal markdown links were rechecked after the refactor.
|
|
62
62
|
|
|
63
|
-
### 5.
|
|
63
|
+
### 5. Scripts and build
|
|
64
64
|
|
|
65
65
|
- `npm run test` and `npm run app:build` complete successfully on the refactored layout.
|
|
66
66
|
- `validate_skills_headings.test.js` acts as a lightweight regression/smoke test, not as the source of truth for full metadata compliance.
|
|
@@ -73,12 +73,12 @@ This document summarizes the repository coherence audit performed after the `app
|
|
|
73
73
|
- User and maintainer docs checked for path drift after the layout change.
|
|
74
74
|
- Follow-up still open: repository-wide cleanup required to make `validate:strict` fully green.
|
|
75
75
|
|
|
76
|
-
##
|
|
76
|
+
## Useful commands
|
|
77
77
|
|
|
78
78
|
```bash
|
|
79
|
-
npm run validate #
|
|
79
|
+
npm run validate # skill validation (soft)
|
|
80
80
|
npm run validate:strict # hardening / diagnostic pass
|
|
81
|
-
npm run audit:skills #
|
|
81
|
+
npm run audit:skills # full skill audit with finding codes and status
|
|
82
82
|
npm run sync:risk-labels # conservative sync for high-confidence legacy risk labels
|
|
83
83
|
npm run sync:risk-labels -- --dry-run # preview legacy risk rewrites before touching files
|
|
84
84
|
npm run validate:references # workflow, bundle, and docs/users/bundles.md references
|
|
@@ -87,7 +87,7 @@ npm run build # chain + catalog
|
|
|
87
87
|
npm test # suite test
|
|
88
88
|
```
|
|
89
89
|
|
|
90
|
-
##
|
|
90
|
+
## Open issues / follow-up
|
|
91
91
|
|
|
92
92
|
- Gradual cleanup of legacy skills so `npm run validate:strict` can become a hard CI gate in the future.
|
|
93
93
|
- Continue reducing the remaining `risk: unknown` tail with conservative sync passes plus manual maintainer review for ambiguous cases.
|
|
@@ -41,28 +41,28 @@ Build and ship a minimal but production-minded SaaS product.
|
|
|
41
41
|
1. **Plan the scope**
|
|
42
42
|
- **Goal:** Define MVP boundaries and acceptance criteria.
|
|
43
43
|
- **Skills:** [`@brainstorming`](../../skills/brainstorming/), [`@concise-planning`](../../skills/concise-planning/), [`@writing-plans`](../../skills/writing-plans/)
|
|
44
|
-
- **Prompt example:** `
|
|
44
|
+
- **Prompt example:** `Use @concise-planning to define milestones and acceptance criteria for my SaaS MVP.`
|
|
45
45
|
|
|
46
46
|
2. **Build backend and API**
|
|
47
47
|
- **Goal:** Implement core entities, APIs, and auth baseline.
|
|
48
48
|
- **Skills:** [`@backend-dev-guidelines`](../../skills/backend-dev-guidelines/), [`@api-patterns`](../../skills/api-patterns/), [`@database-design`](../../skills/database-design/)
|
|
49
|
-
- **Prompt example:** `
|
|
49
|
+
- **Prompt example:** `Use @backend-dev-guidelines to create APIs and services for the billing domain.`
|
|
50
50
|
|
|
51
51
|
3. **Build frontend**
|
|
52
52
|
- **Goal:** Ship core user flow with clear UX states.
|
|
53
53
|
- **Skills:** [`@frontend-developer`](../../skills/frontend-developer/), [`@react-patterns`](../../skills/react-patterns/), [`@frontend-design`](../../skills/frontend-design/)
|
|
54
|
-
- **Prompt example:** `
|
|
54
|
+
- **Prompt example:** `Use @frontend-developer to implement onboarding, the empty state, and the initial dashboard.`
|
|
55
55
|
|
|
56
56
|
4. **Test and validate**
|
|
57
57
|
- **Goal:** Cover critical user journeys before release.
|
|
58
58
|
- **Skills:** [`@test-driven-development`](../../skills/test-driven-development/), [`@browser-automation`](../../skills/browser-automation/), `@go-playwright` (optional, Go stack)
|
|
59
|
-
- **Prompt example:** `
|
|
60
|
-
- **Go note:**
|
|
59
|
+
- **Prompt example:** `Use @browser-automation to create E2E tests for the signup and checkout flows.`
|
|
60
|
+
- **Go note:** If the QA project and tooling are in Go, prefer `@go-playwright`.
|
|
61
61
|
|
|
62
62
|
5. **Ship safely**
|
|
63
63
|
- **Goal:** Release with observability and rollback plan.
|
|
64
64
|
- **Skills:** [`@deployment-procedures`](../../skills/deployment-procedures/), [`@observability-engineer`](../../skills/observability-engineer/)
|
|
65
|
-
- **Prompt example:** `
|
|
65
|
+
- **Prompt example:** `Use @deployment-procedures for a release checklist with rollback steps.`
|
|
66
66
|
|
|
67
67
|
---
|
|
68
68
|
|
|
@@ -83,22 +83,22 @@ Run a focused security review from scope definition to remediation validation.
|
|
|
83
83
|
1. **Define scope and threat model**
|
|
84
84
|
- **Goal:** Identify assets, trust boundaries, and attack paths.
|
|
85
85
|
- **Skills:** [`@ethical-hacking-methodology`](../../skills/ethical-hacking-methodology/), [`@threat-modeling-expert`](../../skills/threat-modeling-expert/), [`@attack-tree-construction`](../../skills/attack-tree-construction/)
|
|
86
|
-
- **Prompt example:** `
|
|
86
|
+
- **Prompt example:** `Use @threat-modeling-expert to map critical assets and trust boundaries for my web app.`
|
|
87
87
|
|
|
88
88
|
2. **Review auth and access control**
|
|
89
89
|
- **Goal:** Detect account takeover and authorization flaws.
|
|
90
90
|
- **Skills:** [`@broken-authentication`](../../skills/broken-authentication/), [`@auth-implementation-patterns`](../../skills/auth-implementation-patterns/), [`@idor-testing`](../../skills/idor-testing/)
|
|
91
|
-
- **Prompt example:** `
|
|
91
|
+
- **Prompt example:** `Use @idor-testing to verify unauthorized access on multitenant endpoints.`
|
|
92
92
|
|
|
93
93
|
3. **Assess API and input security**
|
|
94
94
|
- **Goal:** Uncover high-impact API and injection vulnerabilities.
|
|
95
95
|
- **Skills:** [`@api-security-best-practices`](../../skills/api-security-best-practices/), [`@api-fuzzing-bug-bounty`](../../skills/api-fuzzing-bug-bounty/), [`@top-web-vulnerabilities`](../../skills/top-web-vulnerabilities/)
|
|
96
|
-
- **Prompt example:** `
|
|
96
|
+
- **Prompt example:** `Use @api-security-best-practices to audit auth, billing, and admin endpoints.`
|
|
97
97
|
|
|
98
98
|
4. **Harden and verify**
|
|
99
99
|
- **Goal:** Convert findings into fixes and verify evidence of mitigation.
|
|
100
100
|
- **Skills:** [`@security-auditor`](../../skills/security-auditor/), [`@sast-configuration`](../../skills/sast-configuration/), [`@verification-before-completion`](../../skills/verification-before-completion/)
|
|
101
|
-
- **Prompt example:** `
|
|
101
|
+
- **Prompt example:** `Use @verification-before-completion to prove that the mitigations are effective.`
|
|
102
102
|
|
|
103
103
|
---
|
|
104
104
|
|
|
@@ -119,22 +119,22 @@ Design and deliver a production-grade agent with measurable reliability.
|
|
|
119
119
|
1. **Define target behavior and KPIs**
|
|
120
120
|
- **Goal:** Set quality, latency, and failure thresholds.
|
|
121
121
|
- **Skills:** [`@ai-agents-architect`](../../skills/ai-agents-architect/), [`@agent-evaluation`](../../skills/agent-evaluation/), [`@product-manager-toolkit`](../../skills/product-manager-toolkit/)
|
|
122
|
-
- **Prompt example:** `
|
|
122
|
+
- **Prompt example:** `Use @agent-evaluation to define benchmarks and success criteria for my agent.`
|
|
123
123
|
|
|
124
124
|
2. **Design retrieval and memory**
|
|
125
125
|
- **Goal:** Build reliable retrieval and context architecture.
|
|
126
126
|
- **Skills:** [`@llm-app-patterns`](../../skills/llm-app-patterns/), [`@rag-implementation`](../../skills/rag-implementation/), [`@vector-database-engineer`](../../skills/vector-database-engineer/)
|
|
127
|
-
- **Prompt example:** `
|
|
127
|
+
- **Prompt example:** `Use @rag-implementation to design chunking, embedding, and retrieval pipelines.`
|
|
128
128
|
|
|
129
129
|
3. **Implement orchestration**
|
|
130
130
|
- **Goal:** Implement deterministic orchestration and tool boundaries.
|
|
131
131
|
- **Skills:** [`@langgraph`](../../skills/langgraph/), [`@mcp-builder`](../../skills/mcp-builder/), [`@workflow-automation`](../../skills/workflow-automation/)
|
|
132
|
-
- **Prompt example:** `
|
|
132
|
+
- **Prompt example:** `Use @langgraph to implement the agent graph with fallbacks and human-in-the-loop flows.`
|
|
133
133
|
|
|
134
134
|
4. **Evaluate and iterate**
|
|
135
135
|
- **Goal:** Improve weak points with a structured loop.
|
|
136
136
|
- **Skills:** [`@agent-evaluation`](../../skills/agent-evaluation/), [`@langfuse`](../../skills/langfuse/), [`@kaizen`](../../skills/kaizen/)
|
|
137
|
-
- **Prompt example:** `
|
|
137
|
+
- **Prompt example:** `Use @kaizen to prioritize fixes for the failure modes identified by testing.`
|
|
138
138
|
|
|
139
139
|
---
|
|
140
140
|
|
|
@@ -155,17 +155,17 @@ Create resilient browser automation with deterministic execution in CI.
|
|
|
155
155
|
1. **Prepare test strategy**
|
|
156
156
|
- **Goal:** Scope journeys, fixtures, and execution environments.
|
|
157
157
|
- **Skills:** [`@e2e-testing-patterns`](../../skills/e2e-testing-patterns/), [`@test-driven-development`](../../skills/test-driven-development/)
|
|
158
|
-
- **Prompt example:** `
|
|
158
|
+
- **Prompt example:** `Use @e2e-testing-patterns to define a minimal but high-impact E2E suite.`
|
|
159
159
|
|
|
160
160
|
2. **Implement browser tests**
|
|
161
161
|
- **Goal:** Build robust test coverage with stable selectors.
|
|
162
162
|
- **Skills:** [`@browser-automation`](../../skills/browser-automation/), `@go-playwright` (optional, Go stack)
|
|
163
|
-
- **Prompt example:** `
|
|
163
|
+
- **Prompt example:** `Use @go-playwright to implement browser automation in a Go project.`
|
|
164
164
|
|
|
165
165
|
3. **Triage and harden**
|
|
166
166
|
- **Goal:** Remove flaky behavior and enforce repeatability.
|
|
167
167
|
- **Skills:** [`@systematic-debugging`](../../skills/systematic-debugging/), [`@test-fixing`](../../skills/test-fixing/), [`@verification-before-completion`](../../skills/verification-before-completion/)
|
|
168
|
-
- **Prompt example:** `
|
|
168
|
+
- **Prompt example:** `Use @systematic-debugging to classify and resolve flaky behavior in CI.`
|
|
169
169
|
|
|
170
170
|
---
|
|
171
171
|
|
|
@@ -132,13 +132,12 @@ Bộ sưu tập này sẽ không thể hình thành nếu không có công việ
|
|
|
132
132
|
- **[zebbern/claude-code-guide](https://github.com/zebbern/claude-code-guide)**: Bộ công cụ bảo mật toàn diện & Hướng dẫn (Nguồn cho khoảng 60 kỹ năng mới).
|
|
133
133
|
- **[alirezarezvani/claude-skills](https://github.com/alirezarezvani/claude-skills)**: Bộ công cụ Kỹ sư cao cấp và PM.
|
|
134
134
|
- **[karanb192/awesome-claude-skills](https://github.com/karanb192/awesome-claude-skills)**: Một danh sách khổng lồ các kỹ năng đã được xác thực cho Claude Code.
|
|
135
|
-
- **[zircote/.claude](https://github.com/zircote/.claude)**:
|
|
136
|
-
- **[vibeforge1111/vibeship-spawner-skills](https://github.com/vibeforge1111/vibeship-spawner-skills)**:
|
|
135
|
+
- **[zircote/.claude](https://github.com/zircote/.claude)**: Kho cấu hình/dotfiles Claude Code đã được lưu trữ, có tham chiếu kỹ năng phát triển Shopify.
|
|
136
|
+
- **[vibeforge1111/vibeship-spawner-skills](https://github.com/vibeforge1111/vibeship-spawner-skills)**: Bộ kỹ năng quy mô lớn cho AI agent, tích hợp, maker tools và nhiều lĩnh vực khác.
|
|
137
137
|
- **[coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills)**: Các kỹ năng Marketing cho CRO, copywriting, SEO, quảng cáo trả phí và tăng trưởng (23 kỹ năng, MIT).
|
|
138
138
|
- **[vudovn/antigravity-kit](https://github.com/vudovn/antigravity-kit)**: Các mẫu AI Agent với Kỹ năng, Agents và Quy trình làm việc (33 kỹ năng, MIT).
|
|
139
|
-
- **[affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code)**: Bộ sưu tập cấu hình Claude Code
|
|
139
|
+
- **[affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code)**: Bộ sưu tập lớn về cấu hình và quy trình làm việc cho Claude Code từ người chiến thắng hackathon của Anthropic (MIT).
|
|
140
140
|
- **[webzler/agentMemory](https://github.com/webzler/agentMemory)**: Nguồn cho kỹ năng agent-memory-mcp.
|
|
141
|
-
- **[sstklen/claude-api-cost-optimization](https://github.com/sstklen/claude-api-cost-optimization)**: Tiết kiệm 50-90% chi phí Claude API với các chiến lược tối ưu hóa thông minh (MIT).
|
|
142
141
|
|
|
143
142
|
### Nguồn cảm hứng
|
|
144
143
|
|
package/package.json
CHANGED