dependency_gate

Documents justification, alternatives, and security review in DECISIONS.md before installing new dependencies.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/Vimurai/ai-os --skill dependency-gate-vimurai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dependency_gate
Source: https://github.com/Vimurai/ai-os/tree/main/.claude/skills/dependency_gate
Command: npx skills add https://github.com/Vimurai/ai-os --skill dependency-gate-vimurai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often add npm, pip, or Go packages impulsively, accumulating bloated, unmaintained, or vulnerable dependencies with no record of why they were chosen. This Skill enforces a documented decision gate before any new major dependency is installed. ## Core Features & Use Cases - Mandatory Decision Record: Requires an entry in .ai/DECISIONS.md covering justification, alternatives considered, size, security track record, maintenance status, license, and rollback plan before installation. - Human Approval Gate: Blocks installation until a human sets Decision: <chosen option> in the decision record. - Existing Dependency Awareness: Injects the current dependency list from package.json or requirements.txt into context so new additions are evaluated against what is already installed. - Use Case: Before running npm install lodash, the Skill prompts you to record why lodash is needed, what alternatives were weighed, its CVE history, and how to remove it — then waits for explicit approval. ## Quick Start Ask the agent to add a new package such as "run the dependency gate before installing axios" and it will draft the DECISIONS.md entry for your approval.

Frequently Asked Questions about dependency_gate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document a new dependency before installing it?▼

Record an entry in .ai/DECISIONS.md covering why the dependency is needed, alternatives considered, size, security track record, maintenance status, license, and rollback plan. Installation only proceeds after a human sets the Decision field.

What package managers does the dependency gate cover?▼

The gate applies to any major dependency addition, including npm install, pip install, and go get. It reads existing dependencies from package.json or requirements.txt to provide context for the evaluation.

Does the dependency gate apply to dev and test dependencies?▼

Dev and test-only dependencies with no security surface get a lighter process: a brief note in DECISIONS.md is sufficient instead of the full justification template. Major runtime dependencies still require the complete review.

Can a dependency be installed without human approval?▼

No. The Skill explicitly blocks installation until a human sets Decision: <chosen option> in the DECISIONS.md entry. The agent drafts the evaluation but cannot approve or install on its own.

What should a dependency rollback plan include?▼

A rollback plan describes how to remove the dependency if it causes problems, such as which imports or call sites to revert and whether a replacement exists. It is a required field in the DECISIONS.md entry before approval.