Installation Guide - Claude Skills Library

Complete installation guide for every production-ready skill in this library (see the README for current counts) across multiple AI agents and platforms.

Table of Contents

• Quick Start
• Claude Code Native Marketplace
• Universal Installer
• OpenAI Codex Installation
• Gemini CLI Installation
• Mistral Vibe Installation
• OpenClaw Installation
• Per-Skill Installation
• Multi-Agent Setup
• Manual Installation
• Verification & Testing
• Windows Notes
• Troubleshooting
• Uninstallation

---

Quick Start

Choose your agent:

For Claude Code Users (Recommended)

# In Claude Code, run:
/plugin marketplace add alirezarezvani/claude-skills
/plugin install marketing-skills@claude-code-skills

Native integration with automatic updates and version management.

For OpenAI Codex Users

# Recommended: this repo's installer, one category at a time
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/codex-install.sh --category engineering   # no arguments lists the categories

Install by category rather than everything at once: Codex fits all skill descriptions into a fixed budget, and with a few hundred skills it drops the descriptions it needs to pick a skill. Skills install to ~/.codex/skills/. See OpenAI Codex Installation for details.

The third-party Agent Skills CLI (npx agent-skills-cli add alirezarezvani/claude-skills --agent codex) also works, but it is not maintained or tested by this repo.

For Gemini CLI Users

# Setup script for Gemini CLI
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/gemini-install.sh

Skills install to .gemini/skills/ and are activated via activate_skill(name="skill-name").

For Mistral Vibe Users

# Setup script for Mistral Vibe
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/vibe-install.sh

Skills install flat into ~/.vibe/skills/<skill-name>/ (symlinked), the only layout Vibe scans, and are discovered automatically via the standard SKILL.md + YAML frontmatter contract. See Mistral Vibe Installation for details.

For OpenClaw Users

# Install from ClawHub
clawhub install alirezarezvani/claude-skills

# Or manual installation
git clone https://github.com/alirezarezvani/claude-skills.git
cp -r claude-skills/engineering-team ~/.openclaw/skills/

Skills load via YAML frontmatter triggers. See OpenClaw Installation for details.

For All Other Agents (Cursor, VS Code, Goose, etc.)

# This repo's converter: builds per-tool skill folders under integrations/
./scripts/convert.sh --help

# Or the third-party Agent Skills CLI (not maintained or tested by this repo)
npx agent-skills-cli add alirezarezvani/claude-skills

What the Agent Skills CLI does:

• ✅ Detects every skill automatically
• ✅ Installs to Claude, Cursor, Copilot, Windsurf, Cline, and 37+ other AI agents
• ✅ Works across all skill formats

Learn more: https://www.agentskills.in

---

Claude Code Native Marketplace (New!)

Best for Claude Code users - Native integration with Claude Code's plugin system.

Add the Marketplace

# In Claude Code, run:
/plugin marketplace add alirezarezvani/claude-skills

This adds the skills library to your available marketplaces.

Install Skill Bundles

# Install by domain (bundles of skills)
/plugin install marketing-skills@claude-code-skills     # 42 marketing skills
/plugin install engineering-skills@claude-code-skills   # 23 engineering skills
/plugin install engineering-advanced-skills@claude-code-skills  # 25 advanced engineering skills
/plugin install product-skills@claude-code-skills       # 8 product skills
/plugin install c-level-skills@claude-code-skills       # 28 C-level advisory skills
/plugin install pm-skills@claude-code-skills            # 6 project management skills
/plugin install ra-qm-skills@claude-code-skills         # 12 regulatory/quality skills
/plugin install business-growth-skills@claude-code-skills  # 4 business & growth skills
/plugin install finance-skills@claude-code-skills       # 2 finance skills

Install Standalone Plugins

Only names listed in .claude-plugin/marketplace.json can be installed. Skills such as content-creator, senior-fullstack or scrum-master ship inside a domain bundle above; install that bundle to get them. Run /plugin and open the marketplace to browse every installable name.

# Engineering
/plugin install pw@claude-code-skills                 # Playwright testing toolkit
/plugin install karpathy-coder@claude-code-skills

# Marketing
/plugin install aeo@claude-code-skills
/plugin install linkedin@claude-code-skills

