Installation

Overview

Impeccable is distributed as provider-specific bundles optimized for each AI tool. This guide covers installation for all 4 supported providers.

Recommended: Download from impeccable.style for ready-to-use bundles with automatic updates.

Choose Your Provider

Cursor

AI-first code editor

Claude Code

Browser-based coding assistant

Gemini CLI

Google’s command-line tool

Codex CLI

OpenAI’s command-line tool

Cursor

Cursor supports the Agent Skills standard. Impeccable installs as skills in your project’s .cursor/ directory.

Requirements

Cursor skills require Nightly channel and Agent Skills to be enabled. Standard releases don’t support skills yet.

Switch to Nightly Channel

Open Cursor Settings
Go to Beta section
Switch to Nightly channel
Restart Cursor

Enable Agent Skills

Open Cursor Settings
Go to Rules section
Enable Agent Skills

Option 1: Website (Recommended)
Option 2: From Repository

Download Bundle

Visit impeccable.style and click Download for Cursor.

Extract to Project

# Navigate to your project
cd your-project/

# Extract the ZIP
unzip ~/Downloads/impeccable-cursor.zip -d .

# Verify installation
ls -la .cursor/skills/

You should see:

.cursor/skills/
├── frontend-design/
│   ├── SKILL.md
│   └── reference/
├── audit/
├── polish/
├── animate/
└── ... (14 more commands)

Verify in Cursor

Open Cursor and type / in the chat. You should see Impeccable commands:

/audit
/polish
/animate
And 14 more…

If you’ve cloned the Impeccable repository:

# Clone the repository
git clone https://github.com/pbakaus/impeccable.git
cd impeccable

# Copy to your project
cp -r dist/cursor/.cursor your-project/

The dist/ directory contains pre-built files. You don’t need to run the build system.

Usage

Once installed, use commands in Cursor’s chat:

/audit components/Button.jsx
/polish src/pages/Landing.tsx
/animate dashboard

Commands work project-wide. The skills are automatically loaded when you use them.

Troubleshooting

Commands don't appear in autocomplete

Verify you’re on Nightly channel (Settings → Beta)
Ensure Agent Skills is enabled (Settings → Rules)
Restart Cursor completely
Check .cursor/skills/ directory exists

Cursor doesn't load the skill

Skills must follow the Agent Skills standard. Verify SKILL.md files have proper frontmatter:

---
name: audit
description: Perform comprehensive audit...
user-invokable: true
---

Claude Code

Claude Code has native support for skills in .claude/ directories. Works both project-specific and globally.

Requirements

No special setup required! Claude Code automatically detects skills.

Installation

Project-Specific (Recommended)
Global Installation
From Repository

Install in your project to share skills with your team:

Download Bundle

Visit impeccable.style and click Download for Claude Code.

Extract to Project

# Navigate to your project
cd your-project/

# Extract the ZIP
unzip ~/Downloads/impeccable-claude-code.zip -d .

# Verify installation
ls -la .claude/skills/

You should see:

.claude/skills/
├── frontend-design/
│   ├── SKILL.md
│   └── reference/
├── audit/
├── polish/
└── ... (15 more)

Commit to Version Control

git add .claude/
git commit -m "Add Impeccable design skills"

This makes skills available to your entire team automatically.

Install globally to use across all projects:

# Extract to home directory
unzip ~/Downloads/impeccable-claude-code.zip -d ~

