Skip to content

Latest commit

 

History

History
948 lines (674 loc) · 26 KB

File metadata and controls

948 lines (674 loc) · 26 KB

Installation Guide - Claude Skills Library

Complete installation guide for all 170 production-ready skills across multiple AI agents and platforms.

Table of Contents


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

# Option 1: Universal installer
npx agent-skills-cli add alirezarezvani/claude-skills --agent codex

# Option 2: Direct installation script
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/codex-install.sh

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").

Skills install to ~/.codex/skills/. See OpenAI Codex Installation for detailed instructions.

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.)

npx agent-skills-cli add alirezarezvani/claude-skills

This single command installs all skills to all supported agents automatically.

What this does:

  • ✅ Detects all 170 skills 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       # 1 finance skill

Install Individual Skills

# Marketing
/plugin install content-creator@claude-code-skills
/plugin install demand-gen@claude-code-skills

# Engineering
/plugin install fullstack-engineer@claude-code-skills
/plugin install aws-architect@claude-code-skills

# Product
/plugin install product-manager@claude-code-skills

# Project Management
/plugin install scrum-master@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

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-expert

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

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

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

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

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

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
python marketing-skill/content-creator/scripts/brand_voice_analyzer.py --help
python marketing-skill/content-creator/scripts/seo_optimizer.py --help

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

# Test product tools
python product-team/product-manager-toolkit/scripts/rice_prioritizer.py --help
python 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
python ~/.claude/skills/content-creator/scripts/brand_voice_analyzer.py test-article.txt

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

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 not showing in agent"

Solution: Restart agent and verify installation location

# Verify installation
ls -R ~/.claude/skills/

# Restart Claude Code
# Close and reopen application

Manual Installation Issues

Issue: Python scripts not executable

Solution: Add execute permissions