# Product
/plugin install agile-product-owner@claude-code-skills

# Productivity
/plugin install weekly-review@claude-code-skills

Update Skills

# Update all installed plugins
/plugin update

# Update specific plugin
/plugin update marketing-skills

Remove Skills

# Remove specific plugin
/plugin remove marketing-skills

# Remove marketplace
/plugin marketplace remove claude-code-skills

Benefits:

• ✅ Native Claude Code integration
• ✅ Automatic updates with /plugin update
• ✅ Version management with git tags
• ✅ Skills installed to ~/.claude/skills/
• ✅ Managed through Claude Code UI

Install what you use, not everything

Claude Code tells the model about your skills through one listing of names and descriptions, capped at about 1% of the context window (roughly 30,000 characters on a 200k-token model). When the listing is over the cap, Claude Code shortens descriptions, starting with the skills you use least, and a skill whose description is cut rarely loads on its own.

All 107 plugins in this marketplace together add about 97,000 characters, more than three times the cap. So:

• Install the domain bundles you work in (for example engineering-skills and marketing-skills), not every plugin.
• Check where you stand with claude --debug: Claude Code logs Skill listing over budget when it has to shorten descriptions.
• If you want more skills listed in full and accept the extra context per turn, raise skillListingBudgetFraction in settings.json (default 0.01, maximum 1).
• Claude Code's built-in /skill-doctor shows which loaded skills go unused and what they cost in context.

---

Universal Installer

The universal installer uses the Agent Skills CLI package to install skills across multiple agents simultaneously.

Install All Skills

# Install to all supported agents
npx agent-skills-cli add alirezarezvani/claude-skills

This installs to:

• Claude Code → ~/.claude/skills/
• Cursor → .cursor/skills/
• VS Code/Copilot → .github/skills/
• Goose → ~/.config/goose/skills/
• Amp → Platform-specific location
• Codex → Platform-specific location
• Letta → Platform-specific location
• OpenCode → Platform-specific location

Install to Specific Agent

# Claude Code only
npx agent-skills-cli add alirezarezvani/claude-skills --agent claude

# Cursor only
npx agent-skills-cli add alirezarezvani/claude-skills --agent cursor

# VS Code/Copilot only
npx agent-skills-cli add alirezarezvani/claude-skills --agent vscode

# Goose only
npx agent-skills-cli add alirezarezvani/claude-skills --agent goose

# Project-specific installation (portable)
npx agent-skills-cli add alirezarezvani/claude-skills --agent project

Preview Before Installing

# Dry run to see what will be installed
npx agent-skills-cli add alirezarezvani/claude-skills --dry-run

---

Per-Skill Installation

Install individual skills instead of the entire library:

Marketing Skills

# Content Creator
npx agent-skills-cli add alirezarezvani/claude-skills/marketing-skill/content-creator

# Demand Generation & Acquisition
npx agent-skills-cli add alirezarezvani/claude-skills/marketing-skill/marketing-demand-acquisition

# Product Marketing Strategy
npx agent-skills-cli add alirezarezvani/claude-skills/marketing-skill/marketing-strategy-pmm

# App Store Optimization
npx agent-skills-cli add alirezarezvani/claude-skills/marketing-skill/app-store-optimization

# Social Media Analyzer
npx agent-skills-cli add alirezarezvani/claude-skills/marketing-skill/social-media-analyzer

C-Level Advisory Skills

# CEO Advisor
npx agent-skills-cli add alirezarezvani/claude-skills/c-level-advisor/ceo-advisor

# CTO Advisor
npx agent-skills-cli add alirezarezvani/claude-skills/c-level-advisor/cto-advisor

Product Team Skills

# Product Manager Toolkit
npx agent-skills-cli add alirezarezvani/claude-skills/product-team/product-manager-toolkit

# Agile Product Owner
npx agent-skills-cli add alirezarezvani/claude-skills/product-team/agile-product-owner

# Product Strategist
npx agent-skills-cli add alirezarezvani/claude-skills/product-team/product-strategist

# UX Researcher Designer
npx agent-skills-cli add alirezarezvani/claude-skills/product-team/ux-researcher-designer

# UI Design System
npx agent-skills-cli add alirezarezvani/claude-skills/product-team/ui-design-system

Project Management Skills

