vibes-plug 1.0.0 → 2.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (183) hide show
  1. package/.claude/rules/vibes-plug-core.md +32 -0
  2. package/.cursor/rules/vibes-plug-core.mdc +51 -0
  3. package/.cursorrules +42 -0
  4. package/AGENTS.md +96 -0
  5. package/BLUEPRINT.md +309 -125
  6. package/CHANGELOG.md +183 -1
  7. package/CLAUDE.md +70 -0
  8. package/LICENSE +1 -1
  9. package/README.md +641 -263
  10. package/index.js +19 -0
  11. package/package.json +61 -25
  12. package/plugin.json +24 -7
  13. package/scripts/generate_swarm_gif.py +295 -0
  14. package/scripts/install.js +201 -0
  15. package/skills/accessibility-testing-expert/SKILL.md +116 -0
  16. package/skills/ai-cost-token-optimizer/SKILL.md +82 -0
  17. package/skills/ai-evals-benchmark-expert/SKILL.md +188 -0
  18. package/skills/ai-llm-integration-expert/SKILL.md +147 -122
  19. package/skills/ai-media-generation-expert/SKILL.md +172 -0
  20. package/skills/ai-prompt-engineering-expert/SKILL.md +84 -0
  21. package/skills/angular-expert/SKILL.md +148 -0
  22. package/skills/api-design-expert/SKILL.md +316 -309
  23. package/skills/api-gateway-proxy-expert/SKILL.md +81 -0
  24. package/skills/app-analyzer-optimizer/SKILL.md +195 -188
  25. package/skills/apple-ecosystem-expert/SKILL.md +145 -0
  26. package/skills/{asisten_ramah → asisten-ramah}/SKILL.md +7 -1
  27. package/skills/astro-framework-expert/SKILL.md +200 -0
  28. package/skills/async-queue-temporal-expert/SKILL.md +240 -0
  29. package/skills/authentication-identity-expert/SKILL.md +279 -45
  30. package/skills/auto-doc-updater/SKILL.md +219 -203
  31. package/skills/autonomous-chaos-monkey/SKILL.md +63 -0
  32. package/skills/autonomous-red-teamer/SKILL.md +203 -0
  33. package/skills/autonomous-tdd-debugger/SKILL.md +71 -0
  34. package/skills/background-jobs-queue-expert/SKILL.md +235 -0
  35. package/skills/biome-linter-formatter-expert/SKILL.md +89 -0
  36. package/skills/blockchain-web3-expert/SKILL.md +115 -0
  37. package/skills/bootstrap-to-modern/SKILL.md +93 -86
  38. package/skills/brainstorming/SKILL.md +381 -353
  39. package/skills/browser-automation-expert/SKILL.md +222 -0
  40. package/skills/bun-runtime-expert/SKILL.md +7 -1
  41. package/skills/chatbot-messaging-expert/SKILL.md +114 -0
  42. package/skills/ci-cd-devops-architect/SKILL.md +81 -45
  43. package/skills/cloud-hosting-expert/SKILL.md +249 -243
  44. package/skills/coderabbit/SKILL.md +197 -191
  45. package/skills/compliance-gdpr-privacy-expert/SKILL.md +85 -0
  46. package/skills/cron-scheduler-expert/SKILL.md +304 -0
  47. package/skills/data-pipeline-etl-expert/SKILL.md +84 -0
  48. package/skills/data-telemetry-expert/SKILL.md +218 -212
  49. package/skills/data-visualization-expert/SKILL.md +154 -0
  50. package/skills/database-migration-versioning-expert/SKILL.md +90 -0
  51. package/skills/database-orm-expert/SKILL.md +303 -293
  52. package/skills/dependency-upgrade-migrator/SKILL.md +301 -0
  53. package/skills/design-system-architect/SKILL.md +278 -242
  54. package/skills/desktop-electron-expert/SKILL.md +128 -0
  55. package/skills/documentation-site-expert/SKILL.md +59 -0
  56. package/skills/doku-mcp-server/SKILL.md +257 -0
  57. package/skills/doku-payment-gateway/SKILL.md +233 -0
  58. package/skills/domain-driven-design-expert/SKILL.md +82 -0
  59. package/skills/e2e-testing-expert/SKILL.md +320 -314
  60. package/skills/ecommerce-expert/SKILL.md +87 -0
  61. package/skills/edge-serverless-db-expert/SKILL.md +99 -0
  62. package/skills/email-notification-expert/SKILL.md +368 -0
  63. package/skills/error-resilience-expert/SKILL.md +486 -0
  64. package/skills/event-driven-architect/SKILL.md +86 -80
  65. package/skills/feature-flag-analytics-expert/SKILL.md +66 -0
  66. package/skills/file-upload-media-expert/SKILL.md +437 -0
  67. package/skills/firebase-security-expert/SKILL.md +7 -1
  68. package/skills/form-validation-expert/SKILL.md +407 -0
  69. package/skills/fullstack-expert/SKILL.md +260 -201
  70. package/skills/fullstack-expert/references/api_design_guide.md +466 -466
  71. package/skills/fullstack-expert/references/multi_language_backend.md +528 -528
  72. package/skills/fullstack-expert/scripts/api_contract_validator.py +253 -253
  73. package/skills/fullstack-expert/scripts/architecture_analyzer.py +326 -326
  74. package/skills/gemini-agent-booster/SKILL.md +142 -104
  75. package/skills/geospatial-maps-expert/SKILL.md +80 -0
  76. package/skills/global-a11y-i18n-expert/SKILL.md +86 -80
  77. package/skills/glsl-shader-expert/SKILL.md +107 -0
  78. package/skills/go-programming-expert/SKILL.md +300 -294
  79. package/skills/graph-rag-knowledge-expert/SKILL.md +159 -0
  80. package/skills/graphql-apollo-expert/SKILL.md +114 -0
  81. package/skills/headless-cms-expert/SKILL.md +181 -0
  82. package/skills/hig/SKILL.md +193 -187
  83. package/skills/js-backend-expert/SKILL.md +218 -191
  84. package/skills/legacy-code-translator/SKILL.md +71 -0
  85. package/skills/local-slm-edge-ai-expert/SKILL.md +167 -0
  86. package/skills/logging-error-tracking-expert/SKILL.md +344 -0
  87. package/skills/mcp-client-orchestrator/SKILL.md +76 -0
  88. package/skills/mcp-server-architect/SKILL.md +226 -126
  89. package/skills/micro-frontend-architect/SKILL.md +112 -0
  90. package/skills/mobile-expo-expert/SKILL.md +191 -185
  91. package/skills/mobile-push-notification-expert/SKILL.md +71 -0
  92. package/skills/modern-css-native-expert/SKILL.md +189 -0
  93. package/skills/monday-design-aesthetic/SKILL.md +72 -66
  94. package/skills/monorepo-architect/SKILL.md +232 -226
  95. package/skills/mpa-orchestrator/SKILL.md +120 -101
  96. package/skills/multi-agent-orchestration/SKILL.md +173 -153
  97. package/skills/multiple-entry-points/SKILL.md +91 -55
  98. package/skills/mvc-expert/SKILL.md +237 -231
  99. package/skills/n8n-automation-expert/SKILL.md +89 -0
  100. package/skills/nextjs-app-router-expert/SKILL.md +148 -0
  101. package/skills/openapi-swagger-codegen-expert/SKILL.md +67 -0
  102. package/skills/payment-gateway-expert/SKILL.md +129 -45
  103. package/skills/pdf-document-generation-expert/SKILL.md +91 -0
  104. package/skills/performance-web-vitals/SKILL.md +337 -331
  105. package/skills/post-quantum-crypto-migrator/SKILL.md +57 -0
  106. package/skills/prd-architect/SKILL.md +206 -190
  107. package/skills/proactive-background-watcher/SKILL.md +68 -0
  108. package/skills/production-ready-hardener/PRODUCTION_READINESS_REPORT.md +67 -0
  109. package/skills/production-ready-hardener/SKILL.md +461 -468
  110. package/skills/production-ready-hardener/references/production_checklist.md +161 -161
  111. package/skills/production-ready-hardener/scripts/production_readiness_scanner.py +881 -875
  112. package/skills/project-context-mapper/SKILL.md +85 -0
  113. package/skills/pwa-offline-first-expert/SKILL.md +185 -0
  114. package/skills/python-programming-expert/SKILL.md +407 -270
  115. package/skills/rate-limit-abuse-prevention/SKILL.md +377 -0
  116. package/skills/realtime-collaboration-expert/SKILL.md +99 -45
  117. package/skills/rich-text-editor-expert/SKILL.md +177 -0
  118. package/skills/rust-programming-expert/SKILL.md +240 -234
  119. package/skills/saas-billing/SKILL.md +382 -376
  120. package/skills/saas-multi-tenant/SKILL.md +256 -236
  121. package/skills/saas-mvp-launcher/SKILL.md +30 -1
  122. package/skills/saas-transformer/SKILL.md +499 -445
  123. package/skills/saas-transformer/references/billing_integration_guide.md +401 -401
  124. package/skills/saas-transformer/references/feature_gating_patterns.md +137 -137
  125. package/skills/saas-transformer/references/saas_transformation_checklist.md +121 -121
  126. package/skills/saas-transformer/scripts/saas_transformation_scanner.py +39 -29
  127. package/skills/scalability-clean-code/SKILL.md +234 -228
  128. package/skills/search-engine-expert/SKILL.md +89 -0
  129. package/skills/secure-fuzz-testing/SKILL.md +7 -1
  130. package/skills/self-evolving-memory-graph/SKILL.md +91 -0
  131. package/skills/self-healing-cloud-orchestrator/SKILL.md +57 -0
  132. package/skills/senior-frontend/SKILL.md +85 -105
  133. package/skills/seo/SKILL.md +258 -224
  134. package/skills/session-context-loader/SKILL.md +83 -0
  135. package/skills/session-handoff-resume/SKILL.md +163 -157
  136. package/skills/{skill_baru → skill-baru}/SKILL.md +177 -146
  137. package/skills/solidjs-expert/SKILL.md +80 -0
  138. package/skills/spa-orchestrator/SKILL.md +306 -287
  139. package/skills/sse-websocket-streaming-expert/SKILL.md +93 -0
  140. package/skills/state-management-expert/SKILL.md +277 -271
  141. package/skills/supabase-migration/SKILL.md +47 -1
  142. package/skills/supabase-security-expert/SKILL.md +248 -242
  143. package/skills/svelte-sveltekit-expert/SKILL.md +91 -0
  144. package/skills/svg-animation-motion-expert/SKILL.md +115 -0
  145. package/skills/tailwind-expert/SKILL.md +139 -187
  146. package/skills/tanstack-query-expert/SKILL.md +204 -198
  147. package/skills/tauri-expert/SKILL.md +7 -1
  148. package/skills/token-saver/SKILL.md +118 -110
  149. package/skills/typescript-expert/SKILL.md +329 -278
  150. package/skills/ui-components-expert/SKILL.md +166 -63
  151. package/skills/ui-ux-pro-max/SKILL.md +221 -200
  152. package/skills/vector-db-rag-expert/SKILL.md +208 -0
  153. package/skills/vibe-code-gardener/SKILL.md +180 -172
  154. package/skills/visual-qa-vision-agent/SKILL.md +71 -0
  155. package/skills/voice-ai-realtime-agent/SKILL.md +202 -0
  156. package/skills/vue-frontend-expert/SKILL.md +132 -0
  157. package/skills/wasm-edge-computing-expert/SKILL.md +97 -0
  158. package/skills/web-3d-graphics-expert/SKILL.md +137 -0
  159. package/skills/web-game-engine-expert/SKILL.md +102 -0
  160. package/skills/web-scraper/SKILL.md +98 -146
  161. package/skills/website-design-cloner/SKILL.md +180 -0
  162. package/skills/webxr-ar-vr-expert/SKILL.md +123 -0
  163. package/skills/wordpress-headless-expert/SKILL.md +144 -0
  164. package/skills/zero-to-prod-orchestrator/SKILL.md +231 -180
  165. package/skills/zero-trust-secret-vault/SKILL.md +88 -0
  166. package/.github/ISSUE_TEMPLATE/feature_request.md +0 -20
  167. package/CONTRIBUTING.md +0 -199
  168. package/SECURITY.md +0 -21
  169. package/banner.png +0 -0
  170. package/skills/senior-fullstack/SKILL.md +0 -167
  171. package/skills/senior-fullstack/references/architecture_patterns.md +0 -160
  172. package/skills/senior-fullstack/references/development_workflows.md +0 -222
  173. package/skills/senior-fullstack/references/tech_stack_guide.md +0 -190
  174. package/skills/senior-fullstack/scripts/code_quality_analyzer.py +0 -114
  175. package/skills/senior-fullstack/scripts/fullstack_scaffolder.py +0 -114
  176. package/skills/senior-fullstack/scripts/project_scaffolder.py +0 -114
  177. package/skills/seo-aeo-landing-page-writer/SKILL.md +0 -97
  178. package/skills/seo-geo/SKILL.md +0 -188
  179. package/skills/ui-ux-pro-max/scripts/__pycache__/core.cpython-310.pyc +0 -0
  180. package/skills/ui-ux-pro-max/scripts/__pycache__/core.cpython-312.pyc +0 -0
  181. package/skills/ui-ux-pro-max/scripts/__pycache__/design_system.cpython-310.pyc +0 -0
  182. package/skills/ui-ux-pro-max/scripts/__pycache__/design_system.cpython-312.pyc +0 -0
  183. package/skills/ui_ux_expert/SKILL.md +0 -114
