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.
- package/README.md +1 -2
- package/bundled-skills/.antigravity-install-manifest.json +5 -1
- package/bundled-skills/20-andruia-niche-intelligence/SKILL.md +1 -1
- package/bundled-skills/advogado-criminal/SKILL.md +49 -49
- package/bundled-skills/advogado-especialista/SKILL.md +49 -49
- package/bundled-skills/agent-memory-systems/SKILL.md +1 -1
- package/bundled-skills/agents-v2-py/SKILL.md +1 -1
- package/bundled-skills/ai-product/SKILL.md +7 -7
- package/bundled-skills/amazon-alexa/SKILL.md +14 -14
- package/bundled-skills/andrej-karpathy/SKILL.md +12 -12
- package/bundled-skills/angular-best-practices/SKILL.md +0 -4
- package/bundled-skills/apify-actorization/SKILL.md +2 -2
- package/bundled-skills/audit-context-building/SKILL.md +8 -8
- package/bundled-skills/auri-core/SKILL.md +9 -9
- package/bundled-skills/autonomous-agents/SKILL.md +1 -1
- package/bundled-skills/azure-search-documents-py/SKILL.md +5 -5
- package/bundled-skills/backend-dev-guidelines/SKILL.md +13 -13
- package/bundled-skills/bill-gates/SKILL.md +2 -2
- package/bundled-skills/browser-automation/SKILL.md +14 -14
- package/bundled-skills/buywhere-product-catalog/SKILL.md +2 -2
- package/bundled-skills/carrier-relationship-management/SKILL.md +1 -1
- package/bundled-skills/cc-skill-security-review/SKILL.md +1 -1
- package/bundled-skills/cred-omega/SKILL.md +21 -21
- package/bundled-skills/customs-trade-compliance/SKILL.md +1 -1
- package/bundled-skills/docker-expert/SKILL.md +1 -1
- 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 +3 -3
- package/bundled-skills/docs/maintainers/skills-update-guide.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/getting-started.md +1 -1
- package/bundled-skills/docs/users/kiro-integration.md +1 -1
- package/bundled-skills/docs/users/usage.md +4 -4
- package/bundled-skills/docs/users/visual-guide.md +4 -4
- package/bundled-skills/elon-musk/SKILL.md +50 -50
- package/bundled-skills/email-systems/SKILL.md +18 -18
- package/bundled-skills/energy-procurement/SKILL.md +1 -1
- package/bundled-skills/evaluation/SKILL.md +1 -1
- package/bundled-skills/frontend-dev-guidelines/SKILL.md +16 -16
- package/bundled-skills/git-pr-review/SKILL.md +167 -0
- package/bundled-skills/hosted-agents/SKILL.md +1 -1
- package/bundled-skills/hosted-agents-v2-py/SKILL.md +1 -1
- package/bundled-skills/ilya-sutskever/SKILL.md +18 -18
- package/bundled-skills/image-studio/SKILL.md +6 -6
- package/bundled-skills/inventory-demand-planning/SKILL.md +1 -1
- package/bundled-skills/leiloeiro-edital/SKILL.md +4 -4
- package/bundled-skills/leiloeiro-juridico/SKILL.md +8 -8
- package/bundled-skills/leiloeiro-risco/SKILL.md +2 -2
- package/bundled-skills/linear-claude-skill/SKILL.md +0 -24
- package/bundled-skills/linkedin-cli/SKILL.md +1 -1
- package/bundled-skills/logistics-exception-management/SKILL.md +1 -1
- package/bundled-skills/matematico-tao/SKILL.md +6 -6
- package/bundled-skills/mental-health-analyzer/SKILL.md +1 -1
- package/bundled-skills/multi-advisor/SKILL.md +8 -8
- package/bundled-skills/nestjs-expert/SKILL.md +1 -1
- package/bundled-skills/nodejs-best-practices/SKILL.md +2 -2
- package/bundled-skills/postgres-best-practices/SKILL.md +1 -1
- package/bundled-skills/prisma-expert/SKILL.md +1 -1
- package/bundled-skills/product-inventor/SKILL.md +5 -5
- package/bundled-skills/production-audit/SKILL.md +209 -0
- package/bundled-skills/production-scheduling/SKILL.md +1 -1
- package/bundled-skills/quality-nonconformance/SKILL.md +1 -1
- package/bundled-skills/react-best-practices/SKILL.md +1 -1
- package/bundled-skills/react-patterns/SKILL.md +8 -0
- package/bundled-skills/recursive-context-pruning-token-budgeting/SKILL.md +108 -0
- package/bundled-skills/rehabilitation-analyzer/SKILL.md +1 -1
- package/bundled-skills/returns-reverse-logistics/SKILL.md +1 -1
- package/bundled-skills/skill-audit/SKILL.md +174 -0
- package/bundled-skills/skill-rails-upgrade/SKILL.md +2 -2
- package/bundled-skills/social-orchestrator/SKILL.md +4 -4
- package/bundled-skills/steve-jobs/SKILL.md +24 -24
- package/bundled-skills/telegram/SKILL.md +1 -1
- package/bundled-skills/typescript-expert/SKILL.md +1 -1
- package/bundled-skills/ui-ux-pro-max/SKILL.md +1 -1
- package/bundled-skills/verification-before-completion/SKILL.md +1 -1
- package/bundled-skills/voice-agents/SKILL.md +27 -27
- package/bundled-skills/warren-buffett/SKILL.md +2 -2
- package/bundled-skills/whatsapp-cloud-api/SKILL.md +1 -1
- package/bundled-skills/wiki-architect/SKILL.md +1 -1
- package/bundled-skills/wiki-changelog/SKILL.md +1 -1
- package/bundled-skills/wiki-onboarding/SKILL.md +1 -1
- package/bundled-skills/wiki-page-writer/SKILL.md +1 -1
- package/bundled-skills/wiki-qa/SKILL.md +1 -1
- package/bundled-skills/wiki-researcher/SKILL.md +1 -1
- package/bundled-skills/wiki-vitepress/SKILL.md +1 -1
- package/bundled-skills/workflow-automation/SKILL.md +10 -10
- package/bundled-skills/zapier-make-patterns/SKILL.md +10 -10
- package/package.json +1 -1
- 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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
343
|
+
### 1. Estrutura Formal
|
|
344
344
|
|
|
345
345
|
[Definição matemática do componente]
|
|
346
346
|
|
|
347
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
370
|
+
### 6. Recomendações Provadas
|
|
371
371
|
|
|
372
372
|
#### R-01: [Título]
|
|
373
373
|
**Argumento**: [Por que matematicamente esta mudança é correta]
|
|
@@ -57,7 +57,7 @@ A sintese dessas perspectivas e o que separa decisoes mediocres de decisoes imor
|
|
|
57
57
|
|
|
58
58
|
---
|
|
59
59
|
|
|
60
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
##
|
|
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
|
-
##
|
|
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
|
-
##
|
|
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
|
-
|
|
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
|
-
##
|
|
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
|
-
##
|
|
325
|
+
## 10. Decision Checklist
|
|
326
326
|
|
|
327
327
|
Before implementing:
|
|
328
328
|
|
|
@@ -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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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.
|
|
@@ -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
|
+
|
|
@@ -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
|
-
|
|
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.
|