# Move to global location
cp -r ~/.claude/skills/* ~/.claude/ || mkdir -p ~/.claude && cp -r .claude/skills ~/.claude/

# Verify
ls -la ~/.claude/skills/

Global skills apply to ALL projects. Use project-specific installation for team projects.

# Clone the repository
git clone https://github.com/pbakaus/impeccable.git
cd impeccable

# Project-specific
cp -r dist/claude-code/.claude your-project/

# Or global
cp -r dist/claude-code/.claude/* ~/.claude/

Usage

Commands work in Claude Code’s chat:

/audit components/Dashboard.tsx
/polish checkout flow
/animate hero section

Claude Code shows available skills when you type /. Commands autocomplete automatically.

Troubleshooting

Commands don't appear

Verify .claude/skills/ directory exists in your project or ~/.claude/skills/ globally
Check SKILL.md files have proper YAML frontmatter
Refresh Claude Code (reload the page)

Gemini CLI

Gemini CLI uses TOML format for commands and modular imports for skills.

Requirements

Gemini CLI skills require preview version and manual skill enablement.

Install Preview Version

npm i -g @google/gemini-cli@preview

Enable Skills

# Run Gemini CLI
gemini

# In the CLI:
/settings

# Enable "Skills" option
# Exit and restart

Installation

Option 1: Website (Recommended)
Option 2: From Repository

Download Bundle

Visit impeccable.style and click Download for Gemini CLI.

Extract to Project

# Navigate to your project
cd your-project/

# Extract the ZIP
unzip ~/Downloads/impeccable-gemini.zip -d .

# Verify installation
ls -la .gemini/
ls -la GEMINI*.md

You should see:

.gemini/
└── commands/
    ├── audit.toml
    ├── polish.toml
    └── ... (15 more)

GEMINI.md
GEMINI.frontend-design.md
GEMINI.audit.md
...

Verify in Gemini CLI

# In Gemini CLI
/skills list

You should see Impeccable skills listed.

# Clone the repository
git clone https://github.com/pbakaus/impeccable.git
cd impeccable

# Copy to your project
cp -r dist/gemini/.gemini your-project/
cp dist/gemini/GEMINI*.md your-project/

Usage

Commands in Gemini CLI use standard slash syntax:

/audit components/Header.tsx
/polish navigation
/animate page transitions

Gemini CLI uses modular imports. Main GEMINI.md file imports skill modules using @./GEMINI.*.md syntax.

Troubleshooting

Commands not recognized

Verify you’re on preview version: gemini --version
Check skills are enabled in /settings
Run /skills list to see loaded skills
Verify .gemini/commands/ contains .toml files

Skills not loading

Gemini expects GEMINI.md and modular files in project root:

your-project/
├── GEMINI.md                    # Main import file
├── GEMINI.frontend-design.md   # Skill modules
└── .gemini/                     # Commands directory
    └── commands/

Codex CLI

Codex CLI uses a custom prompt format and invokes commands with /prompts: prefix.

Requirements

Codex CLI works with standard installation. No special setup required.

Installation

Option 1: Website (Recommended)
Option 2: From Repository

Download Bundle

Visit impeccable.style and click Download for Codex CLI.

Extract to Home Directory

Codex CLI expects skills in ~/.codex/:

# Extract the ZIP
unzip ~/Downloads/impeccable-codex.zip -d ~

# Verify installation
ls -la ~/.codex/prompts/
ls -la ~/.codex/skills/

You should see:

~/.codex/
├── prompts/
│   ├── audit.md
│   ├── polish.md
│   └── ... (15 more)
└── skills/
    ├── frontend-design/
    └── ... (17 more)

Verify in Codex

# In Codex CLI
/prompts:list

You should see Impeccable prompts listed.

# Clone the repository
git clone https://github.com/pbakaus/impeccable.git
cd impeccable

# Copy to home directory
cp -r dist/codex/.codex/* ~/.codex/

Usage

Codex CLI uses different syntax: /prompts:<name> instead of /<name>

Commands in Codex CLI:

/prompts:audit components/Layout.tsx
/prompts:polish dashboard
/prompts:animate transitions

The /prompts: prefix tells Codex to use your custom prompts from ~/.codex/prompts/.

Troubleshooting

Prompts not found

Verify files exist in ~/.codex/prompts/
Check frontmatter format (uses description and argument-hint, not args array)
Run /prompts:list to see available prompts

Wrong syntax error

Remember: Codex uses /prompts:audit, not /auditThe : is required to invoke custom prompts.

Universal Bundle

Want to support multiple tools? Use the universal bundle.

Download Universal Bundle

Visit impeccable.style and click Download Universal.

Extract to Project

unzip impeccable-universal.zip -d your-project/

This creates all provider directories:

your-project/
├── .cursor/
├── .claude/
├── .gemini/
├── .codex/
└── README.txt

Commit to Version Control

git add .cursor/ .claude/ .gemini/ .codex/
git commit -m "Add Impeccable skills for all providers"

Now your team can use whichever tool they prefer!

The universal bundle includes all providers in a single ZIP. Perfect for teams using multiple tools.

Prefixed Installation

If you have existing commands with conflicting names, use the prefixed bundle:

Download Prefixed Bundle

Visit impeccable.style and click Download (Prefixed).

Extract and Use

Commands are prefixed with i-:

/i-audit
/i-polish
/i-animate

Prefixed bundles work identically, just with i- prefix to avoid naming conflicts.

Verification

After installation, verify everything works:

Check Directory Structure

ls -la .cursor/skills/
# Should show: frontend-design, audit, polish, etc.

Test a Command

Create a simple test file and run /audit:

test.jsx

export function Button() {
  return <button style={{ color: '#999' }}>Click</button>;
}

Then run:

/audit test.jsx

You should get a detailed audit report with anti-pattern warnings.

Verify Skill Loading

Ask your AI:

What design principles does the frontend-design skill include?

If the skill is loaded, you’ll get a detailed response about typography, color, spatial design, etc.

Updating

To update to the latest version:

Download Latest Bundle

Visit impeccable.style and download the latest version.

Backup Existing Installation

# Backup current installation
mv .claude/ .claude.backup/
# Or for Cursor:
mv .cursor/ .cursor.backup/

Extract New Version

unzip ~/Downloads/impeccable-[provider].zip -d .

Verify and Clean Up

# Test new installation
# If working, remove backup:
rm -rf .claude.backup/

Next Steps

Quick Start

Try your first command in under 5 minutes

Command Reference

Complete guide to all 17 commands

Design Principles

Deep dive into the skill’s design guidelines

Best Practices

Tips and workflows for effective usage

Get Started

Core Concepts

Integration Guides

Usage

​Overview

​Choose Your Provider

Cursor

Claude Code

Gemini CLI

Codex CLI

​Cursor

​Requirements

​Installation

​Usage

​Troubleshooting

​Claude Code

​Requirements

​Installation

​Usage

​Troubleshooting

​Gemini CLI

​Requirements

​Installation

​Usage

​Troubleshooting

​Codex CLI

​Requirements

​Installation

​Usage

​Troubleshooting

​Universal Bundle

​Prefixed Installation

​Verification

​Updating

​Next Steps

Quick Start

Command Reference

Design Principles

Best Practices

Build docs developers (and LLMs) love

Overview

Choose Your Provider

Cursor

Requirements

Installation

Usage

Troubleshooting

Claude Code

Requirements

Installation

Usage

Troubleshooting

Gemini CLI

Requirements

Installation

Usage

Troubleshooting

Codex CLI

Requirements

Installation

Usage

Troubleshooting

Universal Bundle

Prefixed Installation

Verification

Updating

Next Steps