opencode-skills-collection 4.0.19 → 4.0.21
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 +5 -1
- package/bundled-skills/agents-generator/SKILL.md +163 -0
- package/bundled-skills/agents-generator/assets/agents-full.md +452 -0
- package/bundled-skills/agents-generator/assets/agents-minimal.md +60 -0
- package/bundled-skills/agents-generator/assets/agents-nested.md +73 -0
- package/bundled-skills/agents-generator/assets/architecture.md +43 -0
- package/bundled-skills/agents-generator/assets/backend.md +35 -0
- package/bundled-skills/agents-generator/assets/claude.md +39 -0
- package/bundled-skills/agents-generator/assets/database.md +40 -0
- package/bundled-skills/agents-generator/assets/forms.md +56 -0
- package/bundled-skills/agents-generator/assets/frontend-patterns.md +44 -0
- package/bundled-skills/agents-generator/assets/git-workflow.md +61 -0
- package/bundled-skills/agents-generator/assets/i18n.md +50 -0
- package/bundled-skills/agents-generator/assets/platform.md +54 -0
- package/bundled-skills/agents-generator/assets/sdd-workflow.md +46 -0
- package/bundled-skills/agents-generator/assets/server-actions.md +36 -0
- package/bundled-skills/agents-generator/assets/styling.md +48 -0
- package/bundled-skills/agents-generator/assets/testing.md +67 -0
- package/bundled-skills/agents-generator/references/decision-matrix.md +311 -0
- package/bundled-skills/agents-generator/references/example-output/README.md +78 -0
- package/bundled-skills/agents-generator/references/template-filling-guide.md +67 -0
- 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/repo-growth-seo.md +1 -1
- package/bundled-skills/docs/maintainers/skills-update-guide.md +1 -1
- package/bundled-skills/docs/users/aas-core.md +1 -1
- 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 +3 -3
- package/bundled-skills/docs/users/visual-guide.md +4 -4
- package/bundled-skills/gh-attach/SKILL.md +151 -0
- package/bundled-skills/talivia-agent-kit/SKILL.md +139 -0
- package/bundled-skills/unified-ai-gateway/SKILL.md +214 -0
- package/package.json +1 -1
- package/skills_index.json +100 -0
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
# Styling Rules
|
|
2
|
+
|
|
3
|
+
## Approach: {{CSS_APPROACH}}
|
|
4
|
+
|
|
5
|
+
{{CSS_APPROACH_DESCRIPTION}}
|
|
6
|
+
|
|
7
|
+
## Rules
|
|
8
|
+
|
|
9
|
+
{{STYLING_RULES}}
|
|
10
|
+
|
|
11
|
+
## Themes / Design Tokens
|
|
12
|
+
|
|
13
|
+
{{THEME_SECTION}}
|
|
14
|
+
|
|
15
|
+
## Animations
|
|
16
|
+
|
|
17
|
+
{{ANIMATION_SECTION}}
|
|
18
|
+
|
|
19
|
+
## Generation Rules
|
|
20
|
+
|
|
21
|
+
- **CSS_APPROACH**: Detected approach name: "Tailwind CSS", "CSS Modules", "styled-components", "Emotion", "Sass/SCSS", "Plain CSS".
|
|
22
|
+
- **CSS_APPROACH_DESCRIPTION**: One sentence summarizing how styling works. E.g.: "Tailwind CSS v4 with utility-first classes. No separate CSS files except globals.css."
|
|
23
|
+
- **STYLING_RULES**: Approach-specific rules:
|
|
24
|
+
- **Tailwind**:
|
|
25
|
+
- No inline `style={{}}` — always Tailwind classes. Exception: dynamically computed values (mouse-position based).
|
|
26
|
+
- `cn()` for combining conditional classes. If `lib/utils.ts` has `cn`, document it.
|
|
27
|
+
- Responsive: mobile-first with `sm:`, `md:`, `lg:` breakpoints.
|
|
28
|
+
- Dark mode: if using `class="dark"` or `prefers-color-scheme`.
|
|
29
|
+
- shadcn/ui: components use `components/ui/`, theme via CSS variables.
|
|
30
|
+
- **CSS Modules**:
|
|
31
|
+
- `.module.css` files next to the component.
|
|
32
|
+
- `import styles from "./Component.module.css"`.
|
|
33
|
+
- No global classes (use `:global()` if needed).
|
|
34
|
+
- **styled-components**:
|
|
35
|
+
- `styled.div` / `styled(Component)` for styled components.
|
|
36
|
+
- Theme provider with `ThemeProvider`.
|
|
37
|
+
- Transient props with `$` prefix.
|
|
38
|
+
- **Sass/SCSS**:
|
|
39
|
+
- `.scss` files with variables, mixins, nesting.
|
|
40
|
+
- No inline `style={{}}`.
|
|
41
|
+
- **THEME_SECTION**: If theming system exists (CSS variables, ThemeProvider, next-themes):
|
|
42
|
+
- Where tokens are defined (globals.css, theme.ts).
|
|
43
|
+
- How to switch between light/dark.
|
|
44
|
+
- Whether it's dark-mode only or has a toggle.
|
|
45
|
+
- **ANIMATION_SECTION**: If using `tw-animate-css`, `framer-motion`, `react-spring`:
|
|
46
|
+
- `animate-in`, `fade-in`, `slide-in-from-*` (tw-animate-css).
|
|
47
|
+
- `motion.div`, `AnimatePresence` (framer-motion).
|
|
48
|
+
- Accessibility: `prefers-reduced-motion`.
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# Testing Strategy
|
|
2
|
+
|
|
3
|
+
## Runner
|
|
4
|
+
|
|
5
|
+
{{TEST_RUNNER_INFO}}
|
|
6
|
+
|
|
7
|
+
| Command | Purpose |
|
|
8
|
+
| ----------------- | ------- |
|
|
9
|
+
| {{TEST_COMMANDS}} |
|
|
10
|
+
|
|
11
|
+
## Test Files
|
|
12
|
+
|
|
13
|
+
```text
|
|
14
|
+
{{TEST_FILE_STRUCTURE}}
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
{{TEST_COUNT}}
|
|
18
|
+
|
|
19
|
+
## Running Specific Tests
|
|
20
|
+
|
|
21
|
+
{{SPECIFIC_TEST_COMMANDS}}
|
|
22
|
+
|
|
23
|
+
## Patterns
|
|
24
|
+
|
|
25
|
+
{{TEST_PATTERNS}}
|
|
26
|
+
|
|
27
|
+
## When Writing New Tests
|
|
28
|
+
|
|
29
|
+
{{NEW_TEST_RULES}}
|
|
30
|
+
|
|
31
|
+
## Verification
|
|
32
|
+
|
|
33
|
+
After changes to {{TESTED_AREA}}:
|
|
34
|
+
|
|
35
|
+
```
|
|
36
|
+
{{VERIFICATION_CYCLE}}
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Generation Rules
|
|
40
|
+
|
|
41
|
+
- **TEST_RUNNER_INFO**: "Vitest X.Y.Z" or "Jest X.Y.Z". If both exist, document which is used for what.
|
|
42
|
+
- **TEST_COMMANDS**: Extract from package.json scripts. Include watch mode, single-run, coverage.
|
|
43
|
+
- **TEST_FILE_STRUCTURE**: Directory tree with found test files.
|
|
44
|
+
- **TEST_COUNT**: "Total: N tests" counting all test cases. If uncountable, report "N test files".
|
|
45
|
+
- **SPECIFIC_TEST_COMMANDS**: Generate commands to run specific test files. Format:
|
|
46
|
+
```
|
|
47
|
+
# Run all tests
|
|
48
|
+
{{PM}} {{TEST_RUN_SCRIPT}}
|
|
49
|
+
|
|
50
|
+
# Run a specific test file
|
|
51
|
+
{{PM}} {{TEST_RUNNER}} {{TEST_FILE_PATH}}
|
|
52
|
+
|
|
53
|
+
# Run tests matching a pattern
|
|
54
|
+
{{PM}} {{TEST_RUNNER}} -t "test name pattern"
|
|
55
|
+
```
|
|
56
|
+
- For vitest: `bun run test path/to/file.test.ts` or `bun vitest run -t "pattern"`
|
|
57
|
+
- For jest: `npm test -- path/to/file.spec.ts` or `npx jest -t "pattern"`
|
|
58
|
+
- For playwright: `npx playwright test path/to/file.spec.ts`
|
|
59
|
+
- Read the actual test runner config to determine the correct invocation pattern.
|
|
60
|
+
- List 2-3 real test file paths as examples.
|
|
61
|
+
- **TEST_PATTERNS**:
|
|
62
|
+
- If using mocks (vi.mock, jest.mock): document what is mocked and how.
|
|
63
|
+
- If using global fixtures: document where they are.
|
|
64
|
+
- If using inline factories/builders: document the pattern.
|
|
65
|
+
- If there are type narrowing tests (type guards): document it.
|
|
66
|
+
- **NEW_TEST_RULES**: Project-specific rules for new tests (where to create, naming, what to cover).
|
|
67
|
+
- **TESTED_AREA**: "lib/" or "src/" — the main tested directory.
|
|
@@ -0,0 +1,311 @@
|
|
|
1
|
+
# Decision Matrix — Project Detection and Rule Selection
|
|
2
|
+
|
|
3
|
+
## Detection Order
|
|
4
|
+
|
|
5
|
+
Run detections in this order. Each step reads files and sets flags used by later steps.
|
|
6
|
+
|
|
7
|
+
### 1. Package manager
|
|
8
|
+
|
|
9
|
+
Check for lockfile: `bun.lock` → bun, `pnpm-lock.yaml` → pnpm, `package-lock.json` → npm, `yarn.lock` → yarn.
|
|
10
|
+
|
|
11
|
+
### 2. Project type
|
|
12
|
+
|
|
13
|
+
`workspaces` in root `package.json` → monorepo. Otherwise → single app.
|
|
14
|
+
|
|
15
|
+
### 3. Framework
|
|
16
|
+
|
|
17
|
+
| Dep found | Framework | Router detection |
|
|
18
|
+
| ------------------------ | --------- | ----------------------------------------------------------------------------------------------------------------------------------- |
|
|
19
|
+
| `next` | Next.js | `app/` has `page.tsx` or `layout.tsx` → App Router; `pages/` has `.tsx` → Pages Router; both → hybrid (treat as App Router primary) |
|
|
20
|
+
| `@nestjs/core` | NestJS | N/A |
|
|
21
|
+
| `vite` | Vite | Check `react` for React, `vue` for Vue, `svelte` for Svelte |
|
|
22
|
+
| `@angular/core` | Angular | N/A |
|
|
23
|
+
| `express` | Express | N/A |
|
|
24
|
+
| `fastify` | Fastify | N/A |
|
|
25
|
+
| `remix` / `@remix-run/*` | Remix | N/A |
|
|
26
|
+
| `astro` | Astro | N/A |
|
|
27
|
+
|
|
28
|
+
### 4. Monorepo tool (if monorepo)
|
|
29
|
+
|
|
30
|
+
| File found | Tool |
|
|
31
|
+
| -------------------------- | --------------------------------- |
|
|
32
|
+
| `turbo.json` | Turborepo |
|
|
33
|
+
| `nx.json` | Nx |
|
|
34
|
+
| `lerna.json` | Lerna |
|
|
35
|
+
| `pnpm-workspace.yaml` only | pnpm workspaces (no orchestrator) |
|
|
36
|
+
|
|
37
|
+
### 5. Language
|
|
38
|
+
|
|
39
|
+
`tsconfig.json` exists → TypeScript. Check `compilerOptions.strict: true` → strict mode.
|
|
40
|
+
|
|
41
|
+
### 6. CSS approach
|
|
42
|
+
|
|
43
|
+
| Signal | Approach |
|
|
44
|
+
| ------------------------------------------- | ---------------------------- |
|
|
45
|
+
| `tailwindcss` in deps | Tailwind CSS |
|
|
46
|
+
| `components.json` exists | shadcn/ui (implies Tailwind) |
|
|
47
|
+
| `styled-components` in deps | styled-components |
|
|
48
|
+
| `@emotion/*` in deps | Emotion |
|
|
49
|
+
| `.module.css` or `.module.scss` files found | CSS Modules |
|
|
50
|
+
| `sass` or `node-sass` in deps | Sass/SCSS |
|
|
51
|
+
| None of the above | Plain CSS / CSS imports |
|
|
52
|
+
|
|
53
|
+
### 7. Testing
|
|
54
|
+
|
|
55
|
+
| Dep found | Runner | Extra |
|
|
56
|
+
| ---------------------------------- | ---------- | ------------------------------------------------------ |
|
|
57
|
+
| `vitest` | Vitest | Check `vitest.config.*` for env (node/jsdom/happy-dom) |
|
|
58
|
+
| `jest` | Jest | Check `jest.config.*` for env |
|
|
59
|
+
| `playwright` or `@playwright/test` | Playwright | E2E tests present |
|
|
60
|
+
| `cypress` | Cypress | E2E tests present |
|
|
61
|
+
| None | — | Skip testing rules |
|
|
62
|
+
|
|
63
|
+
### 8. Validation
|
|
64
|
+
|
|
65
|
+
| Dep found | Library |
|
|
66
|
+
| ----------------- | ------------------------------------------------- |
|
|
67
|
+
| `zod` | Zod |
|
|
68
|
+
| `yup` | Yup |
|
|
69
|
+
| `class-validator` | class-validator |
|
|
70
|
+
| `valibot` | Valibot |
|
|
71
|
+
| None | Plain TypeScript (type guards, manual validation) |
|
|
72
|
+
|
|
73
|
+
### 9. ORM / Database
|
|
74
|
+
|
|
75
|
+
| Dep found | ORM | Detect provider |
|
|
76
|
+
| ------------- | ---------------- | ------------------------------------------------------------------ |
|
|
77
|
+
| `prisma` | Prisma | Read `prisma/schema.prisma` → `datasource db { provider = "..." }` |
|
|
78
|
+
| `drizzle-orm` | Drizzle | Check `drizzle.config.*` for `dialect` |
|
|
79
|
+
| `knex` | Knex | Check `knexfile.*` for client |
|
|
80
|
+
| `typeorm` | TypeORM | Check config for `type` |
|
|
81
|
+
| `mongoose` | MongoDB/Mongoose | N/A |
|
|
82
|
+
|
|
83
|
+
Provider affects ID type conventions (UUID for PostgreSQL, autoincrement for SQLite/MySQL, ObjectId for MongoDB).
|
|
84
|
+
|
|
85
|
+
### 10. State management
|
|
86
|
+
|
|
87
|
+
| Dep found | Library |
|
|
88
|
+
| ----------------------- | -------------------------- |
|
|
89
|
+
| `zustand` | Zustand |
|
|
90
|
+
| `@reduxjs/toolkit` | Redux Toolkit |
|
|
91
|
+
| `jotai` | Jotai |
|
|
92
|
+
| `valtio` | Valtio |
|
|
93
|
+
| `recoil` | Recoil |
|
|
94
|
+
| `mobx` | MobX |
|
|
95
|
+
| `xstate` | XState |
|
|
96
|
+
| `@tanstack/react-query` | React Query (server state) |
|
|
97
|
+
| `swr` | SWR (server state) |
|
|
98
|
+
| None | useState / useReducer only |
|
|
99
|
+
|
|
100
|
+
Server-state libraries (React Query, SWR) need different rules than client-state (Zustand, Redux).
|
|
101
|
+
|
|
102
|
+
### 11. API client pattern
|
|
103
|
+
|
|
104
|
+
| Signal | Pattern |
|
|
105
|
+
| ------------------------------------------ | --------------------- |
|
|
106
|
+
| `@trpc/*` in deps | tRPC |
|
|
107
|
+
| `graphql` + `@apollo/client` | GraphQL (Apollo) |
|
|
108
|
+
| `graphql` + `relay-runtime` | GraphQL (Relay) |
|
|
109
|
+
| `@tanstack/react-query` + `fetch` | REST with React Query |
|
|
110
|
+
| `swr` + `fetch` | REST with SWR |
|
|
111
|
+
| `axios` in deps | REST with Axios |
|
|
112
|
+
| Server action files (`"use server"`) found | Server Actions |
|
|
113
|
+
| `app/api/` with `route.ts` files | Next.js API Routes |
|
|
114
|
+
| `src/` with NestJS controllers | NestJS REST |
|
|
115
|
+
| None of the above | fetch() directly |
|
|
116
|
+
|
|
117
|
+
### 12. Form library
|
|
118
|
+
|
|
119
|
+
| Dep found | Library |
|
|
120
|
+
| ---------------------- | --------------------------------------- |
|
|
121
|
+
| `react-hook-form` | react-hook-form |
|
|
122
|
+
| `formik` | Formik |
|
|
123
|
+
| `@tanstack/react-form` | TanStack Form |
|
|
124
|
+
| `@hookform/resolvers` | react-hook-form + Zod/Yup resolver |
|
|
125
|
+
| None | Controlled/uncontrolled inputs manually |
|
|
126
|
+
|
|
127
|
+
### 13. Auth library
|
|
128
|
+
|
|
129
|
+
| Dep found | Library | Extra detection |
|
|
130
|
+
| ----------------------------------------- | --------------------- | ----------------------------------------------------- |
|
|
131
|
+
| `next-auth` | NextAuth v5 (Auth.js) | Check for `auth.ts`, `middleware.ts` route protection |
|
|
132
|
+
| `next-auth` v4 | NextAuth v4 | Check for `[...nextauth].ts` |
|
|
133
|
+
| `@clerk/nextjs` | Clerk | Check for `middleware.ts` |
|
|
134
|
+
| `lucia` / `lucia-auth` | Lucia | Check for `auth.ts` |
|
|
135
|
+
| `@supabase/supabase-js` + `@supabase/ssr` | Supabase Auth | Check for middleware |
|
|
136
|
+
| `firebase` + `firebase/auth` | Firebase Auth | Check for `firebase.ts` config |
|
|
137
|
+
| `@auth0/*` | Auth0 | Check for `auth0.ts` |
|
|
138
|
+
| None | No auth or custom | — |
|
|
139
|
+
|
|
140
|
+
### 14. i18n library
|
|
141
|
+
|
|
142
|
+
| Dep found | Library | Extra detection |
|
|
143
|
+
| --------------------------- | ------------- | ----------------------------------------------- |
|
|
144
|
+
| `next-intl` | next-intl | Check `i18n.ts`, `messages/`, middleware config |
|
|
145
|
+
| `react-i18next` + `i18next` | react-i18next | Check `i18n.ts`, locale JSON files |
|
|
146
|
+
| `next-i18next` | next-i18next | Check `next-i18next.config.js` |
|
|
147
|
+
| `lingui/*` | Lingui | Check `lingui.config.*` |
|
|
148
|
+
| None | No i18n | Check `lang=` in `<html>` for language hint |
|
|
149
|
+
|
|
150
|
+
### 15. Backend pattern
|
|
151
|
+
|
|
152
|
+
| Signal | Pattern |
|
|
153
|
+
| ------------------------------- | ------------------ |
|
|
154
|
+
| Files containing `"use server"` | Server Actions |
|
|
155
|
+
| `app/api/` with `route.ts` | Next.js API Routes |
|
|
156
|
+
| NestJS controllers | NestJS REST |
|
|
157
|
+
| Express/Fastify route files | REST API |
|
|
158
|
+
| tRPC routers | tRPC API |
|
|
159
|
+
| GraphQL resolvers | GraphQL API |
|
|
160
|
+
|
|
161
|
+
### 16. Linting & Quality
|
|
162
|
+
|
|
163
|
+
| File/Dep found | Tool |
|
|
164
|
+
| ---------------------- | ----------------------- |
|
|
165
|
+
| `eslint` in deps | ESLint |
|
|
166
|
+
| `eslint.config.*` | ESLint flat config |
|
|
167
|
+
| `.eslintrc.*` | ESLint legacy config |
|
|
168
|
+
| `prettier` in deps | Prettier |
|
|
169
|
+
| `.prettierrc*` | Prettier configured |
|
|
170
|
+
| `react-doctor` in deps | react-doctor |
|
|
171
|
+
| `doctor.config.*` | react-doctor configured |
|
|
172
|
+
| `biome.json` | Biome |
|
|
173
|
+
| `.oxlintrc.*` | oxlint |
|
|
174
|
+
|
|
175
|
+
## Rule File Selection
|
|
176
|
+
|
|
177
|
+
Map detected flags to rule files to generate:
|
|
178
|
+
|
|
179
|
+
| Rule File | Required When |
|
|
180
|
+
| ---------------------- | --------------------------------------------------------------------------- |
|
|
181
|
+
| `architecture.md` | Always |
|
|
182
|
+
| `frontend-patterns.md` | Has React/Next.js/Vite/Angular/Vue/Svelte frontend |
|
|
183
|
+
| `backend-patterns.md` | Has NestJS backend |
|
|
184
|
+
| `server-actions.md` | Uses server actions OR has API routes OR has NestJS/Express/Fastify backend |
|
|
185
|
+
| `styling.md` | Has Tailwind, CSS Modules, or styled-components (not plain CSS) |
|
|
186
|
+
| `forms.md` | Has react-hook-form, formik, or TanStack Form |
|
|
187
|
+
| `database.md` | Has Prisma, Drizzle, Knex, TypeORM, or Mongoose |
|
|
188
|
+
| `i18n.md` | Has next-intl, react-i18next, or similar |
|
|
189
|
+
| `testing.md` | Has test runner (vitest/jest/playwright/cypress) in devDeps |
|
|
190
|
+
| `git-workflow.md` | Always |
|
|
191
|
+
| `sdd-workflow.md` | Always |
|
|
192
|
+
|
|
193
|
+
## AGENTS.md Section Selection
|
|
194
|
+
|
|
195
|
+
Sections included in the generated AGENTS.md based on detections:
|
|
196
|
+
|
|
197
|
+
| Section | Include When |
|
|
198
|
+
| ------------------------------ | --------------------------------------------------- |
|
|
199
|
+
| Monorepo Structure | `workspaces` in package.json |
|
|
200
|
+
| Monorepo Tool Commands | Turborepo/Nx/Lerna detected |
|
|
201
|
+
| Next.js Router Convention | Next.js detected → App Router vs Pages Router rules |
|
|
202
|
+
| Zod Validation Convention | `zod` or `yup` or `valibot` in deps |
|
|
203
|
+
| Plain TS Validation Convention | No validation library, but TypeScript strict |
|
|
204
|
+
| Prisma Convention | `prisma` in deps |
|
|
205
|
+
| Drizzle Convention | `drizzle-orm` in deps |
|
|
206
|
+
| Server Actions Convention | `"use server"` files detected |
|
|
207
|
+
| tRPC Convention | tRPC detected |
|
|
208
|
+
| GraphQL Convention | GraphQL detected |
|
|
209
|
+
| Tailwind Convention | `tailwindcss` in deps |
|
|
210
|
+
| shadcn/ui Convention | `components.json` exists |
|
|
211
|
+
| CSS Modules Convention | `.module.css` files found |
|
|
212
|
+
| Styled Components Convention | `styled-components` in deps |
|
|
213
|
+
| State Management Section | Zustand/Redux/Jotai/MobX/XState in deps |
|
|
214
|
+
| Server State Section | React Query/SWR in deps |
|
|
215
|
+
| Form Library Section | react-hook-form/formik/TanStack Form in deps |
|
|
216
|
+
| i18n Section | i18n library detected |
|
|
217
|
+
| Auth Section | Auth library detected |
|
|
218
|
+
| react-doctor Convention | `doctor.config.*` or `react-doctor` in deps |
|
|
219
|
+
| UI Language Convention | Check `lang=` attribute or i18n config |
|
|
220
|
+
|
|
221
|
+
## Command Generation
|
|
222
|
+
|
|
223
|
+
Generate commands table from `package.json` `scripts`. Map `scripts` keys directly:
|
|
224
|
+
|
|
225
|
+
```json
|
|
226
|
+
{ "scripts": { "dev": "...", "build": "...", "lint": "...", "test": "..." } }
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
Becomes:
|
|
230
|
+
|
|
231
|
+
| Comando | Qué hace |
|
|
232
|
+
| ---------------- | ---------------------- |
|
|
233
|
+
| `{pm} dev` | Servidor de desarrollo |
|
|
234
|
+
| `{pm} run build` | Build de producción |
|
|
235
|
+
| `{pm} run lint` | Linting |
|
|
236
|
+
| `{pm} run test` | Tests (watch) |
|
|
237
|
+
|
|
238
|
+
Add extra rows for: `test:run` (single-run), `test:coverage`, `doctor`, `format`, `typecheck`.
|
|
239
|
+
|
|
240
|
+
Where `{pm}` = `bun` for bun (scripts without `run`), `pnpm` for pnpm, `npm run` for npm, `yarn` for yarn.
|
|
241
|
+
|
|
242
|
+
### Monorepo command generation
|
|
243
|
+
|
|
244
|
+
If monorepo with Turborepo: generate `turbo run {cmd}` variants.
|
|
245
|
+
If monorepo with pnpm: generate `pnpm --filter {pkg} {cmd}` examples.
|
|
246
|
+
If monorepo with Nx: generate `nx {cmd} {pkg}` variants.
|
|
247
|
+
|
|
248
|
+
### Verification cycle
|
|
249
|
+
|
|
250
|
+
Assemble from detected tools:
|
|
251
|
+
|
|
252
|
+
```
|
|
253
|
+
{typecheck} → {lint} → {test} → {doctor}
|
|
254
|
+
```
|
|
255
|
+
|
|
256
|
+
- `{typecheck}`: `tsc --noEmit` if TypeScript, `bunx tsc --noEmit` if bun, skip if no TS.
|
|
257
|
+
- `{lint}`: `{pm} run lint` or detected lint command.
|
|
258
|
+
- `{test}`: `{pm} run test:run` or `{pm} run test` (whichever is single-run).
|
|
259
|
+
- `{doctor}`: `{pm} doctor` or `{pm}x react-doctor@latest` if react-doctor detected. Skip if not.
|
|
260
|
+
|
|
261
|
+
### Monorepo rebuild note
|
|
262
|
+
|
|
263
|
+
If monorepo with shared packages: add note about rebuilding packages before cycle:
|
|
264
|
+
|
|
265
|
+
```
|
|
266
|
+
Si se modificaron packages compartidos ({shared_pkg_list}), ejecutar su rebuild primero:
|
|
267
|
+
{rebuild_commands}
|
|
268
|
+
```
|
|
269
|
+
|
|
270
|
+
## Framework-Specific Conventions
|
|
271
|
+
|
|
272
|
+
### Next.js App Router
|
|
273
|
+
|
|
274
|
+
- Server Components by default. `"use client"` solo cuando se usen hooks.
|
|
275
|
+
- Server actions en `lib/actions.ts` o `src/actions/`.
|
|
276
|
+
- `error.tsx`, `loading.tsx`, `not-found.tsx` por segmento.
|
|
277
|
+
- `generateMetadata()` para SEO.
|
|
278
|
+
- `next/image` para imágenes, `next/font` para fuentes.
|
|
279
|
+
- Path alias `@/*` → `./*` o `./src/*`.
|
|
280
|
+
|
|
281
|
+
### Next.js Pages Router
|
|
282
|
+
|
|
283
|
+
- `getServerSideProps`, `getStaticProps`, `getStaticPaths`.
|
|
284
|
+
- `pages/api/` para API routes.
|
|
285
|
+
- `pages/_app.tsx`, `pages/_document.tsx`.
|
|
286
|
+
- Sin server components. Todo es client o API.
|
|
287
|
+
|
|
288
|
+
### NestJS
|
|
289
|
+
|
|
290
|
+
- Módulos como directorios: `src/{feature}/{feature}.module.ts`.
|
|
291
|
+
- DTOs con decoradores. Validación con `class-validator` o `ZodValidationPipe`.
|
|
292
|
+
- Guards para auth: `@UseGuards(AuthGuard)`.
|
|
293
|
+
- `PrismaService` como provider global.
|
|
294
|
+
|
|
295
|
+
## Edge Cases
|
|
296
|
+
|
|
297
|
+
| Situation | Action |
|
|
298
|
+
| -------------------------------- | ---------------------------------------------------------------------- |
|
|
299
|
+
| No test runner | Skip testing.md, skip test from verification cycle |
|
|
300
|
+
| No lint tool | Skip lint from verification cycle |
|
|
301
|
+
| No TypeScript | Skip `tsc --noEmit`, skip no-any rule, use JSDoc conventions instead |
|
|
302
|
+
| No config files at all | Minimal defaults, note that project needs setup |
|
|
303
|
+
| Multiple frameworks | Pick primary based on root package.json, note secondary |
|
|
304
|
+
| Both App Router and Pages Router | Treat as App Router primary, note Pages Router legacy routes |
|
|
305
|
+
| No package.json scripts | Generate commands from direct tool invocations (`npx next dev`) |
|
|
306
|
+
| Bun without `bun run` scripts | Use `bunx` prefix for npx equivalents |
|
|
307
|
+
| Monorepo without workspaces | Treat each `apps/*` or `packages/*` as independent |
|
|
308
|
+
| CSS: multiple approaches | Pick primary (Tailwind wins over CSS Modules over plain CSS) |
|
|
309
|
+
| Auth: multiple libraries | Pick primary, note secondary (e.g., NextAuth for web, Clerk for admin) |
|
|
310
|
+
| i18n with Pages Router | Different routing rules than App Router i18n |
|
|
311
|
+
| Database with multiple providers | Document each, note which is primary |
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
# Example Output — sssall (Next.js 16 + Bun + Server Actions)
|
|
2
|
+
|
|
3
|
+
This is the concrete output the skill should produce for a project with this stack. Use it as a quality benchmark: your generated AGENTS.md should be this specific, this actionable, and this free of placeholder text.
|
|
4
|
+
|
|
5
|
+
## Project Signals Detected
|
|
6
|
+
|
|
7
|
+
| Signal | Detected |
|
|
8
|
+
| --------------- | ------------------------------------------------------------------------------------------------- |
|
|
9
|
+
| Package manager | Bun (`bun.lock`) |
|
|
10
|
+
| Framework | Next.js 16 App Router (`app/page.tsx`, `app/layout.tsx`) |
|
|
11
|
+
| Router type | App Router (server components default) |
|
|
12
|
+
| Language | TypeScript strict (`tsconfig.json`) |
|
|
13
|
+
| CSS | Tailwind CSS 4 + shadcn/ui New York |
|
|
14
|
+
| Testing | Vitest 4.x (5 test files, 74 tests, all in `lib/`) |
|
|
15
|
+
| Validation | Plain TypeScript (type guards: `isDownloadError()`, no Zod) |
|
|
16
|
+
| ORM | None |
|
|
17
|
+
| State | useState / useCallback only (no Zustand/Redux) |
|
|
18
|
+
| Server state | None (React Query/SWR not present) |
|
|
19
|
+
| API pattern | Server Actions (`"use server"` in `lib/actions.ts`) + REST fallback (`app/api/download/route.ts`) |
|
|
20
|
+
| Forms | Manual controlled inputs (no react-hook-form) |
|
|
21
|
+
| i18n | None (hardcoded Spanish UI) |
|
|
22
|
+
| Auth | None |
|
|
23
|
+
| Backend | None (server actions + btch-downloader) |
|
|
24
|
+
| Linting | ESLint 10 + react-doctor 0.9.3 |
|
|
25
|
+
| Monorepo | No (single app) |
|
|
26
|
+
|
|
27
|
+
## Files Generated
|
|
28
|
+
|
|
29
|
+
```
|
|
30
|
+
AGENTS.md ← 85 lines, all placeholders filled
|
|
31
|
+
.agents/rules/
|
|
32
|
+
architecture.md ← Stack table, route table, ASCII data flow diagram
|
|
33
|
+
frontend-patterns.md ← Component specs, state locations, trust boundaries
|
|
34
|
+
server-actions.md ← downloadVideo flow, DownloadResult type, rate limiter
|
|
35
|
+
testing.md ← Vitest commands, test file tree, 74 tests counted
|
|
36
|
+
git-workflow.md ← Conventional commits, pre-commit cycle
|
|
37
|
+
sdd-workflow.md ← Preflight defaults, post-apply verification
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Skipped (with reasons)
|
|
41
|
+
|
|
42
|
+
| Rule file | Reason |
|
|
43
|
+
| --------------------- | -------------------------------------------------------------------------- |
|
|
44
|
+
| `backend-patterns.md` | No NestJS backend |
|
|
45
|
+
| `styling.md` | Tailwind covered in frontend-patterns; no CSS Modules or styled-components |
|
|
46
|
+
| `forms.md` | No form library (manual controlled inputs only) |
|
|
47
|
+
| `database.md` | No ORM |
|
|
48
|
+
| `i18n.md` | No i18n library (hardcoded Spanish) |
|
|
49
|
+
|
|
50
|
+
## Key Quality Checks
|
|
51
|
+
|
|
52
|
+
Compare your generated AGENTS.md against these criteria:
|
|
53
|
+
|
|
54
|
+
1. **Commands are exact**: The AGENTS.md says `bun dev`, not `npm run dev` or `pnpm dev`. It reads `package.json` scripts: `"doctor": "npx react-doctor@latest"` → `bun doctor`.
|
|
55
|
+
2. **Verification cycle is real**: `bunx tsc --noEmit → bun run lint → bun run test:run → bun doctor`. Every command exists in `package.json`.
|
|
56
|
+
3. **Global conventions match the stack**: "Sin librería de validación externa — TypeScript types + guards manuales (`isDownloadError()`)." Not "Zod para validación."
|
|
57
|
+
4. **Architecture diagram is specific**: ASCII art shows actual directories (`app/`, `components/`, `lib/downloader/`), not generic placeholders.
|
|
58
|
+
5. **Data flow names real functions**: `detectPlatform()` → `downloadVideo()` → `downloadFromUrl()` → `ttdl()/igdl()/fbdown()/twitter()`. Not "validation → API call → database."
|
|
59
|
+
6. **Route table is complete**: Every route file listed with its type (client/server) and description in Spanish.
|
|
60
|
+
7. **Test count is accurate**: "74 tests" counted from actual test files, not estimated.
|
|
61
|
+
8. **No placeholder text anywhere**: Search for `{{`, `TODO`, `add here`, `...` in the output — there should be zero matches.
|
|
62
|
+
|
|
63
|
+
## Reference Project
|
|
64
|
+
|
|
65
|
+
The benchmark output comes from a real project with this stack. The actual generated files (relative to project root):
|
|
66
|
+
|
|
67
|
+
```
|
|
68
|
+
AGENTS.md ← Main file with commands, conventions, PR instructions
|
|
69
|
+
.agents/rules/
|
|
70
|
+
architecture.md ← Stack table, routes, ASCII data flow
|
|
71
|
+
frontend-patterns.md ← Component specs, state, trust boundaries
|
|
72
|
+
server-actions.md ← Entry points, error handling, rate limiting
|
|
73
|
+
testing.md ← Test commands, file tree, patterns
|
|
74
|
+
git-workflow.md ← Commit conventions, pre-commit cycle
|
|
75
|
+
sdd-workflow.md ← Preflight defaults, post-apply verification
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
Use this as a quality benchmark when generating for any project — your output should match this level of specificity regardless of the target stack.
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# Template Filling Guide
|
|
2
|
+
|
|
3
|
+
When filling template placeholders in `assets/*.md`, follow these concreteness rules. The output must be as specific as the example in `references/example-output/README.md`.
|
|
4
|
+
|
|
5
|
+
## Quick Decision Table
|
|
6
|
+
|
|
7
|
+
Full detection logic is in `decision-matrix.md`. This is the quick-reference table for selecting templates:
|
|
8
|
+
|
|
9
|
+
| Signal | Decision |
|
|
10
|
+
| ------------------------------------- | ------------------------------------------------------------------------------------------------- |
|
|
11
|
+
| `workspaces` in package.json | Monorepo → generate package dependency rules, shared package rebuild commands |
|
|
12
|
+
| `turbo.json`, `nx.json`, `lerna.json` | Monorepo tool → adapt commands (`turbo run`, `nx`, `lerna run`) |
|
|
13
|
+
| `next` in deps + `app/` vs `pages/` | Next.js Router type → App Router (server components default) vs Pages Router (getServerSideProps) |
|
|
14
|
+
| `@nestjs/core` | NestJS backend → module architecture, guards, DTOs |
|
|
15
|
+
| `@trpc/*` | tRPC → completely different backend rules than REST |
|
|
16
|
+
| `react-hook-form`, `formik` | Form library → generate `forms.md` |
|
|
17
|
+
| `next-intl`, `react-i18next` | i18n → generate `i18n.md` |
|
|
18
|
+
| `prisma`, `drizzle-orm` | ORM → generate `database.md` |
|
|
19
|
+
| `styled-components`, `.module.css` | Non-Tailwind CSS → generate `styling.md` with different rules |
|
|
20
|
+
| `next-auth`, `@clerk/nextjs`, `lucia` | Auth → route protection rules |
|
|
21
|
+
| `@tanstack/react-query`, `swr` | Server state → different state rules than Zustand/Redux |
|
|
22
|
+
| `vitest`, `jest`, `playwright` | Test runner(s) → generate `testing.md` with correct commands |
|
|
23
|
+
| No TypeScript | JS project → skip `tsc`, different type safety rules |
|
|
24
|
+
|
|
25
|
+
## Placeholder Filling Rules
|
|
26
|
+
|
|
27
|
+
### `{{STACK_TABLE}}`
|
|
28
|
+
|
|
29
|
+
Each row must have **exact version numbers** from `package.json`. Never write "latest" or "X.Y.Z". Format: `| Capa | Tecnología | Versión |`. Include framework, UI, runtime, ORM, validation, testing, linting, analytics, fonts.
|
|
30
|
+
|
|
31
|
+
### `{{ARCHITECTURE_DIAGRAM}}`
|
|
32
|
+
|
|
33
|
+
ASCII art using **actual directory names** from the project. Show real connections — which file imports which. No boxes labeled "Component" or "Service". For monorepos, show package dependency arrows. For single apps, show app/ → components/ + lib/ → external services.
|
|
34
|
+
|
|
35
|
+
### `{{DATA_FLOW}}`
|
|
36
|
+
|
|
37
|
+
Numbered steps with **real function names**: `detectPlatform()` not "validate input"; `ttdl(url)` not "call API". Show the complete chain: user action → frontend → backend/server action → external library/database → response → UI update. Use ASCII arrows between steps.
|
|
38
|
+
|
|
39
|
+
### `{{ROUTING_TABLE}}`
|
|
40
|
+
|
|
41
|
+
**Every route file** found in `app/` or `pages/`. Include: route path, type (server/client/API), file path, and 1-line purpose in the project's UI language. Check for: `page.tsx`, `layout.tsx`, `route.ts`, `error.tsx`, `loading.tsx`, `not-found.tsx`, `sitemap.ts`, `robots.ts`, API routes, dynamic routes.
|
|
42
|
+
|
|
43
|
+
### `{{ESSENTIAL_COMMANDS}}`
|
|
44
|
+
|
|
45
|
+
Only commands whose **script key exists** in `package.json`. Use `{pm} run <key>` or `{pm} <key>` format matching the package manager. If a script is missing, omit that row — don't invent commands. Core rows: dev, build, lint, test, test:run, test:coverage, and quality tool (doctor/lint-staged) if present.
|
|
46
|
+
|
|
47
|
+
### `{{TEST_COUNT}}`
|
|
48
|
+
|
|
49
|
+
Count actual `test()` / `it()` calls across all test files. Report `"N tests"` with the real number. If you cannot count accurately, report the number of test files: `"N test files"`.
|
|
50
|
+
Also report: test runner + version, environment (node/jsdom), coverage provider and target, strict TDD mode (yes/no).
|
|
51
|
+
|
|
52
|
+
### `{{COMMIT_EXAMPLES}}`
|
|
53
|
+
|
|
54
|
+
2-3 examples using **real file names** or feature names from the project's recent git history. Read `git log --oneline -5` if available to get realistic examples. Format: `type: message`, one per line.
|
|
55
|
+
|
|
56
|
+
### `{{VERIFICATION_CYCLE}}`
|
|
57
|
+
|
|
58
|
+
Assemble from validated commands: `{typecheck} → {lint} → {test} → {doctor}`. Only include steps whose tool exists. Use the exact command format from package.json.
|
|
59
|
+
|
|
60
|
+
### `{{GLOBAL_CONVENTIONS}}`
|
|
61
|
+
|
|
62
|
+
List 5-8 project-specific conventions. Each must be verifiable from config files, not generic advice. Examples:
|
|
63
|
+
|
|
64
|
+
- ✅ "Bun siempre. No npm ni yarn." (detected from bun.lock)
|
|
65
|
+
- ✅ "Sin librería de validación externa — TypeScript types + guards manuales." (no zod in deps)
|
|
66
|
+
- ❌ "Usar buenas prácticas de TypeScript." (generic, unverifiable)
|
|
67
|
+
- ❌ "Código limpio y documentado." (generic, unverifiable)
|
|
@@ -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
|
|
3
|
+
description: "Use agentic-awesome-skills with Jetski/Cortex without hitting context-window overflow with 2,001+ skills."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Jetski/Cortex + Gemini: safe integration with
|
|
6
|
+
# Jetski/Cortex + Gemini: safe integration with 2,001+ 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
|
|
28
|
+
With 2,001+ 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
|
|
26
|
+
This pattern avoids context overflow when you have 2,001+ skills installed.
|
|
27
27
|
|
|
28
28
|
Manifest contract references:
|
|
29
29
|
|
|
@@ -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 `
|
|
32
|
+
- present `2,001+ 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
|
|
75
|
+
- All 2,001+ skills from the skills directory
|
|
76
76
|
|
|
77
77
|
## When to Update
|
|
78
78
|
|
|
@@ -30,7 +30,7 @@ AAS MCP does not scan the repository and does not decide which skills are best.
|
|
|
30
30
|
> **Release boundary:** AAS Core landed after release 14.6.0. Use an exact Core-capable release rather than an unreviewed moving tag.
|
|
31
31
|
|
|
32
32
|
```bash
|
|
33
|
-
npm exec --yes --ignore-scripts --package=agentic-awesome-skills@15.
|
|
33
|
+
npm exec --yes --ignore-scripts --package=agentic-awesome-skills@15.8.0 -- aas mcp configure \
|
|
34
34
|
--host codex \
|
|
35
35
|
--scope user \
|
|
36
36
|
--config /absolute/path/to/codex/config.toml \
|