@@ -1,225 +1,259 @@
1
- ---
2
- name: seo
3
- description: "Run a broad SEO audit across technical SEO, on-page SEO, schema, sitemaps, content quality, AI search readiness, and GEO / Audit SEO menyeluruh (Technical, On-Page, Schema, Sitemap, E-E-A-T, GEO)"
1
+ ---
2
+ name: seo
3
+ description: "Run a broad SEO audit across technical SEO, on-page SEO, schema, sitemaps, content quality, AI search readiness, and GEO / Audit SEO menyeluruh (Technical, On-Page, Schema, Sitemap, E-E-A-T, GEO)"
4
4
  author: "Roedy Rustam"
5
- ---
6
-
7
- # SEO Expert (2026 — AI Mode & Core Web Vitals Edition)
8
-
9
- [English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
10
-
11
- ---
12
-
13
- <a name="english"></a>
14
- ## English
15
-
16
- ### Description
17
- Comprehensive SEO audit covering technical SEO, on-page optimization, structured data, sitemaps, Core Web Vitals, E-E-A-T signals, and **Generative Engine Optimization (GEO)** for AI-powered search (Google AI Mode, ChatGPT Search, Perplexity).
18
-
19
- ### Trigger Conditions
20
- - Running a full SEO audit on an existing web application.
21
- - Optimizing technical SEO for a new Next.js / Astro site.
22
- - Adding structured data (JSON-LD) for rich results and AI citation.
23
- - Optimizing Core Web Vitals (LCP, INP, CLS).
24
- - Preparing a site for Google AI Mode and ChatGPT Search indexing.
25
- - Setting up a sitemap and `robots.txt`.
26
-
27
- ### 2026 SEO Landscape Changes
28
-
29
- | 2024 (Old) | 2026 (Current) |
30
- |---|---|
31
- | AI Overviews (SGE) | **Google AI Mode** — integrated AI answers |
32
- | FID metric (deprecated) | **INP** (Interaction to Next Paint) |
33
- | Keyword density focus | **Topical authority + E-E-A-T** |
34
- | Backlinks only | **Citations in AI responses** |
35
- | `robots.txt` only | `robots.txt` + **`/llms.txt`** |
36
-
37
- ### Technical SEO Checklist
38
-
39
- #### Core Web Vitals (2026 Targets)
40
- ```
41
- LCP (Largest Contentful Paint) < 2.5s
42
- INP (Interaction to Next Paint) < 200ms ← replaced FID
43
- CLS (Cumulative Layout Shift) < 0.1
44
- TTFB (Time to First Byte) < 600ms
45
- ```
46
-
47
- **INP Optimization** (the new critical metric):
48
- ```typescript
49
- // INP is degraded by long tasks blocking the main thread
50
- // Solution: Use React's useTransition to defer non-critical updates
51
- import { useTransition } from 'react';
52
-
53
- function SearchInput() {
54
- const [isPending, startTransition] = useTransition();
55
-
56
- const handleChange = (e: React.ChangeEvent<HTMLInputElement>) => {
57
- startTransition(() => {
58
- // Defer the expensive filtering to not block INP
59
- setFilteredResults(filterData(e.target.value));
60
- });
61
- };
62
- return <input onChange={handleChange} />;
63
- }
64
- ```
65
-
66
- #### Crawlability & Indexing
67
- ```typescript
68
- // Next.js 15 — metadata API for complete SEO
69
- // app/layout.tsx
70
- export const metadata: Metadata = {
71
- metadataBase: new URL('https://myapp.com'),
72
- title: {
73
- default: 'My SaaS One-line value proposition',
74
- template: '%s | My SaaS',
75
- },
76
- description: '150 characters max. Include primary keyword naturally.',
77
- openGraph: {
78
- type: 'website',
79
- url: 'https://myapp.com',
80
- siteName: 'My SaaS',
81
- images: [{ url: '/og.png', width: 1200, height: 630 }],
82
- },
83
- twitter: { card: 'summary_large_image', creator: '@handle' },
84
- robots: { index: true, follow: true },
85
- alternates: { canonical: 'https://myapp.com' },
86
- };
87
- ```
88
-
89
- ```typescript
90
- // Dynamic sitemap.ts (Next.js App Router)
91
- // app/sitemap.ts
92
- import { MetadataRoute } from 'next';
93
-
94
- export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
95
- const posts = await getBlogPosts();
96
-
97
- return [
98
- { url: 'https://myapp.com', lastModified: new Date(), changeFrequency: 'weekly', priority: 1 },
99
- { url: 'https://myapp.com/features', lastModified: new Date(), changeFrequency: 'monthly', priority: 0.8 },
100
- ...posts.map(p => ({
101
- url: `https://myapp.com/blog/${p.slug}`,
102
- lastModified: new Date(p.updatedAt),
103
- changeFrequency: 'monthly' as const,
104
- priority: 0.6,
105
- })),
106
- ];
107
- }
108
- ```
109
-
110
- ### Structured Data (JSON-LD) for AI Citation
111
- ```html
112
- <!-- Organization schema — establishes brand entity -->
113
- <script type="application/ld+json">
114
- {
115
- "@context": "https://schema.org",
116
- "@type": "Organization",
117
- "name": "My SaaS",
118
- "url": "https://myapp.com",
119
- "logo": "https://myapp.com/logo.png",
120
- "sameAs": [
121
- "https://twitter.com/myapp",
122
- "https://linkedin.com/company/myapp"
123
- ],
124
- "contactPoint": {
125
- "@type": "ContactPoint",
126
- "contactType": "customer support",
127
- "email": "support@myapp.com"
128
- }
129
- }
130
- </script>
131
-
132
- <!-- SoftwareApplication schema for SaaS products -->
133
- <script type="application/ld+json">
134
- {
135
- "@context": "https://schema.org",
136
- "@type": "SoftwareApplication",
137
- "name": "My SaaS",
138
- "applicationCategory": "BusinessApplication",
139
- "operatingSystem": "Web",
140
- "offers": {
141
- "@type": "Offer",
142
- "price": "0",
143
- "priceCurrency": "USD",
144
- "description": "Free tier available"
145
- },
146
- "aggregateRating": {
147
- "@type": "AggregateRating",
148
- "ratingValue": "4.8",
149
- "reviewCount": "247"
150
- }
151
- }
152
- </script>
153
- ```
154
-
155
- ### GEO — Google AI Mode Optimization
156
- Google AI Mode (formerly AI Overviews) now powers the top of search results:
157
- - **Be the source**: Write comprehensive, authoritative content on your core topics.
158
- - **Q&A format**: Structure content as questions and answers — AI Mode quotes these directly.
159
- - **Factual and specific**: Include statistics, named entities, and dates.
160
- - **`/llms.txt`**: Add an AI-readable site index (see `seo-geo` skill).
161
- - **Speed**: AI Mode favors fast-loading pages (TTFB < 600ms).
162
-
163
- ### On-Page SEO Standards
164
- ```
165
- H1: One per page — primary keyword, compelling, < 60 chars
166
- H2: Section headers secondary keywords
167
- H3: Sub-sections long-tail keywords, FAQ answers
168
- Meta Title: < 60 chars — keyword + brand
169
- Meta Description: < 155 chars keyword + CTA + benefit
170
- URL: lowercase, hyphens, keyword-in-slug, < 5 segments
171
- Images: Descriptive alt text, WebP format, lazy loading
172
- Internal links: 3-5 per long-form page to related content
173
- ```
174
-
175
- ---
176
-
177
- <a name="bahasa-indonesia"></a>
178
- ## Bahasa Indonesia
179
-
180
- ### Deskripsi
181
- Audit SEO komprehensif mencakup SEO teknikal, optimasi on-page, data terstruktur, sitemap, Core Web Vitals, sinyal E-E-A-T, dan **Generative Engine Optimization (GEO)** untuk pencarian bertenaga AI (Google AI Mode, ChatGPT Search, Perplexity).
182
-
183
- ### Kondisi Pemicu
184
- - Menjalankan audit SEO penuh pada aplikasi web yang ada.
185
- - Mengoptimalkan SEO teknikal untuk situs Next.js / Astro baru.
186
- - Menambahkan data terstruktur (JSON-LD) untuk rich result dan kutipan AI.
187
- - Mengoptimalkan Core Web Vitals (LCP, INP, CLS).
188
- - Mempersiapkan situs untuk indexing Google AI Mode dan ChatGPT Search.
189
-
190
- ### Perubahan Lanskap SEO 2026
191
-
192
- | 2024 (Lama) | 2026 (Sekarang) |
193
- |---|---|
194
- | AI Overviews (SGE) | **Google AI Mode** jawaban AI terintegrasi |
195
- | Metrik FID (dihentikan) | **INP** (Interaction to Next Paint) |
196
- | Fokus kepadatan keyword | **Otoritas topikal + E-E-A-T** |
197
- | Hanya backlink | **Kutipan dalam respons AI** |
198
- | Hanya `robots.txt` | `robots.txt` + **`/llms.txt`** |
199
-
200
- ### Checklist SEO Teknikal
201
-
202
- #### Core Web Vitals (Target 2026)
203
- - LCP < 2.5 detik
204
- - **INP < 200ms** ← menggantikan FID
205
- - CLS < 0.1
206
- - TTFB < 600ms
207
-
208
- **Optimasi INP**: Metrik kritis baru yang mengukur responsivitas interaksi. Gunakan `useTransition` React untuk menunda pembaruan non-kritis agar tidak memblokir thread utama.
209
-
210
- #### Crawlability & Indexing
211
- Gunakan Metadata API Next.js 15 untuk SEO lengkap: `title`, `description`, `openGraph`, `twitter`, `robots`, `alternates.canonical`. Buat sitemap dinamis dengan `app/sitemap.ts` yang menyertakan semua halaman statis dan konten dinamis.
212
-
213
- ### Data Terstruktur (JSON-LD) untuk Kutipan AI
214
- Tambahkan schema `Organization` untuk membangun entitas merek dan schema `SoftwareApplication` untuk produk SaaS — termasuk `aggregateRating` jika tersedia.
215
-
216
- ### GEO Optimasi Google AI Mode
217
- Google AI Mode (sebelumnya AI Overviews) kini mendukung bagian atas hasil pencarian:
218
- - Tulis konten yang komprehensif dan otoritatif tentang topik inti.
219
- - Strukturkan konten sebagai Q&A AI Mode langsung mengutip ini.
220
- - Sertakan statistik, entitas bernama, dan tanggal.
221
- - Tambahkan `/llms.txt` sebagai indeks situs yang dapat dibaca AI.
222
- - Kecepatan: AI Mode lebih memilih halaman yang memuat cepat (TTFB < 600ms).
223
-
224
- ### Standar SEO On-Page
225
- H1 satu per halaman, H2 untuk header seksi, meta title < 60 karakter, meta deskripsi < 155 karakter, URL lowercase dengan tanda hubung dan keyword di slug, alt text deskriptif untuk semua gambar, 3-5 internal link per halaman long-form.
5
+ ---
6
+
7
+ # SEO Expert (2026 — AI Mode & Core Web Vitals Edition)
8
+
9
+ [English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
10
+
11
+ ---
12
+
13
+ <a name="english"></a>
14
+ ## English
15
+
16
+ ### Orchestration & Integration
17
+ Connects and orchestrates with relevant domain skills like `brainstorming`, `zero-to-prod-orchestrator`, and `project-context-mapper` to ensure cohesive execution.
18
+
19
+ ### Description
20
+ Comprehensive SEO audit covering technical SEO, on-page optimization, structured data, sitemaps, Core Web Vitals, E-E-A-T signals, and **Generative Engine Optimization (GEO)** for AI-powered search (Google AI Mode, ChatGPT Search, Perplexity).
21
+
22
+ ### Trigger Conditions
23
+ - Running a full SEO audit on an existing web application.
24
+ - Optimizing technical SEO for a new Next.js / Astro site.
25
+ - Adding structured data (JSON-LD) for rich results and AI citation.
26
+ - Optimizing Core Web Vitals (LCP, INP, CLS).
27
+ - Preparing a site for Google AI Mode and ChatGPT Search indexing.
28
+ - Setting up a sitemap and `robots.txt`.
29
+
30
+ ### 2026 SEO Landscape Changes
31
+
32
+ | 2024 (Old) | 2026 (Current) |
33
+ |---|---|
34
+ | AI Overviews (SGE) | **Google AI Mode** — integrated AI answers |
35
+ | FID metric (deprecated) | **INP** (Interaction to Next Paint) |
36
+ | Keyword density focus | **Topical authority + E-E-A-T** |
37
+ | Backlinks only | **Citations in AI responses** |
38
+ | `robots.txt` only | `robots.txt` + **`/llms.txt`** |
39
+
40
+ ### Technical SEO Checklist
41
+
42
+ #### Core Web Vitals (2026 Targets)
43
+ ```
44
+ LCP (Largest Contentful Paint) < 2.5s
45
+ INP (Interaction to Next Paint) < 200ms ← replaced FID
46
+ CLS (Cumulative Layout Shift) < 0.1
47
+ TTFB (Time to First Byte) < 600ms
48
+ ```
49
+
50
+ **INP Optimization** (the new critical metric):
51
+ ```typescript
52
+ // INP is degraded by long tasks blocking the main thread
53
+ // Solution: Use React's useTransition to defer non-critical updates
54
+ import { useTransition } from 'react';
55
+
56
+ function SearchInput() {
57
+ const [isPending, startTransition] = useTransition();
58
+
59
+ const handleChange = (e: React.ChangeEvent<HTMLInputElement>) => {
60
+ startTransition(() => {
61
+ // Defer the expensive filtering to not block INP
62
+ setFilteredResults(filterData(e.target.value));
63
+ });
64
+ };
65
+ return <input onChange={handleChange} />;
66
+ }
67
+ ```
68
+
69
+ #### Crawlability & Indexing
70
+ ```typescript
71
+ // Next.js 15 — metadata API for complete SEO
72
+ // app/layout.tsx
73
+ export const metadata: Metadata = {
74
+ metadataBase: new URL('https://myapp.com'),
75
+ title: {
76
+ default: 'My SaaS One-line value proposition',
77
+ template: '%s | My SaaS',
78
+ },
79
+ description: '150 characters max. Include primary keyword naturally.',
80
+ openGraph: {
81
+ type: 'website',
82
+ url: 'https://myapp.com',
83
+ siteName: 'My SaaS',
84
+ images: [{ url: '/og.png', width: 1200, height: 630 }],
85
+ },
86
+ twitter: { card: 'summary_large_image', creator: '@handle' },
87
+ robots: { index: true, follow: true },
88
+ alternates: { canonical: 'https://myapp.com' },
89
+ };
90
+ ```
91
+
92
+ ```typescript
93
+ // Dynamic sitemap.ts (Next.js App Router)
94
+ // app/sitemap.ts
95
+ import { MetadataRoute } from 'next';
96
+
97
+ export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
98
+ const posts = await getBlogPosts();
99
+
100
+ return [
101
+ { url: 'https://myapp.com', lastModified: new Date(), changeFrequency: 'weekly', priority: 1 },
102
+ { url: 'https://myapp.com/features', lastModified: new Date(), changeFrequency: 'monthly', priority: 0.8 },
103
+ ...posts.map(p => ({
104
+ url: `https://myapp.com/blog/${p.slug}`,
105
+ lastModified: new Date(p.updatedAt),
106
+ changeFrequency: 'monthly' as const,
107
+ priority: 0.6,
108
+ })),
109
+ ];
110
+ }
111
+ ```
112
+
113
+ ### Structured Data (JSON-LD) for AI Citation
114
+ ```html
115
+ <!-- Organization schema — establishes brand entity -->
116
+ <script type="application/ld+json">
117
+ {
118
+ "@context": "https://schema.org",
119
+ "@type": "Organization",
120
+ "name": "My SaaS",
121
+ "url": "https://myapp.com",
122
+ "logo": "https://myapp.com/logo.png",
123
+ "sameAs": [
124
+ "https://twitter.com/myapp",
125
+ "https://linkedin.com/company/myapp"
126
+ ],
127
+ "contactPoint": {
128
+ "@type": "ContactPoint",
129
+ "contactType": "customer support",
130
+ "email": "support@myapp.com"
131
+ }
132
+ }
133
+ </script>
134
+
135
+ <!-- SoftwareApplication schema for SaaS products -->
136
+ <script type="application/ld+json">
137
+ {
138
+ "@context": "https://schema.org",
139
+ "@type": "SoftwareApplication",
140
+ "name": "My SaaS",
141
+ "applicationCategory": "BusinessApplication",
142
+ "operatingSystem": "Web",
143
+ "offers": {
144
+ "@type": "Offer",
145
+ "price": "0",
146
+ "priceCurrency": "USD",
147
+ "description": "Free tier available"
148
+ },
149
+ "aggregateRating": {
150
+ "@type": "AggregateRating",
151
+ "ratingValue": "4.8",
152
+ "reviewCount": "247"
153
+ }
154
+ }
155
+ </script>
156
+ ```
157
+
158
+ ### GEO Google AI Mode Optimization
159
+ Google AI Mode (formerly AI Overviews) now powers the top of search results:
160
+ - **Be the source**: Write comprehensive, authoritative content on your core topics.
161
+ - **Q&A format**: Structure content as questions and answers AI Mode quotes these directly.
162
+ - **AEO Extraction Sentence**: Write one 25–40 word sentence that answers "What is [product]?" immediately after the H1. This is the sentence AI engines extract.
163
+ - **Factual and specific**: Include statistics, named entities, and dates.
164
+ - **Speed**: AI Mode favors fast-loading pages (TTFB < 600ms).
165
+
166
+ #### The 2026 AI Search Landscape
167
+ | AI Engine | Source | Citable Content | Key Signal |
168
+ |---|---|---|---|
169
+ | **Google AI Mode** | Google index + Gemini | Yes — with source links | E-E-A-T, structured data |
170
+ | **ChatGPT Search** | Bing index + GPT-4o | Yes — with citations | Bing ranking, freshness |
171
+ | **Perplexity** | Real-time web crawl | Yes — prominent citations | Authority, specificity |
172
+
173
+ #### `/llms.txt` — AI Indexing Protocol
174
+ Add an `/llms.txt` file at your domain root:
175
+ ```
176
+ # /llms.txt
177
+ # AI-friendly site map for LLM indexers
178
+ ## Product
179
+ - [Features](/features): Complete feature list with pricing
180
+ ## Content
181
+ - [Blog](/blog): Technical articles
182
+ ```
183
+
184
+ #### Landing Page SEO/AEO Narrative Arc
185
+ Follow this exact order for landing pages:
186
+ 1. Hero H1 + AEO sentence + CTA
187
+ 2. Problem Audience pain, no product mention yet
188
+ 3. Solution Introduce product as the answer
189
+ 4. Features as Benefits — Table format
190
+ 5. Social Proof & FAQ (under 50 words each)
191
+
192
+ ### On-Page SEO Standards
193
+ ```
194
+ H1: One per page primary keyword, compelling, < 60 chars
195
+ H2: Section headers secondary keywords
196
+ H3: Sub-sections long-tail keywords, FAQ answers
197
+ Meta Title: < 60 chars keyword + brand
198
+ Meta Description: < 155 chars — keyword + CTA + benefit
199
+ URL: lowercase, hyphens, keyword-in-slug, < 5 segments
200
+ Images: Descriptive alt text, WebP format, lazy loading
201
+ Internal links: 3-5 per long-form page to related content
202
+ ```
203
+
204
+ ---
205
+
206
+ <a name="bahasa-indonesia"></a>
207
+ ## Bahasa Indonesia
208
+
209
+ ### Integrasi Orkestrasi
210
+ Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `project-context-mapper` untuk memastikan eksekusi yang kohesif.
211
+
212
+ ### Deskripsi
213
+ Audit SEO komprehensif mencakup SEO teknikal, optimasi on-page, data terstruktur, sitemap, Core Web Vitals, sinyal E-E-A-T, dan **Generative Engine Optimization (GEO)** untuk pencarian bertenaga AI (Google AI Mode, ChatGPT Search, Perplexity).
214
+
215
+ ### Kondisi Pemicu
216
+ - Menjalankan audit SEO penuh pada aplikasi web yang ada.
217
+ - Mengoptimalkan SEO teknikal untuk situs Next.js / Astro baru.
218
+ - Menambahkan data terstruktur (JSON-LD) untuk rich result dan kutipan AI.
219
+ - Mengoptimalkan Core Web Vitals (LCP, INP, CLS).
220
+ - Mempersiapkan situs untuk indexing Google AI Mode dan ChatGPT Search.
221
+
222
+ ### Perubahan Lanskap SEO 2026
223
+
224
+ | 2024 (Lama) | 2026 (Sekarang) |
225
+ |---|---|
226
+ | AI Overviews (SGE) | **Google AI Mode** — jawaban AI terintegrasi |
227
+ | Metrik FID (dihentikan) | **INP** (Interaction to Next Paint) |
228
+ | Fokus kepadatan keyword | **Otoritas topikal + E-E-A-T** |
229
+ | Hanya backlink | **Kutipan dalam respons AI** |
230
+ | Hanya `robots.txt` | `robots.txt` + **`/llms.txt`** |
231
+
232
+ ### Checklist SEO Teknikal
233
+
234
+ #### Core Web Vitals (Target 2026)
235
+ - LCP < 2.5 detik
236
+ - **INP < 200ms** ← menggantikan FID
237
+ - CLS < 0.1
238
+ - TTFB < 600ms
239
+
240
+ **Optimasi INP**: Metrik kritis baru yang mengukur responsivitas interaksi. Gunakan `useTransition` React untuk menunda pembaruan non-kritis agar tidak memblokir thread utama.
241
+
242
+ #### Crawlability & Indexing
243
+ Gunakan Metadata API Next.js 15 untuk SEO lengkap: `title`, `description`, `openGraph`, `twitter`, `robots`, `alternates.canonical`. Buat sitemap dinamis dengan `app/sitemap.ts` yang menyertakan semua halaman statis dan konten dinamis.
244
+
245
+ ### Data Terstruktur (JSON-LD) untuk Kutipan AI
246
+ Tambahkan schema `Organization` untuk membangun entitas merek dan schema `SoftwareApplication` untuk produk SaaS — termasuk `aggregateRating` jika tersedia.
247
+
248
+ ### GEO — Optimasi AI Mode & Landing Page AEO
249
+ Google AI Mode (sebelumnya AI Overviews) dan Perplexity sangat menyukai format berikut:
250
+ - **Kalimat Ekstraksi AEO**: Buat satu kalimat ringkas 25–40 kata ("Apa itu [produk]?") di blockquote setelah H1.
251
+ - Tulis konten Q&A dan sertakan statistik spesifik.
252
+ - **Alur Narasi Landing Page**: Hero (H1+AEO) -> Problem -> Solution -> Features -> Social Proof -> FAQ (tiap jawaban <50 kata).
253
+ - Tambahkan `/llms.txt` sebagai indeks situs yang dapat dibaca AI.
254
+ - Kecepatan: Halaman harus memuat sangat cepat (TTFB < 600ms).
255
+
256
+ ### Standar SEO On-Page
257
+ H1 satu per halaman, H2 untuk header seksi, meta title < 60 karakter, meta deskripsi < 155 karakter, URL lowercase dengan tanda hubung dan keyword di slug, alt text deskriptif untuk semua gambar, 3-5 internal link per halaman long-form.
258
+
259
+
@@ -0,0 +1,83 @@
1
+ ---
2
+ name: session-context-loader
3
+ description: "Automatically loads and learns project context (Tech Stack, PRD, Roadmap, Blueprint) at the start of every new conversation session to ensure focused and directed development / Otomatis memuat dan mempelajari konteks proyek (Tech Stack, PRD, Roadmap, Blueprint) di awal setiap sesi percakapan baru untuk memastikan pengembangan yang terarah dan fokus."
4
+ author: "Roedy Rustam"
5
+ ---
6
+
7
+ # Session Context Loader
8
+
9
+ [English](#english) | [Bahasa Indonesia](#bahasa-indonesia)
10
+
11
+ ---
12
+
13
+ <a name="english"></a>
14
+ ## English
15
+
16
+ ### Orchestration & Integration
17
+ Connects and orchestrates with relevant domain skills like `brainstorming`, `zero-to-prod-orchestrator`, and `project-context-mapper` to ensure cohesive execution.
18
+
19
+ ### Description
20
+ This skill ensures that the AI agent is always aligned with the project's core documentation. At the beginning of every new conversation session, it automatically searches for and reads essential project context files (Tech Stack, PRD, Roadmap, Blueprint). This guarantees that development remains focused, directed, and strictly adheres to established requirements and architectural decisions.
21
+
22
+ ### Trigger Conditions
23
+ Activate this skill IMMEDIATELY when:
24
+ - It is the very first message of a new conversation session.
25
+ - The user says "start session", "initialize project", or "load context".
26
+ - The AI realizes it lacks the high-level context of the current repository.
27
+
28
+ ### Execution Protocol
29
+
30
+ When triggered, you MUST perform the following steps before answering the user's primary request or writing any code:
31
+
32
+ 1. **Locate Key Documentation Files:**
33
+ Use your file search tools (`list_dir`, `grep_search`, or `view_file`) to look for the following files in the project root or `.docs/` folder:
34
+ - `PRD.md` (Product Requirements Document)
35
+ - `ROADMAP.md` or `ROADMAP.txt`
36
+ - `BLUEPRINT.md` or `ARCHITECTURE.md`
37
+ - `TECH_STACK.md`, `package.json`, `go.mod`, `Cargo.toml`, or `requirements.txt` (to identify the tech stack)
38
+
39
+ 2. **Read and Internalize Context:**
40
+ - Read the contents of the found files.
41
+ - Understand the project's primary goal, current phase in the roadmap, architectural constraints (blueprint), and the specific tech stack being used.
42
+
43
+ 3. **Acknowledge and Align:**
44
+ - Briefly acknowledge to the user that the project context has been loaded successfully.
45
+ - State the current Tech Stack and the immediate goal based on the Roadmap/PRD.
46
+ - Proceed with addressing the user's actual request using the newly loaded context.
47
+
48
+ ---
49
+
50
+ <a name="bahasa-indonesia"></a>
51
+ ## Bahasa Indonesia
52
+
53
+ ### Integrasi Orkestrasi
54
+ Terhubung dan mengorkestrasi skill domain yang relevan seperti `brainstorming`, `zero-to-prod-orchestrator`, dan `project-context-mapper` untuk memastikan eksekusi yang kohesif.
55
+
56
+ ### Deskripsi
57
+ Skill ini memastikan bahwa agen AI selalu selaras dengan dokumentasi inti proyek. Di awal setiap sesi percakapan baru, agen akan secara otomatis mencari dan membaca file konteks proyek esensial (Tech Stack, PRD, Roadmap, Blueprint). Ini menjamin bahwa pengembangan proyek aplikasi tetap lebih terarah, fokus, dan sangat mematuhi persyaratan serta keputusan arsitektur yang telah ditetapkan.
58
+
59
+ ### Kondisi Pemicu
60
+ Aktifkan skill ini SEGERA ketika:
61
+ - Ini adalah pesan pertama dari sesi percakapan baru.
62
+ - Pengguna berkata "mulai sesi", "inisialisasi proyek", atau "muat konteks".
63
+ - AI menyadari bahwa ia kekurangan konteks tingkat tinggi dari repositori saat ini.
64
+
65
+ ### Protokol Eksekusi
66
+
67
+ Saat dipicu, Anda HARUS melakukan langkah-langkah berikut sebelum menjawab permintaan utama pengguna atau menulis kode apa pun:
68
+
69
+ 1. **Temukan File Dokumentasi Kunci:**
70
+ Gunakan alat pencarian file Anda (`list_dir`, `grep_search`, atau `view_file`) untuk mencari file berikut di root proyek atau folder `.docs/`:
71
+ - `PRD.md` (Product Requirements Document)
72
+ - `ROADMAP.md` atau `ROADMAP.txt`
73
+ - `BLUEPRINT.md` atau `ARCHITECTURE.md`
74
+ - `TECH_STACK.md`, `package.json`, `go.mod`, `Cargo.toml`, atau `requirements.txt` (untuk mengidentifikasi tech stack)
75
+
76
+ 2. **Baca dan Pahami Konteks:**
77
+ - Baca isi dari file-file yang ditemukan.
78
+ - Pahami tujuan utama proyek, fase saat ini di roadmap, batasan arsitektur (blueprint), dan tech stack spesifik yang digunakan.
79
+
80
+ 3. **Konfirmasi dan Selaraskan:**
81
+ - Berikan konfirmasi singkat kepada pengguna bahwa konteks proyek telah berhasil dimuat.
82
+ - Sebutkan Tech Stack saat ini dan tujuan langsung berdasarkan Roadmap/PRD.
83
+ - Lanjutkan dengan menjawab permintaan pengguna yang sebenarnya menggunakan konteks yang baru dimuat.