opencode-skills-collection 1.0.157 → 1.0.158

package/bundled-skills/favicon/SKILL.md

@@ -13,6 +13,12 @@ metadata:
 
 Generate a complete set of favicons from the source image at `$1` and update the project's HTML with the appropriate link tags.
 
+## When to Use
+
+- You need to generate a complete favicon set from a single source image.
+- The task includes placing the assets in the correct framework-specific static directory and updating HTML link tags.
+- You want one workflow that validates the source image, detects the project type, and writes the right favicon outputs.
+
 ## Prerequisites
 
 First, verify ImageMagick v7+ is installed by running:

package/bundled-skills/ffuf-web-fuzzing/SKILL.md

@@ -7,6 +7,12 @@ source: community
 
 # FFUF (Fuzz Faster U Fool) Skill
 
+## When to Use
+
+- You are fuzzing web targets with `ffuf` during authorized security testing or penetration testing.
+- The task involves content discovery, subdomain enumeration, parameter fuzzing, or authenticated request fuzzing.
+- You need guidance on wordlists, filtering, calibration, and interpreting ffuf results efficiently.
+
 ## Overview
 FFUF is a fast web fuzzer written in Go, designed for discovering hidden content, directories, files, subdomains, and testing for vulnerabilities during penetration testing. It's significantly faster than traditional tools like dirb or dirbuster.
 

package/bundled-skills/find-bugs/SKILL.md

@@ -9,6 +9,12 @@ source: community
 
 Review changes on this branch for bugs, security vulnerabilities, and code quality issues.
 
+## When to Use
+
+- You need a review focused on bugs, security issues, or risky code changes.
+- The task involves auditing the current branch diff rather than implementing new behavior.
+- You want a structured review process with checklist-driven verification against changed files.
+
 ## Phase 1: Complete Input Gathering
 
 1. Get the FULL diff: `git diff $(gh repo view --json defaultBranchRef --jq '.defaultBranchRef.name')...HEAD`

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

@@ -10,6 +10,12 @@ source: community
 
 分析运动数据，识别运动模式，评估健身进展，并提供个性化训练建议。
 
+## When to Use
+
+- 需要分析运动记录、训练强度、运动习惯或健身进展时使用。
+- 任务涉及跑步、力量训练、耐力或柔韧性等维度的趋势与改进建议。
+- 需要把运动数据与其他健康模块做关联分析时使用。
+
 ## 功能
 
 ### 1. 运动趋势分析

package/bundled-skills/food-database-query/SKILL.md

@@ -14,6 +14,12 @@ source: community
 
 ---
 
+## When to Use
+
+- 需要查询食物营养成分、比较食物差异或做营养计算时使用。
+- 任务涉及食物数据库检索、食物推荐、份量换算或分类筛选。
+- 需要基于结构化食物数据生成分析结果而不是自由文本建议时使用。
+
 ## 技能概述
 
 本技能提供全面的营养食物数据库查询功能,支持食物营养信息查询、比较、推荐和自动营养计算。

package/bundled-skills/fp-async/SKILL.md

@@ -22,6 +22,12 @@ Stop writing nested try/catch blocks. Stop losing error context. Start building
 
 **TaskEither is simply an async operation that tracks success or failure.** That's it. No fancy terminology needed.
 
