vibe-engineering

33 engineering discipline skills for Claude Code, OpenAI Codex & Gemini CLI + a CLI for CI/CD enforcement. Extracted from real-world multi-agent system development: not theoretical best practices, but patterns that survived 3 weeks of intensive production development with 205+ test files, 11 agents, and 50+ session observations.

"Vibe coding" meets engineering rigor. Every skill here exists because skipping it caused real pain, and every skill was re-checked in v2.0 against what current models and agent harnesses now handle on their own.

Two commands. Instant engineering discipline.

/plugin marketplace add ash1794/vibe-engineering
/plugin install vibe-engineering@vibe-plugins

Your agent picks the right skill from its description: research before design, quality gates before shipping, evidence before claiming "done."

What's new in v2.2

• New skill: vibe-slop-filter counts the tells that make prose read as machine-written (keyword saturation, stacked tricolons, "not X, it's Y", bolded thesis lines, signpost phrases) and fixes the reflexive ones without sanding out real voice.
• vibe-devil-advocate-review now reviews any artifact as a named senior expert in its field: code, specs, proposals, policies, curricula. It searches assuming defects exist, reports only those it can evidence, names genuine strengths in a line, and checks its own review for manufactured findings before sending.

Earlier releases:

• v2.1 added vibe-workstream-orchestration, vibe-publication-leak-guard, and vibe-flake-root-cause from a multi-agent production build, plus panel mode, deploy provenance, wind-down handovers, and performance budgets in existing skills.
• v2.0 re-audited every skill against current Claude, GPT, and Gemini models and consolidated 38 skills into 29. If you're upgrading from v1.x, read the migration notes.

Full history: CHANGELOG · Releases

What is this?

A skill collection in the open Agent Skills format with 33 skills that enforce engineering discipline across any project, plus a lightweight CLI (vibe-cli) for CI/CD pipelines and automation:

• Research & Decision-Making (3 skills): think before building
• Quality Gates & Validation (8 skills): catch issues before they ship
• Knowledge & Continuity (2 skills): never solve the same problem twice
• Parallel & Multi-Agent Development (3 skills): scale your work safely
• Testing Patterns (6 skills): test what matters, not just what's easy
• Deployment & Operations (5 skills): ship with confidence
• Gap Analysis & Remediation (2 skills): audit and systematically close gaps
• Process (3 skills): stay focused, build to the right standard
• Meta (1 skill): skill routing

What the skills don't do

Modern models and harnesses already handle some things well, and a skill that duplicates them only adds noise. v2.0 removed skills for context-window management (harnesses compact automatically), output formatting (models format well by default), always-on skill bootstrapping (skills trigger from their descriptions), and private task queues (use your issue tracker). See CHANGELOG for the full list and migration.

Installation

Claude Code

From inside a Claude Code session:

# 1. Add the marketplace (one-time)
/plugin marketplace add ash1794/vibe-engineering

# 2. Install the plugin
/plugin install vibe-engineering@vibe-plugins

Later, pull updates with /plugin marketplace update vibe-plugins.

Local development (unpackaged, for testing plugin changes):

git clone https://github.com/ash1794/vibe-engineering.git
claude --plugin-dir ./vibe-engineering/plugins/vibe-engineering

All 33 skills are now available in every Claude Code session.

OpenAI Codex & Gemini CLI

Both read skills from .agents/skills/, the cross-tool path in the Agent Skills standard, so one set of symlinks covers both:

# Clone once, symlink many times
git clone https://github.com/ash1794/vibe-engineering.git ~/src/vibe-engineering

# User-wide (available in all projects)
mkdir -p ~/.agents/skills
ln -s ~/src/vibe-engineering/plugins/vibe-engineering/skills/* ~/.agents/skills/

# Or per-project
mkdir -p .agents/skills
ln -s ~/src/vibe-engineering/plugins/vibe-engineering/skills/* .agents/skills/

Gemini CLI also accepts ~/.gemini/skills/ and .gemini/skills/. Run /skills in Gemini CLI to confirm the skills were discovered.

Upgrading from 1.x with symlinks? Skill folders were renamed to match their name (e.g. quality-loop/ → vibe-quality-loop/) and 9 skills were retired, so remove your old symlinks and re-run the ln -s command above.

Quick Start

After installation, skills activate automatically when a task matches their description.

Find the right skill:

/vibe-engineering:vibe-help        # Claude Code
$vibe-help                         # Codex

Invoke any skill directly:

# Claude Code
/vibe-engineering:vibe-quality-loop
/vibe-engineering:vibe-research-before-design

# Codex
$vibe-quality-loop
$vibe-research-before-design

In Gemini CLI, skills are activated automatically from their descriptions, or you can ask for one by name.

CLI: vibe-cli

The vibe-cli CLI wraps critical skills into CI/CD-friendly commands with proper exit codes and JSON output. No dependencies — pure bash.

Setup

# Make it available system-wide (optional)
ln -s $(pwd)/scripts/vibe-cli /usr/local/bin/vibe-cli

# Or run directly from the repo
./scripts/vibe-cli help

Commands

vibe-cli pre-commit          # Scan staged changes for secrets, debug code, disabled tests
vibe-cli coverage            # Run test coverage and report against tier targets
vibe-cli spec-drift          # Detect spec-code drift from staged ch