⚡ Vibe Kit - The Ultimate AI Skill Vault

Vibe Kit is a professional-grade CLI tool and curated library designed to empower your AI agents (like Antigravity) with domain expertise, repeatable workflows, and elite design principles.

🚀 Installation & Setup

1. Prerequisites

• Node.js: v18 or higher.
• Project Structure: Designed to work with agents that respect the .agent/skills/ directory convention.

2. Usage via npx (Easiest)

No installation required! Run the commands directly using npx:

npx @ruaruababa/vibe-kit <command>

3. Local Development Setup

If you want to contribute to the kit:

git clone ...
npm install
npm link

✨ Features & Usage Examples

1. List Available Vibes

View the entire collection of 300+ skills in a clean, high-level list.

# Command
npx @ruaruababa/vibe-kit list

# Example Output
# • ui-minimal - Principles for creating clean, minimalist, and premium UI components.
# • node-expert - Advanced patterns for building scalable and maintainable Node.js services.

2. Search for specialized knowledge

Use fuzzy search to find specific vibes by keywords in their name or description.

# Command
npx @ruaruababa/vibe-kit search <keyword>

# Example: Finding Kubernetes skills
npx @ruaruababa/vibe-kit search k8s

3. Browse Skill Bundles

Instead of hunting for individual skills, explore curated "Starter Packs" tailored for specific job roles.

# Command
npx @ruaruababa/vibe-kit bundles

# Example Output:
# • core-dev: Core development skills across languages and frameworks.
# • security-core: Security, privacy, and compliance essentials.

4. Install a Single Vibe

Instantly copy a specific skill into your current workspace. Supports Aliases (short-names).

# Command
npx @ruaruababa/vibe-kit install <vibe-name>

# Example: Using an alias 'node-pro' instead of 'nodejs-backend-patterns'
npx @ruaruababa/vibe-kit install node-pro

5. Install a Complete Bundle

The most efficient way to onboard your agent to a new stack. This installs dozens of related skills in one go.

# Command
npx @ruaruababa/vibe-kit install <bundle-name> --bundle

# Example: Setup a new backend project with the essential dev stack
npx @ruaruababa/vibe-kit install core-dev --bundle

6. View Skill Aliases

See the mapping of short names to their full library paths.

# Command
npx @ruaruababa/vibe-kit aliases

🛠️ Developer Commands (Maintenance)

| Command | Description | |---------|-------------| | npm run build:catalog | Traverses skills/, extracts metadata, and regenerates catalog.json and CATALOG.md. | | npm run validate | Runs a Zod-backed validation on all SKILL.md files in the vault to ensure schema compliance. | | node scripts/normalize-frontmatter.js | Enforces standard YAML headers across the entire 300+ skill library. |

📂 Project Architecture

@ruaruababa/vibe-kit/
├── bin/vibe.js         # Global CLI Entry Point
├── src/cli/index.ts    # CLI Command Implementations
├── src/types/index.ts  # Zod Schemas & TypeScript Definitions
├── scripts/            # Automation & Maintenance Scripts
├── skills/             # The Vault (300+ Markdown instruction packages)
├── catalog.json        # Machine-readable skill index
└── CATALOG.md          # Human-readable skill index (Auto-generated)

🎨 Design Philosophy

Vibe Kit follows a minimalist, premium aesthetics approach. All terminal output is color-coded using chalk and uses ora spinners for a smooth, professional feel.

[!TIP] Always run npx @ruaruababa/vibe-kit install core-dev --bundle when starting a new project to ensure your agent is operating with maximum domain expertise.