claude-skills-reference/INSTALLATION.md

Installation Guide - Claude Skills Library

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

Table of Contents

• Quick Start
• Claude Code Native Marketplace
• Universal Installer
• OpenAI Codex Installation
• Per-Skill Installation
• Multi-Agent Setup
• Manual Installation
• Verification & Testing
• 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

# 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

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

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 53 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     # 6 marketing skills
/plugin install engineering-skills@claude-code-skills   # 18 engineering skills
/plugin install product-skills@claude-code-skills       # 5 product skills
/plugin install c-level-skills@claude-code-skills       # 2 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

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: "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/

---

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 43 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
# Should show: 53

Available Categories

Category	Skills	Examples
c-level	2	ceo-advisor, cto-advisor
engineering	18	senior-fullstack, aws-solution-architect, senior-ml-engineer
marketing	6	content-creator, marketing-demand-acquisition, social-media-analyzer
product	5	product-manager-toolkit, agile-product-owner, ui-design-system
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	3	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
Project	.skills/	--agent project	Portable, project-specific

---

Support

Installation Issues?

• Check Troubleshooting section above
• Review Agent Skills CLI documentation
• Open issue: https://github.com/alirezarezvani/claude-skills/issues

Feature Requests:

• Submit via GitHub Issues with enhancement label

General Questions:

• Visit: https://alirezarezvani.com
• Blog: https://medium.com/@alirezarezvani

---

Last Updated: February 2026 Skills Version: 1.0 (53 production skills) Universal Installer: Agent Skills CLI