+## When to Use
+
+- You need async error handling in TypeScript with `TaskEither`.
+- The task involves wrapping Promises, composing API calls, or replacing nested `try/catch` flows.
+- You want practical fp-ts async patterns instead of academic explanations.
+
 ```typescript
 // TaskEither<Error, User> means:
 // "An async operation that either fails with Error or succeeds with User"

package/bundled-skills/fp-backend/SKILL.md

@@ -20,6 +20,12 @@ tags:
 
 Functional programming patterns for building type-safe, testable backend services using fp-ts.
 
+## When to Use
+
+- You are building or refactoring a Node.js or Deno backend with fp-ts.
+- The task involves dependency injection, service composition, or typed backend errors with `ReaderTaskEither`.
+- You need functional backend architecture patterns rather than isolated utility snippets.
+
 ## Core Concepts
 
 ### ReaderTaskEither (RTE)

package/bundled-skills/fp-data-transforms/SKILL.md

@@ -21,6 +21,12 @@ tags:
 
 This skill covers the data transformations you do every day: working with arrays, reshaping objects, normalizing API responses, grouping data, and safely accessing nested values. Each section shows the imperative approach first, then the functional equivalent, with honest assessments of when each approach shines.
 
+## When to Use
+
+- You need to transform arrays, objects, grouped data, or nested values in TypeScript.
+- The task involves reshaping API responses, null-safe access, aggregation, or normalization.
+- You want practical functional patterns for everyday data work instead of low-level loops.
+
 ---
 
 ## Table of Contents

package/bundled-skills/fp-either-ref/SKILL.md

@@ -11,6 +11,12 @@ tags: [fp-ts, either, error-handling, validation, quick-reference]
 
 Either = success or failure. `Right(value)` or `Left(error)`.
 
+## When to Use
+
+- You need a quick fp-ts reference for typed synchronous error handling.
+- The task involves validation, fallible operations, or converting throwing code to `Either`.
+- You want a compact cheat sheet rather than a long tutorial.
+
 ## Create
 
 ```typescript

package/bundled-skills/fp-errors/SKILL.md

@@ -21,6 +21,12 @@ This skill teaches you how to handle errors without try/catch spaghetti. No acad
 
 The core idea: **Errors are just data**. Instead of throwing them into the void and hoping someone catches them, return them as values that TypeScript can track.
 
+## When to Use
+
+- You need to replace exception-heavy code with `Either` or `TaskEither`.
+- The task involves validation, domain errors, or clearer error contracts in TypeScript.
+- You want pragmatic fp-ts error-handling guidance for real application code.
+
 ---
 
 ## 1. Stop Throwing Everywhere

package/bundled-skills/fp-option-ref/SKILL.md

@@ -11,6 +11,12 @@ tags: [fp-ts, option, nullable, maybe, quick-reference]
 
 Option = value that might not exist. `Some(value)` or `None`.
 
+## When to Use
+
+- You need a quick fp-ts reference for nullable or optional values.
+- The task involves eliminating null checks, safe property access, or optional chaining with `Option`.
+- You want a short reference card rather than a full migration guide.
+
 ## Create
 
 ```typescript

package/bundled-skills/fp-pragmatic/SKILL.md

@@ -18,6 +18,12 @@ tags:
 
 **Read this first.** This guide cuts through the academic jargon and shows you what actually matters. No category theory. No abstract nonsense. Just patterns that make your code better.
 
+## When to Use
+
+- You want a pragmatic starting point for fp-ts or functional programming in TypeScript.
+- The task is exploratory or educational and needs an 80/20 view of what is actually worth adopting.
+- You need guidance on when FP helps and when it is better to keep code simple.
+
 ## The Golden Rule
 
 > **If functional programming makes your code harder to read, don't use it.**

package/bundled-skills/fp-refactor/SKILL.md

@@ -21,6 +21,12 @@ tags:
 
 This skill provides comprehensive patterns and strategies for migrating existing imperative TypeScript code to fp-ts functional programming patterns.
 
+## When to Use
+
+- You are refactoring an existing imperative TypeScript codebase toward fp-ts patterns.
+- The task involves converting `try/catch`, null checks, callbacks, DI, or loops into functional equivalents.
+- You need migration guidance and tradeoffs, not just isolated fp-ts examples.
+
 ## Table of Contents
 
 1. [Converting try-catch to Either/TaskEither](#1-converting-try-catch-to-eithertaskeither)

package/bundled-skills/fp-taskeither-ref/SKILL.md

@@ -11,6 +11,12 @@ tags: [fp-ts, taskeither, async, promise, error-handling, quick-reference]
 
 TaskEither = async operation that can fail. Like `Promise<Either<E, A>>`.
 
+## When to Use
+
+- You need a quick fp-ts reference for async operations that can fail.
+- The task involves API calls, Promise wrapping, or composing asynchronous error-handling pipelines.
+- You want a concise cheat sheet for `TaskEither` operators and patterns.
+
 ## Create
 
 ```typescript

