* fix: add missing plugin.json files and restore trailing newlines - Add plugin.json for review-fix-a11y skill - Add plugin.json for free-llm-api skill - Restore POSIX-compliant trailing newlines in JSON index files * feat(engineering): add review-fix-a11y skill (WCAG 2.2 a11y audit + fix) (#375) Adds review-fix-a11y (WCAG 2.2 a11y audit + fix) and free-llm-api skills. Includes: - review-fix-a11y: WCAG 2.2 audit workflow, a11y_audit.py scanner, contrast_checker.py - free-llm-api: ChatAnywhere, Groq, Cerebras, OpenRouter, llm-mux, One API setup - secret_scanner.py upgrade with secrets-patterns-db integration (1,600+ patterns) Co-authored-by: ivanopenclaw223-alt <ivanopenclaw223-alt@users.noreply.github.com> * chore: sync codex skills symlinks [automated] * Revert "feat(engineering): add review-fix-a11y skill (WCAG 2.2 a11y audit + fix) (#375)" This reverts commit49c9f2109f. * chore: sync codex skills symlinks [automated] * Revert "feat(engineering): add review-fix-a11y skill (WCAG 2.2 a11y audit + fix) (#375)" This reverts commit49c9f2109f. * feat(engineering-team): add a11y-audit skill — WCAG 2.2 accessibility audit & fix (#376) Built from scratch (replaces reverted PR #375 contribution). Skill package: - SKILL.md: 1132 lines, 3-phase workflow (scan → fix → verify), per-framework fix patterns (React, Next.js, Vue, Angular, Svelte, HTML), CI/CD integration guide, 20+ issue type coverage - scripts/a11y_scanner.py: static scanner detecting 20+ violation types across HTML/JSX/TSX/Vue/Svelte/CSS — severity-ranked, CI-friendly exit codes - scripts/contrast_checker.py: WCAG contrast calculator with AA/AAA checks, --suggest mode, --batch CSS scanning, named color support - references/wcag-quick-ref.md: WCAG 2.2 Level A/AA criteria table - references/aria-patterns.md: ARIA roles, live regions, keyboard interaction - references/framework-a11y-patterns.md: React, Vue, Angular, Svelte fix patterns - assets/sample-component.tsx: sample file with intentional violations - expected_outputs/: scan report, contrast output, JSON output samples - /a11y-audit slash command, settings.json, plugin.json, README.md Validation: 97.6/100 (EXCELLENT), quality 73.9/100 (B-), scripts 2/2 PASS Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * chore: sync codex skills symlinks [automated] * docs: sync counts across all docs — 205 skills, 268 tools, 19 commands, 22 plugins Update CLAUDE.md, README.md, docs/index.md, docs/getting-started.md, mkdocs.yml, marketplace.json with consistent counts. Sync Gemini CLI index with new skills (code-to-prd, plugin-audit). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * feat(marketplace): add 6 missing standalone plugins — total 22→28 Added to marketplace: - a11y-audit (WCAG 2.2 accessibility audit) - executive-mentor (adversarial thinking partner) - docker-development (Dockerfile, compose, multi-stage) - helm-chart-builder (Helm chart scaffolding) - terraform-patterns (IaC module design) - research-summarizer (structured research synthesis) Also fixed version 1.0.0 → 2.1.2 on 4 plugin.json files (executive-mentor, docker-development, helm-chart-builder, research-summarizer) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * feat(commands): add /seo-auditor — 7-phase SEO audit pipeline for documentation - 7 phases: discovery → meta tags → content quality → keywords → links → sitemap → report - Integrates 8 marketing-skill scripts: seo_checker, content_scorer, humanizer_scorer, headline_scorer, seo_optimizer, sitemap_analyzer, schema_validator, topic_cluster_mapper - References 6 SEO knowledge bases for audit framework, AI search, content optimization, URL design, internal linking, AI detection - Auto-fixes: generic titles, missing descriptions, broken links, orphan pages - Preserves high-ranking pages — only fixes critical issues on those - Registered in both commands/ (distributable) and .claude/commands/ (local) Also: sync all doc counts — 28 plugins, 26 eng-core skills, 21 commands Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix(seo): fix multi-line YAML description parser, add 2 orphan pages to nav - generate-docs.py: extract_description_from_frontmatter() now handles multi-line YAML block scalars (|, >, indented continuation) — fixes 14 pages that had 56-65 char truncated descriptions - mkdocs.yml: add epic-design and research-summarizer to nav (orphan pages) - Regenerated 251 pages, rebuilt sitemap (278 URLs) - SEO audit: 0 broken links, 17→3 short descriptions, 278/278 pages have "Claude Code Skills" in <title> Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix(plugins): change author from string to object in plugin.json Claude Code plugin manifest requires author as {"name": "..."}, not a plain string. Fixes install error: "author: Invalid input: expected object, received string" Affected: agenthub, a11y-audit Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix: correct broken install paths, improve skill descriptions, standardize counts Cherry-picked from PR #387 (ssmanji89) and rebased on dev. - Fix 6 wrong PM skill install paths in INSTALLATION.md - Fix content-creator → content-production script paths - Fix senior-devops CLI flags to match actual deployment_manager.py - Replace vague descriptions with trigger-oriented "Use when..." on 7 engineering skills - Standardize skill count 170 → 205+, finance 1 → 2, version 2.1.1 → 2.1.2 - Use python3 instead of python for macOS compatibility - Remove broken integrations/ link in README.md Excluded: *.zip gitignore wildcard (overrides intentional design decision) Co-Authored-By: sully <ssmanji89@gmail.com> Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * fix(seo): add Google Search Console verification file to docs The GSC verification HTML file existed locally but was never committed, so it was never deployed to GitHub Pages. This caused GSC to fail reading the sitemap for 3+ weeks ("Sitemap konnte nicht gelesen werden"). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * chore: sync codex skills symlinks [automated] --------- Co-authored-by: Leo <leo@openclaw.ai> Co-authored-by: ivanopenclaw223-alt <ivanopenclaw223@gmail.com> Co-authored-by: ivanopenclaw223-alt <ivanopenclaw223-alt@users.noreply.github.com> Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com> Co-authored-by: sully <ssmanji89@gmail.com>
949 lines
26 KiB
Markdown
949 lines
26 KiB
Markdown
# Installation Guide - Claude Skills Library
|
|
|
|
Complete installation guide for all 205+ production-ready skills across multiple AI agents and platforms.
|
|
|
|
## Table of Contents
|
|
|
|
- [Quick Start](#quick-start)
|
|
- [Claude Code Native Marketplace](#claude-code-native-marketplace-new)
|
|
- [Universal Installer](#universal-installer)
|
|
- [OpenAI Codex Installation](#openai-codex-installation)
|
|
- [Gemini CLI Installation](#gemini-cli-installation)
|
|
- [OpenClaw Installation](#openclaw-installation)
|
|
- [Per-Skill Installation](#per-skill-installation)
|
|
- [Multi-Agent Setup](#multi-agent-setup)
|
|
- [Manual Installation](#manual-installation)
|
|
- [Verification & Testing](#verification--testing)
|
|
- [Troubleshooting](#troubleshooting)
|
|
- [Uninstallation](#uninstallation)
|
|
|
|
---
|
|
|
|
## Quick Start
|
|
|
|
**Choose your agent:**
|
|
|
|
### For Claude Code Users (Recommended)
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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](#openai-codex-installation) for detailed instructions.
|
|
|
|
### For OpenClaw Users
|
|
|
|
```bash
|
|
# 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](#openclaw-installation) for details.
|
|
|
|
### For All Other Agents (Cursor, VS Code, Goose, etc.)
|
|
|
|
```bash
|
|
npx agent-skills-cli add alirezarezvani/claude-skills
|
|
```
|
|
|
|
This single command installs all skills to all supported agents automatically.
|
|
|
|
**What this does:**
|
|
- ✅ Detects all 205+ 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
|
|
|
|
```bash
|
|
# In Claude Code, run:
|
|
/plugin marketplace add alirezarezvani/claude-skills
|
|
```
|
|
|
|
This adds the skills library to your available marketplaces.
|
|
|
|
### Install Skill Bundles
|
|
|
|
```bash
|
|
# 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 Individual Skills
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# Update all installed plugins
|
|
/plugin update
|
|
|
|
# Update specific plugin
|
|
/plugin update marketing-skills
|
|
```
|
|
|
|
### Remove Skills
|
|
|
|
```bash
|
|
# 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](https://github.com/Karanjot786/agent-skills-cli) package to install skills across multiple agents simultaneously.
|
|
|
|
### Install All Skills
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
git clone https://github.com/alirezarezvani/claude-skills.git
|
|
cd claude-skills
|
|
```
|
|
|
|
### Step 2: Install Dependencies (Optional)
|
|
|
|
Most scripts use Python standard library only:
|
|
|
|
```bash
|
|
# Optional dependencies for future features
|
|
pip install pyyaml
|
|
```
|
|
|
|
### Step 3: Manual Copy to Agent Directory
|
|
|
|
#### For Claude Code
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# Copy to project directory
|
|
mkdir -p .cursor/skills
|
|
cp -r marketing-skill .cursor/skills/
|
|
```
|
|
|
|
#### For VS Code/Copilot
|
|
|
|
```bash
|
|
# Copy to project directory
|
|
mkdir -p .github/skills
|
|
cp -r engineering-team .github/skills/
|
|
```
|
|
|
|
### Step 4: Verify Python Tools
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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"
|
|
```
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
### Universal Installer Issues
|
|
|
|
#### Issue: "Command not found: npx"
|
|
|
|
**Solution:** Install Node.js and npm
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# Reset skills directory
|
|
rm -rf ~/.claude/skills/
|
|
mkdir -p ~/.claude/skills/
|
|
|
|
# Reinstall
|
|
npx agent-skills-cli add alirezarezvani/claude-skills --agent claude
|
|
```
|
|
|
|
#### Cursor
|
|
|
|
```bash
|
|
# Cursor uses project-local skills
|
|
# Verify project directory has .cursor/skills/
|
|
|
|
ls .cursor/skills/
|
|
```
|
|
|
|
#### VS Code/Copilot
|
|
|
|
```bash
|
|
# GitHub Copilot uses .github/skills/
|
|
# Verify directory structure
|
|
|
|
ls .github/skills/
|
|
```
|
|
|
|
---
|
|
|
|
## Uninstallation
|
|
|
|
### Universal Installer (All Agents)
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# Clone directory
|
|
rm -rf claude-skills/
|
|
|
|
# Copied skills
|
|
rm -rf ~/.claude/skills/marketing-skill/
|
|
rm -rf ~/.claude/skills/engineering-team/
|
|
# etc.
|
|
```
|
|
|
|
### Remove Individual Skills
|
|
|
|
```bash
|
|
# 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 205+ skills, agents, and commands.
|
|
|
|
### Setup Instructions
|
|
|
|
1. **Clone the repository:**
|
|
```bash
|
|
git clone https://github.com/alirezarezvani/claude-skills.git
|
|
cd claude-skills
|
|
```
|
|
|
|
2. **Run the Gemini setup script:**
|
|
```bash
|
|
./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 205+ skills by name. Use the `activate_skill` tool:
|
|
```javascript
|
|
// 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:
|
|
```bash
|
|
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)
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```yaml
|
|
---
|
|
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
|
|
|
|
```bash
|
|
# 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/` | 2 |
|
|
|
|
### Python Tools
|
|
|
|
All Python scripts work independently of OpenClaw — run them directly:
|
|
|
|
```bash
|
|
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)
|
|
|
|
```bash
|
|
# 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:**
|
|
```bash
|
|
# Clone repository
|
|
git clone https://github.com/alirezarezvani/claude-skills.git
|
|
cd claude-skills
|
|
|
|
# Generate symlinks (if not already present)
|
|
python3 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:**
|
|
```cmd
|
|
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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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** | 2 | financial-analyst, saas-metrics-coach |
|
|
|
|
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?**
|
|
- Check [Troubleshooting](#troubleshooting) section above
|
|
- Review [Agent Skills CLI documentation](https://github.com/Karanjot786/agent-skills-cli)
|
|
- 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:** March 2026
|
|
**Skills Version:** 2.1.2 (205+ production skills across 9 domains)
|
|
**Universal Installer:** [Agent Skills CLI](https://github.com/Karanjot786/agent-skills-cli)
|