chmod +x marketing-skill/content-creator/scripts/*.py
chmod +x c-level-advisor/*/scripts/*.py
chmod +x product-team/*/scripts/*.py

Issue: "Module not found" errors

Solution: Install required dependencies

# Install Python dependencies
pip install pyyaml

# Or use Python 3 specifically
pip3 install pyyaml

Issue: Skills not recognized by agent

Solution: Verify SKILL.md format and location

# Check SKILL.md exists
ls ~/.claude/skills/content-creator/SKILL.md

# Verify YAML frontmatter
head -20 ~/.claude/skills/content-creator/SKILL.md

Agent-Specific Issues

Claude Code

# Reset skills directory
rm -rf ~/.claude/skills/
mkdir -p ~/.claude/skills/

# Reinstall
npx agent-skills-cli add alirezarezvani/claude-skills --agent claude

Cursor

# Cursor uses project-local skills
# Verify project directory has .cursor/skills/

ls .cursor/skills/

VS Code/Copilot

# GitHub Copilot uses .github/skills/
# Verify directory structure

ls .github/skills/

Uninstallation

Universal Installer (All Agents)

# Remove from Claude Code
rm -rf ~/.claude/skills/alirezarezvani/claude-skills/

# Remove from Cursor
rm -rf .cursor/skills/alirezarezvani/claude-skills/

# Remove from VS Code
rm -rf .github/skills/alirezarezvani/claude-skills/

# Remove from Goose
rm -rf ~/.config/goose/skills/alirezarezvani/claude-skills/

Manual Installation

# Clone directory
rm -rf claude-skills/

# Copied skills
rm -rf ~/.claude/skills/marketing-skill/
rm -rf ~/.claude/skills/engineering-team/
# etc.

Remove Individual Skills

# Example: Remove content-creator from Claude Code
rm -rf ~/.claude/skills/content-creator/

# Example: Remove fullstack-engineer from Cursor
rm -rf .cursor/skills/fullstack-engineer/

Gemini CLI Installation

Gemini CLI users can install skills using the setup script below. This repository provides Gemini CLI compatibility through a .gemini/skills/ directory with symlinks to all 170+ skills, agents, and commands.

Setup Instructions

  1. Clone the repository:

    git clone https://github.com/alirezarezvani/claude-skills.git
    cd claude-skills
  2. Run the Gemini setup script:

    ./scripts/gemini-install.sh

    This script performs the following:

    • Scans all 9 domain folders for SKILL.md files.
    • Scans the agents/ folder for multi-agent persona definitions.
    • Scans the commands/ folder for predefined slash command workflows.
    • Creates a .gemini/skills/ directory with standardized subfolders for each.
    • Generates a skills-index.json manifest for discovery.
  3. Activate Skills in Gemini CLI: Gemini CLI can now activate any of these 170+ skills by name. Use the activate_skill tool:

    // Activate a core skill
    activate_skill(name="senior-architect")
    
    // Activate a marketing specialist
    activate_skill(name="content-creator")
    
    // Activate a C-level advisor
    activate_skill(name="cto-advisor")
    
    // Activate a multi-agent persona
    activate_skill(name="cs-engineering-lead")
    
    // Activate a slash command workflow
    activate_skill(name="tdd")

Python CLI Tools

Every skill includes deterministic Python CLI tools in its scripts/ folder. These use the standard library only and can be run directly from your terminal or by the Gemini CLI.

Example:

python3 marketing-skill/content-production/scripts/brand_voice_analyzer.py article.txt

OpenClaw Installation

OpenClaw loads skills via YAML frontmatter in SKILL.md files. Every skill in this repository includes OpenClaw-compatible frontmatter with name, description, and tags fields.

Method 1: ClawHub (Recommended)

# Install from ClawHub registry
clawhub install alirezarezvani/claude-skills

# Install specific skill
clawhub install alirezarezvani/claude-skills/engineering-team/senior-frontend

Method 2: Manual Installation

# Clone the repository
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills

# Copy a skill to your OpenClaw skills directory
cp -r engineering-team/senior-frontend ~/.openclaw/skills/senior-frontend

# Or copy an entire domain
cp -r engineering-team ~/.openclaw/skills/engineering-team

How Skills Load in OpenClaw

OpenClaw reads the YAML frontmatter from each SKILL.md to determine when to activate a skill:

---
name: "senior-frontend"
description: "Frontend development skill for React, Next.js, TypeScript..."
tags:
  - frontend
  - react
  - nextjs
---

The description field triggers skill activation — when your prompt matches the described use case, OpenClaw loads the skill automatically.

Verify Installation

# List installed skills
ls ~/.openclaw/skills/

# Verify a skill's frontmatter
head -20 ~/.openclaw/skills/senior-frontend/SKILL.md

Available Domains

Domain Folder Skills
Engineering (Core) engineering-team/ 23
Engineering (Advanced) engineering/ 25
Marketing marketing-skill/ 42
C-Level Advisory c-level-advisor/ 28
Product Team product-team/ 8
Project Management project-management/ 6
RA/QM Compliance ra-qm-team/ 12
Business & Growth business-growth/ 4
Finance finance/ 1

Python Tools

All Python scripts work independently of OpenClaw — run them directly:

python3 engineering-team/senior-security/scripts/threat_modeler.py --help
python3 finance/financial-analyst/scripts/dcf_valuation.py --help

OpenAI Codex Installation

OpenAI Codex users can install skills using the methods below. This repository provides full Codex compatibility through a .codex/skills/ directory with symlinks to all skills.

Method 1: Universal Installer (Recommended)

# Install all skills to Codex
npx agent-skills-cli add alirezarezvani/claude-skills --agent codex

# Preview before installing
npx agent-skills-cli add alirezarezvani/claude-skills --agent codex --dry-run

Method 2: Direct Installation Script

For manual installation using the provided scripts:

macOS/Linux:

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

# Generate symlinks (if not already present)
python scripts/sync-codex-skills.py

# Install all skills to ~/.codex/skills/
./scripts/codex-install.sh

# Or install specific category
./scripts/codex-install.sh --category marketing
./scripts/codex-install.sh --category engineering

# Or install single skill
./scripts/codex-install.sh --skill content-creator

# List available skills
./scripts/codex-install.sh --list

Windows:

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

REM Generate structure (if not already present)
python scripts\sync-codex-skills.py

REM Install all skills to %USERPROFILE%\.codex\skills\
scripts\codex-install.bat

REM Or install single skill
scripts\codex-install.bat --skill content-creator

REM List available skills
scripts\codex-install.bat --list

Method 3: Manual Installation

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

# Copy skills (following symlinks) to Codex directory
mkdir -p ~/.codex/skills
cp -rL .codex/skills/* ~/.codex/skills/

Verification

# Check installed skills
ls ~/.codex/skills/

# Verify skill structure
ls ~/.codex/skills/content-creator/
# Should show: SKILL.md, scripts/, references/, assets/

# Check total skill count
ls ~/.codex/skills/ | wc -l

Available Categories

Category Skills Examples
c-level 28 ceo-advisor, cto-advisor, cfo-advisor, executive-mentor
engineering 23 senior-fullstack, aws-solution-architect, senior-ml-engineer, playwright-pro
engineering-advanced 25 agent-designer, rag-architect, mcp-server-builder, performance-profiler
marketing 42 content-creator, seo-audit, campaign-analytics, content-strategy
product 8 product-manager-toolkit, agile-product-owner, saas-scaffolder
project-management 6 scrum-master, senior-pm, jira-expert, confluence-expert
ra-qm 12 regulatory-affairs-head, quality-manager-qms-iso13485, gdpr-dsgvo-expert
business-growth 4 customer-success-manager, sales-engineer, revenue-operations
finance 1 financial-analyst

See .codex/skills-index.json for the complete manifest with descriptions.


Advanced: Installation Locations Reference

Agent Default Location Flag Notes
Claude Code ~/.claude/skills/ --agent claude User-level installation
Cursor .cursor/skills/ --agent cursor Project-level installation
VS Code/Copilot .github/skills/ --agent vscode Project-level installation
Goose ~/.config/goose/skills/ --agent goose User-level installation
Amp Platform-specific --agent amp Varies by platform
Codex ~/.codex/skills/ --agent codex User-level installation
Letta Platform-specific --agent letta Varies by platform
OpenCode Platform-specific --agent opencode Varies by platform
OpenClaw ~/.openclaw/skills/ clawhub install YAML frontmatter triggers
Gemini CLI .gemini/skills/ gemini-install.sh Symlink-based discovery
Project .skills/ --agent project Portable, project-specific

Support

Installation Issues?

Feature Requests:

  • Submit via GitHub Issues with enhancement label

General Questions:


Last Updated: March 2026 Skills Version: 2.1.1 (170 production skills across 9 domains) Universal Installer: Agent Skills CLI