package/bundled-skills/fp-types-ref/SKILL.md

@@ -9,6 +9,12 @@ tags: [fp-ts, typescript, quick-reference, option, either, task]
 
 # fp-ts Quick Reference
 
+## When to Use
+
+- You need help choosing between `Option`, `Either`, `Task`, `TaskEither`, or related fp-ts types.
+- The task is about imports, decision guidance, or selecting the right abstraction for a TypeScript flow.
+- You want a compact reference for common fp-ts type choices and patterns.
+
 ## Which Type Should I Use?
 
 ```

package/bundled-skills/gh-review-requests/SKILL.md

@@ -12,6 +12,12 @@ Fetch unread `review_requested` notifications for open (unmerged) PRs, filtered
 
 **Requires**: GitHub CLI (`gh`) authenticated.
 
+## When to Use
+
+- You need to find unread GitHub PR review requests for a specific team.
+- You want to check which open PRs currently need your review or a teammate's review.
+- You need a filtered review queue instead of manually browsing GitHub notifications.
+
 ## Step 1: Identify the Team
 
 If the user has not specified a team, ask:

package/bundled-skills/gha-security-review/SKILL.md

@@ -17,6 +17,12 @@ Find exploitable vulnerabilities in GitHub Actions workflows. Every finding MUST
 
 This skill encodes attack patterns from real GitHub Actions exploits — not generic CI/CD theory.
 
+## When to Use
+
+- You are reviewing GitHub Actions workflows for exploitable security issues.
+- The task requires tracing a concrete attack path from an external attacker to workflow execution or secret exposure.
+- You need a security review of workflow files, composite actions, or workflow-related scripts with evidence-based findings only.
+
 ## Scope
 
 Review the workflows provided (file, diff, or repo). Research the codebase as needed to trace complete attack paths before reporting.

package/bundled-skills/gmail-automation/SKILL.md

@@ -15,6 +15,12 @@ Lightweight Gmail integration with standalone OAuth authentication. No MCP serve
 
 > **⚠️ Requires Google Workspace account.** Personal Gmail accounts are not supported.
 
+## When to Use
+
+- You need to search, read, or send Gmail messages from the command line without an MCP server.
+- You are automating inbox workflows for a Google Workspace account.
+- You want a lightweight Gmail integration backed by standalone OAuth scripts.
+
 ## First-Time Setup
 
 Authenticate with Google (opens browser):

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

@@ -10,6 +10,12 @@ source: community
 
 分析健康目标数据,识别目标模式和进度,评估目标达成情况,并提供个性化目标管理建议。
 
+## When to Use
+
+- 你需要评估健康目标是否符合 SMART 原则，并识别目标设定中的薄弱点。
+- 你想跟踪目标进度，并结合营养、运动、睡眠等健康数据做关联分析。
+- 你需要面向个人健康管理的目标优化建议、风险提示和阶段性调整方案。
+
 ## 功能
 
 ### 1. SMART目标验证

package/bundled-skills/google-calendar-automation/SKILL.md

@@ -15,6 +15,12 @@ Lightweight Google Calendar integration with standalone OAuth authentication. No
 
 > **⚠️ Requires Google Workspace account.** Personal Gmail accounts are not supported.
 
+## When to Use
+
+- You need to list, create, inspect, or update Google Calendar events from local scripts.
+- The task requires OAuth-backed calendar automation without standing up an MCP server.
+- You need quick operational access to calendars, schedules, attendees, or event details in a Workspace environment.
+
 ## First-Time Setup
 
 Authenticate with Google (opens browser):

package/bundled-skills/google-docs-automation/SKILL.md

@@ -15,6 +15,12 @@ Lightweight Google Docs integration with standalone OAuth authentication. No MCP
 
 > **⚠️ Requires Google Workspace account.** Personal Gmail accounts are not supported.
 
+## When to Use
+
+- You need to create, search, read, or edit Google Docs from local automation scripts.
+- The task involves document text extraction, append/insert operations, or content replacement in Workspace docs.
+- You want direct Docs automation without relying on an MCP server.
+
 ## First-Time Setup
 
 Authenticate with Google (opens browser):

package/bundled-skills/google-drive-automation/SKILL.md

@@ -15,6 +15,12 @@ Lightweight Google Drive integration with standalone OAuth authentication. No MC
 
 > **Requires Google Workspace account.** Personal Gmail accounts are not supported.
 
+## When to Use
+
+- You need to search, list, upload, download, move, or organize Google Drive files and folders.
+- The task requires direct Drive read/write automation through local scripts in a Workspace account.
+- You want file-level Drive operations without introducing an MCP server dependency.
+
 ## First-Time Setup
 
 Authenticate with Google (opens browser):

package/bundled-skills/google-slides-automation/SKILL.md

@@ -15,6 +15,12 @@ Lightweight Google Slides integration with standalone OAuth authentication. No M
 
 > **Requires Google Workspace account.** Personal Gmail accounts are not supported.
 
+## When to Use
+
+- You need to create, inspect, or modify Google Slides presentations from local automation.
+- The task involves reading slide text, adding/removing slides, or batch updating presentation content.
+- You want Slides automation for Workspace documents without using an MCP server.
+
 ## First-Time Setup
 
 Authenticate with Google (opens browser):

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

@@ -10,6 +10,12 @@ source: community
 
 分析一段时间内健康数据的趋势和模式，识别变化、相关性，并提供数据驱动的健康洞察。
 
+## When to Use
+
+- 需要分析一段时间内健康数据的趋势、相关性或显著变化时使用。
+- 任务涉及体重、症状、用药、化验、情绪或睡眠等多维度随时间变化。
+- 用户询问“最近健康状况有什么变化”或需要趋势报告时使用。
+
 ## 核心功能
 
 ### 1. 多维度趋势分析

package/bundled-skills/hugging-face-datasets/SKILL.md

@@ -8,6 +8,12 @@ source: community
 # Overview
 This skill provides tools to manage datasets on the Hugging Face Hub with a focus on creation, configuration, content management, and SQL-based data manipulation. It is designed to complement the existing Hugging Face MCP server by providing dataset editing and querying capabilities.
 
+## When to Use
+
+- You need to create, configure, or update datasets on the Hugging Face Hub.
+- You want SQL-style querying, transformation, or export flows over Hub datasets.
+- You are managing dataset content and metadata directly rather than only searching existing datasets.
+
 ## Integration with HF MCP Server
 - **Use HF MCP Server for**: Dataset discovery, search, and metadata retrieval
 - **Use This Skill for**: Dataset creation, content editing, SQL queries, data transformation, and structured data formatting

package/bundled-skills/hugging-face-evaluation/SKILL.md

@@ -11,6 +11,12 @@ This skill provides tools to add structured evaluation results to Hugging Face m
 - Importing benchmark scores from Artificial Analysis
 - Running custom model evaluations with vLLM or accelerate backends (lighteval/inspect-ai)
 
+## When to Use
+
+- You need to add structured evaluation results to a Hugging Face model card.
+- You want to import benchmark data or run custom evaluations with vLLM, lighteval, or inspect-ai.
+- You are preparing leaderboard-compatible `model-index` metadata for a model release.
+
 ## Integration with HF Ecosystem
 - **Model Cards**: Updates model-index metadata for leaderboard integration
 - **Artificial Analysis**: Direct API integration for benchmark imports

package/bundled-skills/hugging-face-tool-builder/SKILL.md

@@ -9,6 +9,12 @@ source: community
 
 Your purpose is now is to create reusable command line scripts and utilities for using the Hugging Face API, allowing chaining, piping and intermediate processing where helpful. You can access the API directly, as well as use the `hf` command line tool. Model and Dataset cards can be accessed from repositories directly.
 
+## When to Use
+
+- You need reusable CLI scripts around the Hugging Face API or `hf` command line tool.
+- You want shell-friendly utilities that support chaining, piping, and intermediate processing.
+- You are automating repeated Hub tasks and need a composable interface instead of ad hoc API calls.
+
 ## Script Rules
 
 Make sure to follow these rules:

package/bundled-skills/issues/SKILL.md

@@ -11,6 +11,12 @@ metadata:
 
 Interact with GitHub issues - create, list, and view issues.
 
+## When to Use
+
+- The user wants to create, list, inspect, or otherwise work with GitHub issues.
+- The task involves issue intake or repository issue management through the GitHub CLI workflow.
+- You need a guided issue flow that gathers titles, descriptions, and action selection before running commands.
+
 ## Instructions
 
 This command helps you work with GitHub issues using the `gh` CLI.

package/bundled-skills/landing-page-generator/SKILL.md

@@ -17,6 +17,12 @@ Generate high-converting landing pages from a product description. Output comple
 **Target:** LCP < 1s · CLS < 0.1 · FID < 100ms  
 **Output:** TSX components + Tailwind styles + SEO meta + copy variants
 
+## When to Use
+
+- You need to generate a marketing landing page in Next.js or React.
+- The task involves conversion-focused page structure, section variants, Tailwind styling, or SEO-aware copy.
+- You want complete landing-page output from a product description rather than isolated UI fragments.
+
 ## Core Capabilities
 
 - 5 hero section variants (centered, split, gradient, video-bg, minimal)

package/bundled-skills/makepad-animation/SKILL.md

@@ -19,6 +19,12 @@ You are an expert at Makepad animations. Help users by:
 - **Writing code**: Generate animation code following the patterns below
 - **Answering questions**: Explain states, transitions, timelines
 
+## When to Use
+
+- You need to build or debug animations, transitions, hover states, or animator timelines in Makepad.
+- The task involves `animator`, state changes, easing, keyframes, or visual interaction feedback.
+- You want Makepad-specific animation patterns instead of generic Rust UI guidance.
+
 ## Documentation
 
 Refer to the local files for detailed documentation:

package/bundled-skills/makepad-basics/SKILL.md

@@ -19,6 +19,12 @@ You are an expert at the Rust `makepad-widgets` crate. Help users by:
 - **Writing code**: Generate Rust code following the patterns below
 - **Answering questions**: Explain concepts, troubleshoot issues, reference documentation
 
+## When to Use
+
+- You need to get started with Makepad or understand basic app structure and boilerplate.
+- The task involves project setup, `live_design!`, `app_main!`, or first-screen application wiring.
+- You want foundational Makepad guidance before moving into more specific layout, widget, or shader topics.
+
 ## Documentation
 
 Refer to the local files for detailed documentation:

package/bundled-skills/makepad-deployment/SKILL.md

@@ -14,6 +14,12 @@ source: community
 
 This skill covers packaging Makepad applications for all supported platforms.
 
+## When to Use
+
+- You need to package, distribute, or automate deployment of a Makepad application.
+- The task involves desktop installers, APK/IPA builds, WebAssembly output, or CI-based release artifacts.
+- You need guidance on `cargo-packager`, `cargo-makepad`, or GitHub Actions packaging flows for Makepad.
+
 ## Quick Navigation
 
 | Platform | Tool | Output |

package/bundled-skills/makepad-dsl/SKILL.md

@@ -19,6 +19,12 @@ You are an expert at the Rust `makepad-widgets` crate DSL. Help users by:
 - **Writing code**: Generate DSL code following the patterns below
 - **Answering questions**: Explain DSL syntax, inheritance, property overriding
 
+## When to Use
+
+- You need help with Makepad `live_design!` syntax, object definitions, or inheritance patterns.
+- The task involves widget declarations, property overrides, prototypes, or DSL composition rules.
+- You want Makepad DSL-specific examples rather than generic Rust syntax advice.
+
 ## Documentation
 
 Refer to the local files for detailed documentation:

package/bundled-skills/makepad-event-action/SKILL.md

@@ -20,6 +20,12 @@ You are an expert at Makepad event and action handling. Help users by:
 - **Creating actions**: Widget-to-parent communication
 - **Event flow**: Understanding event propagation
 
+## When to Use
+
+- You need to handle input, lifecycle, or UI interaction events in Makepad.
+- The task involves `handle_event`, `Event` variants, `Hit` processing, or widget action propagation.
+- You need to design or debug Makepad event/action flow between widgets and parents.
+
 ## Documentation
 
 Refer to the local files for detailed documentation:

package/bundled-skills/makepad-layout/SKILL.md

@@ -20,6 +20,12 @@ You are an expert at Makepad layout system. Help users by:
 - **Writing code**: Generate layout code following the patterns below
 - **Answering questions**: Explain layout concepts, sizing, flow directions
 
+## When to Use
+
+- You need to size, align, or position widgets in a Makepad UI.
+- The task involves `Walk`, `Align`, `Fit`, `Fill`, padding, spacing, or container flow configuration.
+- You want Makepad-specific layout solutions for centering, responsiveness, or composition.
+
 ## Documentation
 
 Refer to the local files for detailed documentation:

package/bundled-skills/makepad-platform/SKILL.md

@@ -20,6 +20,12 @@ You are an expert at Makepad cross-platform development. Help users by:
 - **Understanding platforms**: Explain supported platforms and backends
 - **Platform-specific code**: Help with conditional compilation and platform APIs
 
+## When to Use
+
+- You need to understand or target specific platforms and graphics backends in Makepad.
+- The task involves platform compatibility, conditional compilation, or OS-specific behavior across desktop, mobile, or web.
+- You need guidance on backend differences such as Metal, D3D11, OpenGL, WebGL, or platform modules.
+
 ## Documentation
 
 Refer to the local files for detailed documentation:

package/bundled-skills/makepad-reference/SKILL.md

@@ -9,6 +9,12 @@ source: community
 
 This category provides reference materials for debugging, code quality, and advanced layout patterns.
 
+## When to Use
+
+- You need quick-reference material for common Makepad errors, debugging, or API lookups.
+- The task is diagnostic or reference-oriented rather than writing a focused feature in one subsystem.
+- You want a central starting point before diving into more specialized Makepad skills.
+
 ## Quick Navigation
 
 | Topic | File | Use When |

package/bundled-skills/makepad-shaders/SKILL.md

@@ -19,6 +19,12 @@ You are an expert at Makepad shaders. Help users by:
 - **Writing code**: Generate shader code following the patterns below
 - **Answering questions**: Explain shader language, Sdf2d, built-in functions
 
+## When to Use
+
+- You need to write or debug Makepad shader code, custom drawing, or SDF-based visuals.
+- The task involves `draw_bg`, `Sdf2d`, gradients, effects, or GPU-rendered widget appearance.
+- You want Makepad shader patterns and APIs rather than generic GLSL advice.
+
 ## Documentation
 
 Refer to the local files for detailed documentation:

package/bundled-skills/makepad-splash/SKILL.md

@@ -18,6 +18,12 @@ You are an expert at Makepad Splash scripting language. Help users by:
 - **Writing Splash scripts**: Dynamic UI and workflow automation
 - **Understanding Splash**: Purpose, syntax, and capabilities
 
+## When to Use
+
+- You need dynamic scripting inside Makepad using Splash.
+- The task involves `script!`, `cx.eval`, runtime-generated UI, or workflow automation in Makepad.
+- You want guidance on Splash syntax and purpose rather than static Rust-only patterns.
+
 ## Documentation
 
 Refer to the local files for detailed documentation:

package/bundled-skills/makepad-widgets/SKILL.md

@@ -15,6 +15,12 @@ You are an expert at Makepad widgets. Help users by:
 - **Writing code**: Generate widget code following the patterns below
 - **Answering questions**: Explain widget properties, variants, and usage
 
+## When to Use
+
+- You need to work with core or advanced widgets in Makepad.
+- The task involves widget selection, properties, variants, composition, or widget-specific behavior.
+- You want examples for `View`, `Button`, labels, rich text, or other `makepad-widgets` building blocks.
+
 ## Documentation
 
 Refer to the local files for detailed documentation:

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

@@ -8,6 +8,12 @@ source: community
 
 # 心理健康分析技能
 
+## When to Use
+
+- 需要分析情绪、焦虑、抑郁评分、治疗进展或危机风险时使用。
+- 任务涉及心理健康趋势、情绪模式识别或与睡眠/运动/营养的关联分析。
+- 用户请求心理健康报告、风险预警或治疗进展追踪时使用。
+
 ## 核心功能
 
 心理健康分析技能提供全面的心理健康数据分析功能，帮助用户追踪心理状态、识别情绪模式、监测危机风险和优化应对策略。

package/bundled-skills/molykit/SKILL.md

@@ -15,7 +15,7 @@ Best practices for building AI chat interfaces with Makepad using MolyKit - a to
 
 **Source codebase**: `/Users/zhangalex/Work/Projects/FW/robius/moly/moly-kit`
 
-## Triggers
+## When to Use
 
 Use this skill when:
 - Building AI chat interfaces with Makepad

package/bundled-skills/n8n-expression-syntax/SKILL.md

@@ -9,6 +9,12 @@ source: community
 
 Expert guide for writing correct n8n expressions in workflows.
 
+## When to Use
+
+- You need to write or debug n8n expressions using `{{ ... }}` syntax.
+- The task involves `$json`, `$node`, webhook payloads, or expression-related workflow errors.
+- You want syntax-correct dynamic values inside n8n nodes and parameters.
+
 ---
 
 ## Expression Format

package/bundled-skills/n8n-mcp-tools-expert/SKILL.md

@@ -9,6 +9,12 @@ source: community
 
 Master guide for using n8n-mcp MCP server tools to build workflows.
 
+## When to Use
+
+- You are using the `n8n-mcp` toolset to discover nodes, validate configs, or manage workflows.
+- The task involves choosing the right MCP tool or understanding its expected parameters and usage pattern.
+- You need guidance on workflow creation or editing through n8n MCP rather than through the n8n UI alone.
+
 ---
 
 ## Tool Categories

package/bundled-skills/n8n-node-configuration/SKILL.md

@@ -9,6 +9,12 @@ source: community
 
 Expert guidance for operation-aware node configuration with property dependencies.
 
+## When to Use
+
+- You need to configure an n8n node correctly for a specific resource and operation.
+- The task involves required fields, property dependencies, or choosing the right `get_node` detail level.
+- You are troubleshooting node setup rather than overall workflow architecture.
+
 ---
 
 ## Configuration Philosophy

package/bundled-skills/n8n-validation-expert/SKILL.md

@@ -9,6 +9,12 @@ source: community
 
 Expert guide for interpreting and fixing n8n validation errors.
 
+## When to Use
+
+- You need to interpret or fix validation errors in an n8n workflow.
+- The task involves `missing_required`, `invalid_value`, expression failures, or iterative validate-fix loops.
+- You want concrete remediation guidance for workflow validation output.
+
 ---
 
 ## Validation Philosophy