# Senior PM Expert
npx agent-skills-cli add alirezarezvani/claude-skills/project-management/senior-pm

# Scrum Master Expert
npx agent-skills-cli add alirezarezvani/claude-skills/project-management/scrum-master

# Atlassian Jira Expert
npx agent-skills-cli add alirezarezvani/claude-skills/project-management/jira-expert

# Atlassian Confluence Expert
npx agent-skills-cli add alirezarezvani/claude-skills/project-management/confluence-expert

# Atlassian Administrator
npx agent-skills-cli add alirezarezvani/claude-skills/project-management/atlassian-admin

# Atlassian Template Creator
npx agent-skills-cli add alirezarezvani/claude-skills/project-management/atlassian-templates

Engineering Team Skills

# Core Engineering
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/senior-architect
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/senior-frontend
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/senior-backend
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/senior-fullstack
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/senior-qa
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/senior-devops
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/senior-secops
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/code-reviewer
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/senior-security

# Cloud & Enterprise
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/aws-solution-architect
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/ms365-tenant-manager

# Development Tools
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/tdd-guide
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/tech-stack-evaluator

# AI/ML/Data
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/senior-data-scientist
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/senior-data-engineer
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/senior-ml-engineer
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/senior-prompt-engineer
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/senior-computer-vision

Regulatory Affairs & Quality Management Skills

# Regulatory & Quality Leadership
npx agent-skills-cli add alirezarezvani/claude-skills/ra-qm-team/regulatory-affairs-head
npx agent-skills-cli add alirezarezvani/claude-skills/ra-qm-team/quality-manager-qmr
npx agent-skills-cli add alirezarezvani/claude-skills/ra-qm-team/quality-manager-qms-iso13485

# Quality Processes
npx agent-skills-cli add alirezarezvani/claude-skills/ra-qm-team/capa-officer
npx agent-skills-cli add alirezarezvani/claude-skills/ra-qm-team/quality-documentation-manager
npx agent-skills-cli add alirezarezvani/claude-skills/ra-qm-team/risk-management-specialist

# Security & Privacy
npx agent-skills-cli add alirezarezvani/claude-skills/ra-qm-team/information-security-manager-iso27001
npx agent-skills-cli add alirezarezvani/claude-skills/ra-qm-team/gdpr-dsgvo-expert

# Regional Compliance
npx agent-skills-cli add alirezarezvani/claude-skills/ra-qm-team/mdr-745-specialist
npx agent-skills-cli add alirezarezvani/claude-skills/ra-qm-team/fda-consultant-specialist

# Audit & Assessment
npx agent-skills-cli add alirezarezvani/claude-skills/ra-qm-team/qms-audit-expert
npx agent-skills-cli add alirezarezvani/claude-skills/ra-qm-team/isms-audit-expert

---

Multi-Agent Setup

Install the same skills across different agents for team consistency:

Example: Marketing Team Setup

# Install marketing skills to Claude Code (for content strategist)
npx agent-skills-cli add alirezarezvani/claude-skills/marketing-skill/content-creator --agent claude

# Install same skills to Cursor (for developer working on content)
npx agent-skills-cli add alirezarezvani/claude-skills/marketing-skill/content-creator --agent cursor

# Install to VS Code (for SEO specialist)
npx agent-skills-cli add alirezarezvani/claude-skills/marketing-skill/content-creator --agent vscode

Example: Engineering Team Setup

# Full engineering suite to Claude Code
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team --agent claude

# Same suite to Cursor
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team --agent cursor

---

Manual Installation

For development, customization, or offline use:

Prerequisites

• Python 3.7+ (for running analysis scripts)
• Git (for cloning repository)
• Claude AI account or Claude Code (for using skills)

Step 1: Clone Repository

git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills

Step 2: Install Dependencies (Optional)

Most scripts use Python standard library only:

# Optional dependencies for future features
pip install pyyaml

Step 3: Manual Copy to Agent Directory

For Claude Code

# Copy all skills
cp -r marketing-skill ~/.claude/skills/
cp -r c-level-advisor ~/.claude/skills/
cp -r product-team ~/.claude/skills/
cp -r project-management ~/.claude/skills/
cp -r engineering-team ~/.claude/skills/
cp -r ra-qm-team ~/.claude/skills/

