opencode-skills-collection 3.0.3 → 3.0.5

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 (91) hide show
  1. package/README.md +1 -2
  2. package/bundled-skills/.antigravity-install-manifest.json +5 -1
  3. package/bundled-skills/20-andruia-niche-intelligence/SKILL.md +1 -1
  4. package/bundled-skills/advogado-criminal/SKILL.md +49 -49
  5. package/bundled-skills/advogado-especialista/SKILL.md +49 -49
  6. package/bundled-skills/agent-memory-systems/SKILL.md +1 -1
  7. package/bundled-skills/agents-v2-py/SKILL.md +1 -1
  8. package/bundled-skills/ai-product/SKILL.md +7 -7
  9. package/bundled-skills/amazon-alexa/SKILL.md +14 -14
  10. package/bundled-skills/andrej-karpathy/SKILL.md +12 -12
  11. package/bundled-skills/angular-best-practices/SKILL.md +0 -4
  12. package/bundled-skills/apify-actorization/SKILL.md +2 -2
  13. package/bundled-skills/audit-context-building/SKILL.md +8 -8
  14. package/bundled-skills/auri-core/SKILL.md +9 -9
  15. package/bundled-skills/autonomous-agents/SKILL.md +1 -1
  16. package/bundled-skills/azure-search-documents-py/SKILL.md +5 -5
  17. package/bundled-skills/backend-dev-guidelines/SKILL.md +13 -13
  18. package/bundled-skills/bill-gates/SKILL.md +2 -2
  19. package/bundled-skills/browser-automation/SKILL.md +14 -14
  20. package/bundled-skills/buywhere-product-catalog/SKILL.md +2 -2
  21. package/bundled-skills/carrier-relationship-management/SKILL.md +1 -1
  22. package/bundled-skills/cc-skill-security-review/SKILL.md +1 -1
  23. package/bundled-skills/cred-omega/SKILL.md +21 -21
  24. package/bundled-skills/customs-trade-compliance/SKILL.md +1 -1
  25. package/bundled-skills/docker-expert/SKILL.md +1 -1
  26. package/bundled-skills/docs/integrations/jetski-cortex.md +3 -3
  27. package/bundled-skills/docs/integrations/jetski-gemini-loader/README.md +1 -1
  28. package/bundled-skills/docs/maintainers/repo-growth-seo.md +3 -3
  29. package/bundled-skills/docs/maintainers/skills-update-guide.md +1 -1
  30. package/bundled-skills/docs/users/bundles.md +1 -1
  31. package/bundled-skills/docs/users/claude-code-skills.md +1 -1
  32. package/bundled-skills/docs/users/gemini-cli-skills.md +1 -1
  33. package/bundled-skills/docs/users/getting-started.md +1 -1
  34. package/bundled-skills/docs/users/kiro-integration.md +1 -1
  35. package/bundled-skills/docs/users/usage.md +4 -4
  36. package/bundled-skills/docs/users/visual-guide.md +4 -4
  37. package/bundled-skills/elon-musk/SKILL.md +50 -50
  38. package/bundled-skills/email-systems/SKILL.md +18 -18
  39. package/bundled-skills/energy-procurement/SKILL.md +1 -1
  40. package/bundled-skills/evaluation/SKILL.md +1 -1
  41. package/bundled-skills/frontend-dev-guidelines/SKILL.md +16 -16
  42. package/bundled-skills/git-pr-review/SKILL.md +167 -0
  43. package/bundled-skills/hosted-agents/SKILL.md +1 -1
  44. package/bundled-skills/hosted-agents-v2-py/SKILL.md +1 -1
  45. package/bundled-skills/ilya-sutskever/SKILL.md +18 -18
  46. package/bundled-skills/image-studio/SKILL.md +6 -6
  47. package/bundled-skills/inventory-demand-planning/SKILL.md +1 -1
  48. package/bundled-skills/leiloeiro-edital/SKILL.md +4 -4
  49. package/bundled-skills/leiloeiro-juridico/SKILL.md +8 -8
  50. package/bundled-skills/leiloeiro-risco/SKILL.md +2 -2
  51. package/bundled-skills/linear-claude-skill/SKILL.md +0 -24
  52. package/bundled-skills/linkedin-cli/SKILL.md +1 -1
  53. package/bundled-skills/logistics-exception-management/SKILL.md +1 -1
  54. package/bundled-skills/matematico-tao/SKILL.md +6 -6
  55. package/bundled-skills/mental-health-analyzer/SKILL.md +1 -1
  56. package/bundled-skills/multi-advisor/SKILL.md +8 -8
  57. package/bundled-skills/nestjs-expert/SKILL.md +1 -1
  58. package/bundled-skills/nodejs-best-practices/SKILL.md +2 -2
  59. package/bundled-skills/postgres-best-practices/SKILL.md +1 -1
  60. package/bundled-skills/prisma-expert/SKILL.md +1 -1
  61. package/bundled-skills/product-inventor/SKILL.md +5 -5
  62. package/bundled-skills/production-audit/SKILL.md +209 -0
  63. package/bundled-skills/production-scheduling/SKILL.md +1 -1
  64. package/bundled-skills/quality-nonconformance/SKILL.md +1 -1
  65. package/bundled-skills/react-best-practices/SKILL.md +1 -1
  66. package/bundled-skills/react-patterns/SKILL.md +8 -0
  67. package/bundled-skills/recursive-context-pruning-token-budgeting/SKILL.md +108 -0
  68. package/bundled-skills/rehabilitation-analyzer/SKILL.md +1 -1
  69. package/bundled-skills/returns-reverse-logistics/SKILL.md +1 -1
  70. package/bundled-skills/skill-audit/SKILL.md +174 -0
  71. package/bundled-skills/skill-rails-upgrade/SKILL.md +2 -2
  72. package/bundled-skills/social-orchestrator/SKILL.md +4 -4
  73. package/bundled-skills/steve-jobs/SKILL.md +24 -24
  74. package/bundled-skills/telegram/SKILL.md +1 -1
  75. package/bundled-skills/typescript-expert/SKILL.md +1 -1
  76. package/bundled-skills/ui-ux-pro-max/SKILL.md +1 -1
  77. package/bundled-skills/verification-before-completion/SKILL.md +1 -1
  78. package/bundled-skills/voice-agents/SKILL.md +27 -27
  79. package/bundled-skills/warren-buffett/SKILL.md +2 -2
  80. package/bundled-skills/whatsapp-cloud-api/SKILL.md +1 -1
  81. package/bundled-skills/wiki-architect/SKILL.md +1 -1
  82. package/bundled-skills/wiki-changelog/SKILL.md +1 -1
  83. package/bundled-skills/wiki-onboarding/SKILL.md +1 -1
  84. package/bundled-skills/wiki-page-writer/SKILL.md +1 -1
  85. package/bundled-skills/wiki-qa/SKILL.md +1 -1
  86. package/bundled-skills/wiki-researcher/SKILL.md +1 -1
  87. package/bundled-skills/wiki-vitepress/SKILL.md +1 -1
  88. package/bundled-skills/workflow-automation/SKILL.md +10 -10
  89. package/bundled-skills/zapier-make-patterns/SKILL.md +10 -10
  90. package/package.json +1 -1
  91. package/skills_index.json +88 -0
