dependabot
Comprehensive guide for configuring and managing GitHub Dependabot. Use this skill when users ask about creating or optimizing dependabot.yml files, managing Dependabot pull requests, configuring dependency update strategies, setting up grouped updates, monorepo patterns, multi-ecosystem groups, sec
By github · 4,373 installs
npx skills add github/awesome-copilot --skill dependabot
Source repository · Upstream listing
Dependabot Configuration & Management
Overview
Dependabot is GitHub's built in dependency management tool with three core capabilities:
1. Dependabot Alerts — Notify when dependencies have known vulnerabilities (CVEs)
2. Dependabot Security Updates — Auto create PRs to fix vulnerable dependencies
3. Dependabot Version Updates — Auto create PRs to keep dependencies current
All configuration lives in a single file : .github/dependabot.yml on the default branch. GitHub does not support multiple dependabot.yml files per repository.
Configuration Workflow
Follow this process when creating or optimizing a dependabot.yml :
Step 1: Detect All Ecosystems
Scan the repository for dependency manifests. Look for:
Ecosystem YAML Value Manifest Files
npm/pnpm/yarn npm package.json , package lock.json , pnpm lock.yaml , yarn.lock
pip/pipenv/poetry pip requirements.txt , Pipfile , pyproject.toml , setup.py
uv uv pyproject.toml , uv.lock
Docker docker Dockerfile
Docker Compose docker compose docker compose.yml
GitHub Actions github actions .github/workflows/ .yml
Go modules gomod go.mod
Bundler (Ruby) bundler Gemfile
Cargo (Rust) cargo Cargo.toml
Composer (PHP) composer composer.json
NuGet (.NET) nuget .csproj , packages.config
.NET SDK dotnet sdk global.json
Maven (Java) maven pom.xml
Gradle (Java) gradle build.gradle
Terraform terraform .tf
OpenTofu opentofu .tf
Helm helm Chart.yaml
Hex (Elixir) mix mix.exs
Swift swift Package.swift
Pub (Dart) pub pubspec.yaml
Bun bun bun.lockb
Dev Containers devcontainers devcontainer.json
Git Submodules gitsubmodule .gitmodules
Pre commit pre commit .pre commit config.yaml
Notes:
pnpm and yarn both use the npm ecosystem value.
Prefer uv ecosystem value when uv.lock is present; otherwise use pip .
Step 2: Map Directory Locations
For each ecosystem, identify where manifests live. Use directories (plural) with glob patterns for monorepos:
Important: directory (singular) does NOT support globs. Use directories (plural) for wildcards.
Step 3: Configure Each Ecosystem Entry
Every entry needs at minimum:
Step 4: Optimize with Grouping, Labels, and Scheduling
See sections below for each optimization technique.
Monorepo Strategies
Glob Patterns for Workspace Coverage
For monorepos with many packages, use glob patterns to avoid listing each directory:
Cross Directory Grouping
Use group by: dependency name to create a single PR when the same dependency updates across multiple directories:
This creates one PR per dependency across all specified directories, reducing CI costs and review burden.
Limitations:
All directories must use the same package ecosystem
Applies to version updates only
Incompatible version constraints create separate PRs
Standalone Packages Outside Workspaces
If a directory has its own lockfile and is NOT part of the workspace (e.g., scripts in .github/ ), create a separate ecosystem entry for it.
Dependency Grouping
Reduce PR noise by grouping related dependencies into single PRs.
By Dependency Type
By Name Pattern
For Security Updates
Key behaviors:
Dependencies matching multiple groups go to the first match
applies to defaults to version updates when absent
Ungrouped dependencies get individual PRs
Multi Ecosystem Groups
Combine updates across different package ecosystems into a single PR:
The patterns key is required when using multi ecosystem group .
PR Customization
Labels
Set labels: [] to disable all labels including defaults. SemVer labels ( major , minor , patch ) are always applied if present in the repo.
Commit Messages
Assignees and Milestones
Branch Name Separator
Target Branch
Note: When target branch is set, security updates still target the default branch; all ecosystem config only applies to version updates.
Schedule Optimization
Intervals
Supported: daily , weekly , monthly , quarterly , semiannually , yearly , cron
Cron Expressions
Cooldown Periods
Delay updates for newly released versions to avoid early adopter issues:
Cooldown applies to version updates only, not security updates.
Security Updates Configuration
Enable via Repository Settings
Settings → Advanced Security → Enable Dependabot alerts, security updates, and grouped security updates.
Group Security Updates in YAML
Disable Version Updates (Security Only)
Auto Triage Rules
GitHub presets auto dismiss low impact alerts for development dependencies. Custom rules can filter by severity, package name, CWE, and more. Configure in repository Settings → Advanced Security.
PR Comment Commands
Interact with Dependabot PRs using @dependabot comments.
Note: As of January 2026, merge/close/reopen commands have been deprecated.
Use GitHub's native UI, CLI ( gh pr merge ), or auto merge instead.
Command Effect
@dependabot rebase Rebase the PR
@dependabot recreate Recreate the PR from scratch
@dependabot ignore this dependency Close and never update this dependency
@dependabot ignore this major version Ignore this major version
@dependabot ignore this minor version Ignore this minor version
@dependabot ignore this patch version Ignore this patch version
For grouped PRs, additional commands:
@dependabot ignore DEPENDENCY NAME — ignore specific dependency in group
@dependabot unignore DEPENDENCY NAME — clear ignores, reopen with updates
@dependabot unignore — clear all ignores for all dependencies in group
@dependabot show DEPENDENCY NAME ignore conditions — display current ignores
For the complete command reference, see references/pr commands.md .
Ignore and Allow Rules
Ignore Specific Dependencies
Allow Only Specific Types
Rule: If a dependency matches both allow and ignore , it is ignored .
Exclude Paths
Advanced Options
Versioning Strategy
Controls how Dependabot edits version constraints:
Value Behavior
auto Default — increase for apps, widen for libraries
increase Always increase minimum version
increase if necessary Only change if current range excludes new version
lockfile only Only update lockfiles, ignore manifests
widen Widen range to include both old and new versions
Rebase Strategy
Allow rebase over extra commits by including [dependabot skip] in commit messages.
Open PR Limit
Set to 0 to disable version updates entirely.
Private Registries
FAQ
Can I have multiple dependabot.yml files?
No. GitHub supports exactly one file at .github/dependabot.yml . Use multiple updates entries within that file for different ecosystems and directories.
Does Dependabot support pnpm?
Yes. Use package ecosystem: "npm" — Dependabot detects pnpm lock.yaml automatically.
How do I reduce PR noise in a monorepo?
Use groups to batch updates, directories with globs for coverage, and group by: dependency name for cross directory grouping. Consider monthly or quarterly intervals for low priority ecosystems.
How do I handle dependencies outside the workspace?
Create a separate ecosystem entry with its own directory pointing to that location.
Pre Commit Dependency Scanning via AI Coding Agents
For scanning code changes for vulnerable dependencies inside an AI coding agent before committing, the GitHub MCP Server's dependabot toolset can check your dependency additions against the GitHub Advisory Database and return structured results with affected packages, severity, and recommended fixed versions. For more thorough post commit checks, it can also run the Dependabot CLI locally to diff dependency graphs before and after your changes.
Install the Advanced Security plugin which provides dedicated dependency scanning tools and the /dependency scanning skill.
GitHub Copilot CLI (shell):
GitHub Copilot CLI (inside copilot ):
Visual Studio Code:
Add "X MCP Toolsets": "dependabot" to your GitHub MCP Server headers, or pick Dependabot from the toolset selector in Copilot Chat
Install the advanced security plugin, then use /dependency scanning in Copilot Chat
Example prompt:
Scan the dependencies I added on this branch for known vulnerabilities and tell me which versions to upgrade to before I commit.
See: [Advanced Security Plugin — Dependency Scanning Skill](https://github.com/github/copilot plugins/blob/main/plugins/advanced security/skills/dependency scanning/SKILL.md)
Announced in [Dependency scanning with GitHub MCP Server is in public preview](https://github.blog/changelog/2026 05 05 dependency scanning with github mcp server is in public preview/) (May 2026)
Resources
references/dependabot yml reference.md — Complete YAML options reference
references/pr commands.md — Full PR comment commands reference
references/example configs.md — Real world configuration examples