# Or copy single skill
cp -r marketing-skill/content-creator ~/.claude/skills/content-creator

For Cursor

# Copy to project directory
mkdir -p .cursor/skills
cp -r marketing-skill .cursor/skills/

For VS Code/Copilot

# Copy to project directory
mkdir -p .github/skills
cp -r engineering-team .github/skills/

Step 4: Verify Python Tools

# Test marketing tools
python3 marketing-skill/content-production/scripts/brand_voice_analyzer.py --help
python3 marketing-skill/content-production/scripts/seo_optimizer.py --help

# Test C-level tools
python3 c-level-advisor/cto-advisor/scripts/tech_debt_analyzer.py --help
python3 c-level-advisor/ceo-advisor/scripts/strategy_analyzer.py --help

# Test product tools
python3 product-team/product-manager-toolkit/scripts/rice_prioritizer.py --help
python3 product-team/ui-design-system/scripts/design_token_generator.py --help

---

Verification & Testing

Verify Universal Installer Installation

# Check Claude Code installation
ls ~/.claude/skills/

# Check Cursor installation
ls .cursor/skills/

# Check VS Code installation
ls .github/skills/

# Check Goose installation
ls ~/.config/goose/skills/

Test Skill Usage

In Claude Code

1. Open Claude Code
2. Start a new conversation
3. Test a skill:

   Using the content-creator skill, analyze this text for brand voice:
   "Our platform revolutionizes data analytics..."
   

In Cursor

1. Open Cursor
2. Use Cmd+K or Ctrl+K
3. Reference skill:

   @content-creator analyze brand voice for this file
   

Test Python Tools Locally

# Create test file
echo "Sample content for analysis" > test-article.txt

# Run brand voice analysis
python3 ~/.claude/skills/content-production/scripts/brand_voice_analyzer.py test-article.txt

# Run SEO optimization
python3 ~/.claude/skills/content-production/scripts/seo_optimizer.py test-article.txt "sample keyword"

---

Windows Notes

Two Windows-specific caveats to know before cloning or running skills (issues #968 and #969):

Symlinks: mirror trees need core.symlinks=true

The cross-platform mirror trees (.gemini/, .codex/, .vibe/, .hermes/) are built from relative symlinks into the real skill directories. Git for Windows defaults to core.symlinks=false, so a default clone checks those 1,300+ links out as 1-line text files containing only the target path — copying a skill folder from a mirror tree then silently gives you dead pointer files instead of skills.

Before cloning on Windows:

1. Enable Developer Mode (Settings → System → For developers), or run Git from an elevated prompt.

2. Clone with symlinks enabled:

   git clone -c core.symlinks=true https://github.com/alirezarezvani/claude-skills.git
   

If you already cloned without it, either re-clone as above, or copy skills from the real domain directories (e.g. engineering-team/, marketing-skill/) instead of the mirror trees — the Claude Code plugin/marketplace path always uses the real directories and is unaffected. Quick sanity check after any copy: a real SKILL.md is more than one line long.

Console encoding: run Python tools with UTF-8

Windows consoles often default to a legacy codepage (e.g. cp1252) that cannot encode the box-drawing and comparison characters (╔, ≥, ✅) some skill tools print, which crashes the script at print time with UnicodeEncodeError. The most-affected tools now re-encode their own output, but as a blanket fix for every script in this library, enable Python's UTF-8 mode:

# Per session
$env:PYTHONUTF8 = "1"

# Or permanently
setx PYTHONUTF8 1

---

Troubleshooting

Universal Installer Issues

Issue: "Command not found: npx"

Solution: Install Node.js and npm

# macOS
brew install node

# Ubuntu/Debian
sudo apt-get install nodejs npm

# Windows
# Download from https://nodejs.org/

Issue: "Skill not found" when installing a domain bundle

Solution: Use agent-skills-cli (not ai-agent-skills) and specify the correct path:

# Install entire domain bundle
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team

# Or install individual skills
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/senior-frontend

Note: The older ai-agent-skills package may not support bundle installation. Use agent-skills-cli instead.

Issue: "Failed to install skills"

Solution: Check network connection and permissions

# Check network
curl https://github.com/alirezarezvani/claude-skills

# Check write permissions
ls -la ~/.claude/

Issue: "Skills