@@ -48,12 +48,6 @@ linear issues list
48
48
 
49
49
  ---
50
50
 
51
-
52
- ## When to Use This Skill
53
-
54
- Manage Linear issues, projects, and teams
55
-
56
- Use this skill when working with manage linear issues, projects, and teams.
57
51
  ## 🔐 Security: Varlock Integration
58
52
 
59
53
  **CRITICAL**: Never expose API keys in terminal output or Claude's context.
@@ -174,12 +168,6 @@ See [Project Management Commands](#project-management-commands) for full referen
174
168
 
175
169
  ---
176
170
 
177
-
178
- ## When to Use This Skill
179
-
180
- Manage Linear issues, projects, and teams
181
-
182
- Use this skill when working with manage linear issues, projects, and teams.
183
171
  ## Project Planning Workflow
184
172
 
185
173
  ### Create Issues in the Correct Project from the Start
@@ -326,12 +314,6 @@ npx tsx scripts/linear-ops.ts link-initiative "Phase 11" "Q2 Goals"
326
314
 
327
315
  ---
328
316
 
329
-
330
- ## When to Use This Skill
331
-
332
- Manage Linear issues, projects, and teams
333
-
334
- Use this skill when working with manage linear issues, projects, and teams.
335
317
  ## Tool Selection
336
318
 
337
319
  Choose the right tool for the task:
@@ -506,12 +488,6 @@ npx tsx scripts/linear-ops.ts unlink-initiative "Phase X" "Old Initiative"
506
488
 
507
489
  ---
508
490
 
509
-
510
- ## When to Use This Skill
511
-
512
- Manage Linear issues, projects, and teams
513
-
514
- Use this skill when working with manage linear issues, projects, and teams.
515
491
  ## Sync Patterns (Bulk Operations)
516
492
 
517
493
  For bulk synchronization of code changes to Linear, see **sync.md**.
@@ -35,7 +35,7 @@ Once the user provides the tokens, run:
35
35
  linkedin setup --linked-api-token=TOKEN --identification-token=TOKEN
36
36
  ```
37
37
 
38
- ## When to Use
38
+ ### When to Use
39
39
  Use this skill when you need to **orchestrate LinkedIn actions from scripts or an AI agent** instead of clicking through the web UI:
40
40
 
41
41
  - Building outreach, research, or recruiting workflows that rely on LinkedIn data and messaging.
@@ -195,7 +195,7 @@ Track these metrics weekly and trend monthly:
195
195
  - For the comprehensive edge case library with full analysis, see [edge-cases.md](references/edge-cases.md)
196
196
  - For complete communication templates with variables and tone guidance, see [communication-templates.md](references/communication-templates.md)
197
197
 
198
- ## When to Use
198
+ ### When to Use
199
199
  Use this skill when you need to **triage and resolve logistics exceptions or design exception-handling playbooks**:
200
200
 
201
201
  - Handling delays, damages, shortages, misdeliveries, and claims across LTL, FTL, parcel, intermodal, ocean, or air.
@@ -340,34 +340,34 @@ StateFlow como processo reativo S = (State, Ev
340
340
 
341
341
  ```
342
342
 
343
- ## 1. Estrutura Formal
343
+ ### 1. Estrutura Formal
344
344
 
345
345
  [Definição matemática do componente]
346
346
 
347
- ## 2. Invariantes Identificados
347
+ ### 2. Invariantes Identificados
348
348
 
349
349
  1. INV-01: [invariante em notação matemática ou pseudocódigo formal]
350
350
  2. INV-02: ...
351
351
 
352
- ## 3. Propriedades Verificadas
352
+ ### 3. Propriedades Verificadas
353
353
 
354
354
  ✅ [Propriedade que foi verificada como correta + argumento]
355
355
  ⚠️ [Propriedade suspeita + evidência]
356
356
  ❌ [Violação encontrada + contra-exemplo]
357
357
 
358
- ## 4. Análise De Complexidade
358
+ ### 4. Análise De Complexidade
359
359
 
360
360
  - Tempo: O(?) com argumento
361
361
  - Espaço: O(?) com argumento
362
362
  - Caso médio: Θ(?) com análise probabilística se relevante
363
363
 
364
- ## 5. Riscos Matemáticos Prioritizados
364
+ ### 5. Riscos Matemáticos Prioritizados
365
365
 
366
366
  | Rank | Risco | Severidade | P(ocorrência) | Score |
367
367
  |------|-------|-----------|--------------|-------|
368
368
  | 1 | ... | 9/10 | 0.8 | 7.2 |
369
369
 
370
- ## 6. Recomendações Provadas
370
+ ### 6. Recomendações Provadas
371
371
 
372
372
  #### R-01: [Título]
373
373
  **Argumento**: [Por que matematicamente esta mudança é correta]
@@ -714,7 +714,7 @@ source: community
714
714
  2. 冥想 - 有效率85% ✓
715
715
  3. 深呼吸 - 有效率75% ✓
716
716
 
717
- ## 建议
717
+ ### 建议
718
718
  - 下午工作压力大时,可使用深呼吸或短暂散步
719
719
  - 保持规律运动,对情绪改善效果显著
720
720
  - 改善睡眠有助于减轻焦虑和疲劳
@@ -57,7 +57,7 @@ A sintese dessas perspectivas e o que separa decisoes mediocres de decisoes imor
57
57
 
58
58
  ---
59
59
 
60
- ## 2.1 Personas Disponiveis
60
+ ### 2.1 Personas Disponiveis
61
61
 
62
62
  | Agente | Especialidade Core | Quando Chamar |
63
63
  |--------|-------------------|---------------|
@@ -75,7 +75,7 @@ A sintese dessas perspectivas e o que separa decisoes mediocres de decisoes imor
75
75
  | `007` | Security, threat modeling, infraestrutura | Riscos de seguranca, vulnerabilidades |
76
76
  | `product-inventor` | Design systems, UX/UI, React/Next.js | Execucao de produto, UI engineering |
77
77
 
78
- ## 2.2 Boards Pre-Configurados
78
+ ### 2.2 Boards Pre-Configurados
79
79
 
80
80
  | Board | Composicao | Uso |
81
81
  |-------|-----------|-----|
@@ -89,7 +89,7 @@ A sintese dessas perspectivas e o que separa decisoes mediocres de decisoes imor
89
89
 
90
90
  ---
91
91
 
92
- ## 3.1 Fluxo Standard
92
+ ### 3.1 Fluxo Standard
93
93
 
94
94
  ```
95
95
  1. RECEBER: Questao do usuario
@@ -100,7 +100,7 @@ A sintese dessas perspectivas e o que separa decisoes mediocres de decisoes imor
100
100
  6. SINTETIZAR: Visao consolidada + recomendacao final
101
101
  ```
102
102
 
103
- ## 3.2 Como Invocar Cada Persona
103
+ ### 3.2 Como Invocar Cada Persona
104
104
 
105
105
  Para cada membro do board, adote completamente a perspectiva daquela persona:
106
106
 
@@ -131,7 +131,7 @@ Para cada membro do board, adote completamente a perspectiva daquela persona:
131
131
 
132
132
  ---
133
133
 
134
- ## 4.1 Estrutura Do Conselho
134
+ ### 4.1 Estrutura Do Conselho
135
135
 
136
136
  ```markdown
137
137
 
@@ -216,7 +216,7 @@ Board: AI_BOARD (Sam + Karpathy + LeCun + Ilya)
216
216
 
217
217
  ---
218
218
 
219
- ## 6. Regras Do Board
219
+ ## 2. Regras Do Board
220
220
 
221
221
  1. **Autenticidade** — Cada persona fala com sua voz unica. Jobs nao fala como Buffett.
222
222
  2. **Tensao e saudavel** — Se todo board concorda, investigar mais fundo.
@@ -227,7 +227,7 @@ Board: AI_BOARD (Sam + Karpathy + LeCun + Ilya)
227
227
 
228
228
  ---
229
229
 
230
- ## 7. Consulta Customizada
230
+ ## 3. Consulta Customizada
231
231
 
232
232
  Usuario pode customizar o board:
233
233
 
@@ -244,7 +244,7 @@ Usuario pode customizar o board:
244
244
 
245
245
  ---
246
246
 
247
- ## 8. Integracao Com Ecossistema
247
+ ## 4. Integracao Com Ecossistema
248
248
 
249
249
  Esta skill usa as personas instaladas no ecossistema:
250
250
  - Ao consultar cada persona, adotar sua perspectiva COMPLETA (nao superficial)
@@ -11,7 +11,7 @@ date_added: "2026-02-27"
11
11
 
12
12
  You are an expert in Nest.js with deep knowledge of enterprise-grade Node.js application architecture, dependency injection patterns, decorators, middleware, guards, interceptors, pipes, testing strategies, database integration, and authentication systems.
13
13
 
14
- ## When invoked:
14
+ ### When invoked:
15
15
 
16
16
  0. If a more specialized expert fits better, recommend switching and stop:
17
17
  - Pure TypeScript type issues → typescript-type-expert
@@ -301,7 +301,7 @@ node --test src/**/*.test.ts
301
301
 
302
302
  ---
303
303
 
304
- ## 10. Anti-Patterns to Avoid
304
+ ## 9. Anti-Patterns to Avoid
305
305
 
306
306
  ### ❌ DON'T:
307
307
  - Use Express for new edge projects (use Hono)
@@ -322,7 +322,7 @@ node --test src/**/*.test.ts
322
322
 
323
323
  ---
324
324
 
325
- ## 11. Decision Checklist
325
+ ## 10. Decision Checklist
326
326
 
327
327
  Before implementing:
328
328
 
@@ -54,7 +54,7 @@ Each rule file contains:
54
54
 
55
55
  For the complete guide with all rules expanded: `AGENTS.md`
56
56
 
57
- ## When to Use
57
+ ### When to Use
58
58
  This skill is applicable to execute the workflow or actions described in the overview.
59
59
 
60
60
  ## Limitations
@@ -10,7 +10,7 @@ date_added: "2026-02-27"
10
10
 
11
11
  You are an expert in Prisma ORM with deep knowledge of schema design, migrations, query optimization, relations modeling, and database operations across PostgreSQL, MySQL, and SQLite.
12
12
 
13
- ## When Invoked
13
+ ### When Invoked
14
14
 
15
15
  ### Step 0: Recommend Specialist and Stop
16
16
  If the issue is specifically about:
@@ -45,7 +45,7 @@ Product Inventor e Design Alchemist de nivel maximo — combina Product Thinking
45
45
 
46
46
  ---
47
47
 
48
- ## 1.1 Os Cinco Principios Inegociaveis
48
+ ### 1.1 Os Cinco Principios Inegociaveis
49
49
 
50
50
  **PRINCIPIO 1 — SIMPLICIDADE RADICAL**
51
51
  Remova tudo que nao e essencial. Nao ha premio por complexidade.
@@ -83,7 +83,7 @@ Novidade real raramente vem de invencao total. Vem de:
83
83
  - fluxo viciante (que cria habito sem esforco)
84
84
  - execucao impecavel (que elimina toda friccao)
85
85
 
86
- ## 1.2 O Que Nunca Fazer
86
+ ### 1.2 O Que Nunca Fazer
87
87
 
88
88
  - UI generica. "Parece qualquer outro app" e morte.
89
89
  - Dashboard padrao com 12 cards sem hierarquia.
@@ -95,7 +95,7 @@ Novidade real raramente vem de invencao total. Vem de:
95
95
 
96
96
  ---
97
97
 
98
- ## 2.1 Motor 1 — "First Principles Ui"
98
+ ### 2.1 Motor 1 — "First Principles Ui"
99
99
 
100
100
  Antes de qualquer pixel, decomponha o produto em atomos:
101
101
 
@@ -127,7 +127,7 @@ PROXIMO PASSO INEVITAVEL
127
127
 
128
128
  Use esse framework para cada tela, nao so para o produto inteiro.
129
129
 
130
- ## 2.2 Motor 2 — "Killer Interaction" (Interacao Assinatura)
130
+ ### 2.2 Motor 2 — "Killer Interaction" (Interacao Assinatura)
131
131
 
132
132
  Todo produto memoravel tem 1 interacao que e sua assinatura.
133
133
  Nao e gimmick. E a solucao mais elegante para o problema central.
@@ -157,7 +157,7 @@ Passo 5: Pergunte: "E se o usuario nao precisasse clicar em nada?"
157
157
  - Pode virar demo de 10 segundos que impressiona? ✓
158
158
  - E difícil de copiar sem entender a logica por tras? ✓
159
159
 
160
- ## 2.3 Motor 3 — "Design System Proprietario"
160
+ ### 2.3 Motor 3 — "Design System Proprietario"
161
161
 
162
162
  Nunca use tokens genericos. Todo produto precisa de identidade propria.
163
163
 
@@ -0,0 +1,209 @@
1
+ ---
2
+ name: production-audit
3
+ description: "Audit a shipped repo for production-readiness gaps across RLS, webhooks, secrets, grants, Stripe idempotency, mobile UX, and deployment health."
4
+ category: security
5
+ risk: safe
6
+ source: community
7
+ source_repo: commitshow/production-audit
8
+ source_type: community
9
+ date_added: "2026-05-04"
10
+ author: commitshow
11
+ tags: [security, audit, production, vibe-coding, rls, webhook, stripe, supabase, mobile]
12
+ tools: [claude, cursor, gemini, codex, antigravity]
13
+ license: "MIT"
14
+ license_source: "https://github.com/commitshow/production-audit/blob/main/LICENSE"
15
+ ---
16
+
17
+ # Production Audit
18
+
19
+ ## Overview
20
+
21
+ A skill that runs an external audit on a shipped repo's deployed state — live URL, GitHub signals, secrets exposure, RLS gaps, webhook idempotency, indexes, observability, prompt injection, and ten other failure modes that AI-assisted projects routinely miss.
22
+
23
+ This is **complementary** to in-session security skills (`security-review`, OWASP-style, VibeSec, Trail of Bits). Those scan the editor buffer at write-time. This scans the deployed product after you commit. Different timing, different inputs, different findings. Run both for serious launches.
24
+
25
+ The skill wraps the [commit.show](https://commit.show) audit engine via the public CLI (`npx commitshow audit . --json`). Stable JSON envelope (`schema_version: "1"`, additive-only). Writes a `.commitshow/audit.{md,json}` sidecar so future agent sessions can read prior state without re-running the engine.
26
+
27
+ ## When to Use This Skill
28
+
29
+ - Use when the user asks "is this production-ready", "what would break in prod", "score my project", "what did I miss", "audit my repo", "ready to ship".
30
+ - Use right after merging a feature branch to `main` (helpful as a pre-deploy gate).
31
+ - Use before a public launch / Show HN post / investor demo.
32
+ - Use when `git log` shows >20 commits since the last `.commitshow/audit.md` was written.
33
+
34
+ ### Skip when
35
+
36
+ - During active in-session coding — use `security-review` / OWASP-style for line-level patterns. This skill is for post-merge / pre-ship review.
37
+ - For library / scaffold-form repos — the engine handles **app form** best; libraries get a partial-substitute score.
38
+ - If `.commitshow/audit.json` already exists and is < 1 hour old, read that instead of re-running. Audit is rate-limited (anonymous: 20/IP/day · 5/repo/day · 2000/day global).
39
+ - Inside a private / non-GitHub repo — the audit pulls public GitHub signals, so private repos return a `not_found` error.
40
+
41
+ ## How It Works
42
+
43
+ ### Step 1: Run the audit
44
+
45
+ From the repo root. The CLI is pinned to a known-good range (an attacker-pushed `0.4.x` won't be picked up silently — bumping the floor is a deliberate edit), the sidecar directory is created up-front, and stderr is split off so install/deprecation warnings can't corrupt the JSON envelope:
46
+
47
+ ```bash
48
+ mkdir -p .commitshow
49
+ npx commitshow@^0.3.23 audit . --json \
50
+ > .commitshow/audit.json \
51
+ 2> .commitshow/audit.stderr.log
52
+ ```
53
+
54
+ This also writes a human-readable `.commitshow/audit.md` next to it. Subsequent invocations should diff against the prior `audit.json` if it exists, so you can lead with "+5 since yesterday's audit" instead of just an absolute number.
55
+
56
+ If the user pointed at a remote URL instead of `.`, swap `.` for the URL — keep the same `mkdir -p` + version pin + stderr split:
57
+
58
+ ```bash
59
+ mkdir -p .commitshow
60
+ npx commitshow@^0.3.23 audit github.com/owner/repo --json \
61
+ > .commitshow/audit.json \
62
+ 2> .commitshow/audit.stderr.log
63
+ ```
64
+
65
+ ### Step 2: Parse the envelope
66
+
67
+ The JSON envelope is stable (`schema_version: "1"`, additive-only). Read these fields:
68
+
69
+ | Field | Meaning |
70
+ |---|---|
71
+ | `score.total` | 0-100 production-readiness score |
72
+ | `score.delta_since_last` | change vs. parent snapshot · positive = improving |
73
+ | `score.band` | `strong` (80+) · `mid` (60-79) · `early` (<60) |
74
+ | `concerns[]` | top issues, ordered by impact · each has `axis` + `bullet` |
75
+ | `strengths[]` | top 3 things that work · for context only |
76
+ | `standing` | optional · only when the project is auditioning on commit.show |
77
+ | `snapshot.created_at` / `trigger_type` | when the audit ran |
78
+
79
+ Concerns are sorted by decision-impact, not severity. Position 1 is the bullet to lead with.
80
+
81
+ ### Step 3: Surface to the user
82
+
83
+ Lead with score + trajectory in **one sentence**, then the top concerns. Do not dump the full JSON. Format:
84
+
85
+ ```
86
+ Score: 82/100 (+5 since yesterday) · band: strong
87
+
88
+ Top concerns:
89
+ ↓ [Security] No API rate limiting on /auth — IP cap missing
90
+ ↓ [Infrastructure] webhook handler at api/stripe.ts — signature verified, but no
91
+ idempotency-key check (replay attack window open)
92
+
93
+ Want me to fix the webhook idempotency gap first?
94
+ ```
95
+
96
+ Rules:
97
+ - Use the exact bullet from `concerns[].bullet` — the audit engine already wrote action-oriented copy.
98
+ - Don't list strengths unless the user explicitly asks. They're not actionable in this context.
99
+ - Always end with a follow-up question that names a specific concern. Don't ask "what do you want to do?" — ask "fix X first?".
100
+ - If `score.delta_since_last` is negative or null, lead with the absolute score only.
101
+
102
+ ### Step 4: If the user picks a concern, scope a fix
103
+
104
+ For the chosen concern:
105
+ 1. Read the file(s) cited in the bullet.
106
+ 2. Confirm the gap matches the description (the engine occasionally over-flags when the issue is mitigated elsewhere).
107
+ 3. Propose a minimal patch — single-file when possible.
108
+ 4. **Don't apply without explicit approval.** Show the diff first. The user is deciding what to ship; you're a lens.
109
+
110
+ After applying a fix, suggest re-running with `--refresh` (same canonical form as Step 1, so `audit.json` stays the source of truth for delta calculations):
111
+
112
+ ```bash
113
+ mkdir -p .commitshow
114
+ npx commitshow@^0.3.23 audit . --json --refresh \
115
+ > .commitshow/audit.json \
116
+ 2> .commitshow/audit.stderr.log
117
+ ```
118
+
119
+ ## Examples
120
+
121
+ ### Example 1: User asks "is this production-ready?"
122
+
123
+ ```bash
124
+ mkdir -p .commitshow
125
+ npx commitshow@^0.3.23 audit . --json \
126
+ > .commitshow/audit.json \
127
+ 2> .commitshow/audit.stderr.log
128
+ ```
129
+
130
+ Then surface:
131
+
132
+ ```
133
+ Score: 67/100 · band: mid
134
+
135
+ Top concerns:
136
+ ↓ [Security] members table uses column-level GRANT but paid_audits_credit
137
+ column lacks SELECT grant — silent 42501 on every read
138
+ ↓ [Infrastructure] stripe.checkout.sessions.create called without
139
+ idempotencyKey — duplicate-charge surface
140
+
141
+ Want me to fix the column GRANT first? Single SQL line.
142
+ ```
143
+
144
+ ### Example 2: Cross-check a specific concern
145
+
146
+ User: "show me where the webhook idempotency gap is"
147
+
148
+ ```bash
149
+ cat .commitshow/audit.json | jq '.concerns[] | select(.axis=="Infrastructure")'
150
+ ```
151
+
152
+ Find the file path in the bullet, read it, confirm the gap matches.
153
+
154
+ ## Best Practices
155
+
156
+ - ✅ Always cite the exact bullet from `concerns[].bullet` — they're already action-oriented
157
+ - ✅ Lead with score + delta in a single sentence, then concerns
158
+ - ✅ End with a specific follow-up question naming a concern
159
+ - ✅ Read prior `.commitshow/audit.json` before re-running (within 1h)
160
+ - ✅ Use `--refresh` after the user merges a fix so the next audit reflects it
161
+ - ❌ Don't dump full JSON to the user
162
+ - ❌ Don't list strengths unless the user explicitly asks
163
+ - ❌ Don't apply fixes without approval — show diff first
164
+ - ❌ Don't fault private repos for not auditing — explain why and suggest making public
165
+
166
+ ## Limitations
167
+
168
+ - This skill does not replace environment-specific validation, testing, or expert review.
169
+ - The audit engine is calibrated for **deployed apps** with a live URL. CLI / library / scaffold form gets a partial-substitute score (max ~45/50 on the audit pillar) — fair but not flattering.
170
+ - Behind a corporate firewall blocking `*.supabase.co`, the API call fails. There is no offline mode — the audit relies on the public engine.
171
+ - Cold audit takes 60-90s. Cached audits (within 7 days) return instantly. `--refresh` force-bypasses cache (counts against rate limits).
172
+
173
+ ## Security & Safety Notes
174
+
175
+ - The skill executes `npx commitshow@latest audit ...` which is a network call to a public API at `https://api.commit.show` (proxied to Supabase Edge Functions). No credentials are sent — anonymous usage subject to per-IP / per-URL / global rate limits.
176
+ - The CLI writes `.commitshow/audit.{md,json}` in the current working directory. These files are safe to commit (no secrets) but conventionally gitignored as transient artifacts.
177
+ - The audit engine **only reads** public GitHub signals. It does not modify the user's repo or push commits.
178
+ - All per-finding fix proposals must be shown as diffs and approved by the user before any edit. Never apply without explicit confirmation.
179
+
180
+ ## Common Pitfalls
181
+
182
+ - **Problem:** Audit returns `not_found` for a private repo
183
+ **Solution:** The engine pulls public GitHub signals only. Either make the repo public or use `--no-network` for local-only deterministic checks.
184
+
185
+ - **Problem:** Rate limit hit (`429`)
186
+ **Solution:** Wait until next day (limits reset 00:00 UTC) or sign in at commit.show for higher per-repo caps.
187
+
188
+ - **Problem:** Score seems too low for a polished library / CLI
189
+ **Solution:** The engine biases toward app form. CLI / library / scaffold gets a partial substitute score capped around 45/50 on the audit pillar. Calibration acknowledged trade-off.
190
+
191
+ - **Problem:** `concerns[]` is empty after re-running
192
+ **Solution:** Re-audit may have hit cache. Use `--refresh` to force-bypass.
193
+
194
+ ## Related Skills
195
+
196
+ - `@security-review` — In-session line-level security patterns. Run alongside this skill, not in place of.
197
+ - `@vibesec` — Editor-buffer security review for vibe-coded projects. Different lens.
198
+ - `@owasp-security` — OWASP Top 10 coverage during coding. Companion.
199
+ - `@trail-of-bits-skills` — CodeQL / Semgrep static analysis. Different layer.
200
+
201
+ ## Additional Resources
202
+
203
+ - Canonical repo: <https://github.com/commitshow/production-audit>
204
+ - Audit engine source: <https://github.com/commitshow/commitshow/blob/main/supabase/functions/analyze-project/index.ts>
205
+ - 14-frame failure framework documented in the engine source above.
206
+ - JSON schema: stable at `schema_version: "1"` · additive-only changes.
207
+ - CLI: <https://github.com/commitshow/cli>
208
+ - Public REST API: `https://api.commit.show/audit?repo=...&format=json`
209
+ - skills.sh listing: <https://skills.sh/commitshow/production-audit>
@@ -206,7 +206,7 @@ Track per shift and trend weekly:
206
206
  - For the comprehensive edge case library with full resolution playbooks, see [edge-cases.md](references/edge-cases.md)
207
207
  - For complete communication templates with variables and tone guidance, see [communication-templates.md](references/communication-templates.md)
208
208
 
209
- ## When to Use
209
+ ### When to Use
210
210
  Use this skill when you need to **design or adjust production schedules and constraint‑focused execution plans**:
211
211
 
212
212
  - Sequencing jobs, balancing lines, and optimising changeovers in discrete or batch manufacturing.
@@ -227,7 +227,7 @@ Track these metrics weekly and trend monthly:
227
227
  - For the comprehensive edge case library with full analysis, see [edge-cases.md](references/edge-cases.md)
228
228
  - For complete communication templates with variables and tone guidance, see [communication-templates.md](references/communication-templates.md)
229
229
 
230
- ## When to Use
230
+ ### When to Use
231
231
  Use this skill when you need to **run or improve non‑conformance and CAPA processes in regulated manufacturing**:
232
232
 
233
233
  - Investigating NCRs, selecting root‑cause methods, and defining MRB dispositions and CAPA actions.
@@ -122,7 +122,7 @@ Each rule file contains:
122
122
 
123
123
  For the complete guide with all rules expanded: `AGENTS.md`
124
124
 
125
- ## When to Use
125
+ ### When to Use
126
126
  This skill is applicable to execute the workflow or actions described in the overview.
127
127
 
128
128
  ## Limitations
@@ -197,6 +197,14 @@ date_added: "2026-02-27"
197
197
 
198
198
  ---
199
199
 
200
+ ## 11. File Structure
201
+
202
+ <img width="1150" height="1438" alt="image" src="https://github.com/user-attachments/assets/10369698-472c-4695-a494-2c0672103aa1" />
203
+
204
+ Use this image as a reference for a better file structure of the project
205
+
206
+ ---
207
+
200
208
  > **Remember:** React is about composition. Build small, combine thoughtfully.
201
209
 
202
210
  ## When to Use
@@ -0,0 +1,108 @@
1
+ ---
2
+ name: recursive-context-pruning-token-budgeting
3
+ description: "Optimizes AI agent performance by pruning redundant context, managing token usage, and enforcing ultra-concise, direct-to-value responses."
4
+ category: prompt-engineering
5
+ risk: safe
6
+ source: self
7
+ source_repo: Kench001/antigravity-awesome-skills
8
+ source_type: self
9
+ date_added: "2026-05-03"
10
+ author: Kench001
11
+ tags: [efficiency, token-optimization, brevity, context-management]
12
+ tools: [claude, cursor, gemini]
13
+ # Optional: declare the upstream license if source_repo is set
14
+ # license: "MIT"
15
+ # license_source: "https://github.com/owner/repo/blob/main/LICENSE"
16
+ ---
17
+
18
+ # Recursive Context Pruning & Token Budgeting
19
+
20
+ ## Overview
21
+
22
+ This skill implements a "Gatekeeper" logic to prevent context window bloat and unnecessary token expenditure. It ensures the agent only processes relevant data shards and adheres to an Atomic Precision protocol—delivering functional answers with zero conversational filler. By recursively summarizing state and stripping "bridge phrases," it maximizes the longevity and speed of long-running development workflows.
23
+
24
+ ## When to Use This Skill
25
+
26
+ - Use when building multi-step agents to prevent repetition and "memory drift" in long conversations.
27
+ - Use when working with large document sets or codebases to avoid dumping entire files into the prompt.
28
+ - Use when you need purely functional output (code/logic) without "Sure! Here is your..." intros.
29
+
30
+ ## How It Works
31
+
32
+ ### Step 1: Metadata Sharding
33
+
34
+ Scan the available data for headers, summaries, and key indicators. Create a "map" of the context rather than injecting the full source. Never pull the entire file into the prompt unless a specific, narrowed fragment is requested.
35
+
36
+ ### Step 2: Token Budget Allocation
37
+
38
+ Calculate a "Safe Response Limit" based on the current context window. Allocate 30% for current logic processing, 20% for immediate output, and 50% for a future context buffer.
39
+
40
+ ### Step 3: Atomic Output Filtering
41
+
42
+ Strip all "Bridge Phrases" (e.g., "I've updated the code," "Based on your request," "Sure"). Start the response immediately with the solution or the code block.
43
+
44
+ ### Step 4: Ambiguity Check
45
+
46
+ Before executing Step 3, scan for missing critical variables (e.g., specific file names or environment types). If the prompt is too ambiguous, bypass the atomic output and generate exactly one concise question to resolve the blocker.
47
+
48
+ ### Step 5: Abstractive Compression
49
+
50
+ Summarize the current turn into a "compressed state string" (e.g., `[Project: Feasify | State: Auth-Fixed | Remaining-Tasks: 2]`) to discard redundant conversational data before the next prompt.
51
+
52
+ ## Examples
53
+
54
+ ### Example 1: Filtered Code Output (No Filler)
55
+
56
+ ```text
57
+ User: "Update the Firebase config to use environment variables."
58
+ ```
59
+
60
+ ```javascript
61
+ const firebaseConfig = {
62
+ apiKey: process.env.VITE_FIREBASE_API_KEY,
63
+ authDomain: process.env.VITE_FIREBASE_AUTH_DOMAIN,
64
+ projectId: process.env.VITE_FIREBASE_PROJECT_ID
65
+ };
66
+ ```
67
+
68
+ ### Example 2: Essential Clarification
69
+
70
+ ```text
71
+ User: "Deploy the function."
72
+ ```
73
+
74
+ ```text
75
+ "Specify environment: production or staging?"
76
+ ```
77
+
78
+ ## Best Practices
79
+
80
+ - ✅ **Direct Start:** Place the code or answer at the very first character of the response.
81
+ - ✅ **Summarize-as-you-go:** Turn 10 pages of discussion into 5 bullet points for the next turn.
82
+ - ✅ **Omit Signatures:** Never end with "Let me know if you need more help."
83
+ - ❌ **No Bridge Phrases:** Avoid "Here is the code," "Sure," or "I can help with that."
84
+ - ❌ **No Guessing:** If input is missing, ask immediately rather than wasting tokens on a generic guess.
85
+
86
+ ## Limitations
87
+
88
+ - This skill does not replace environment-specific validation, testing, or expert review.
89
+ - Extreme brevity can occasionally hide important nuances; use concise inline comments (`// crucial step`) for critical notes.
90
+
91
+ ## Security & Safety Notes
92
+
93
+ - Never prune safety headers, environment-specific security constraints, or system-level instructions during the compression stage.
94
+ - Maintain original system instructions at the "Root" of the context to prevent context-loss-based jailbreaks.
95
+
96
+ ## Common Pitfalls
97
+
98
+ - **Problem:** The response is so brief it lacks the context needed for implementation.
99
+ **Solution:** Use concise inline code comments instead of separate paragraphs of text.
100
+
101
+ - **Problem:** The agent loses the overarching goal due to over-compression.
102
+ **Solution:** Always pin the "Primary Objective" to the top of every pruned prompt.
103
+
104
+ ## Related Skills
105
+
106
+ - `@atomic-precision-response` - Specifically for removing conversational filler.
107
+ - `@context-sharding` - For managing large-scale documentation mapping.
108
+
@@ -599,7 +599,7 @@ source: community
599
599
  - 用药与训练强度的关系
600
600
  - 疼痛控制与用药依从性
601
601
 
602
- ## 使用示例
602
+ ### 使用示例
603
603
 
604
604
  ### 场景1:新用户开始康复
605
605
  ```
@@ -208,7 +208,7 @@ Level 1 (Returns Associate) → Level 2 (Team Lead, 2 hours) → Level 3 (Return
208
208
  - For the comprehensive edge case library with full analysis, see [edge-cases.md](references/edge-cases.md)
209
209
  - For complete communication templates with variables and tone guidance, see [communication-templates.md](references/communication-templates.md)
210
210
 
211
- ## When to Use
211
+ ### When to Use
212
212
  Use this skill when you need to **design, improve, or troubleshoot returns and reverse logistics operations**:
213
213
 
214
214
  - Defining or revising returns policies, grading standards, and disposition routes across channels.