Agent Skills Collection

A curated collection of AI agent skills for efficient development workflows. Includes safety hooks to prevent destructive commands.

Features

• Skills: Reusable knowledge packs for AI coding assistants
• Safety Hooks: Blocks destructive git commands (git reset --hard, git push --force, etc.)
• Multi-platform: Works with Claude Code, GitHub Copilot, and Cursor

Installation

One-liner (recommended)

# For Claude Code (global) - includes safety hooks
curl -fsSL https://raw.githubusercontent.com/MrGKanev/agent-skills/master/install.sh | bash

# For GitHub Copilot
curl -fsSL https://raw.githubusercontent.com/MrGKanev/agent-skills/master/install.sh | bash -s -- --target=copilot

# For Cursor
curl -fsSL https://raw.githubusercontent.com/MrGKanev/agent-skills/master/install.sh | bash -s -- --target=cursor

# All targets at once
curl -fsSL https://raw.githubusercontent.com/MrGKanev/agent-skills/master/install.sh | bash -s -- --target=all

Install to current project

# Install skills to current project (not global)
curl -fsSL https://raw.githubusercontent.com/MrGKanev/agent-skills/master/install.sh | bash -s -- --project

# With specific target
curl -fsSL https://raw.githubusercontent.com/MrGKanev/agent-skills/master/install.sh | bash -s -- --project --target=copilot

Install specific version

# Install a specific release tag
curl -fsSL https://raw.githubusercontent.com/MrGKanev/agent-skills/master/install.sh | bash -s -- --tag=v1.0.0

Install from local repo

If you've cloned this repository and have custom skills in my-skills/, use --local to install directly from your local copy:

# Clone the repo
git clone https://github.com/MrGKanev/agent-skills.git
cd agent-skills

# Install from local (includes my-skills/)
./install.sh --local

# Preview what will be installed
./install.sh --local --list

This is useful when:

• You have custom skills in my-skills/ that aren't pushed to GitHub
• You want to test changes before committing
• You're developing new skills locally

Add shell alias (optional)

# Add 'claud' alias for 'claude --dangerously-skip-permissions'
curl -fsSL https://raw.githubusercontent.com/MrGKanev/agent-skills/master/install.sh | bash -s -- --alias

This adds alias claud="claude --dangerously-skip-permissions" to your shell config (.zshrc or .bashrc). After installation, restart your terminal or run source ~/.zshrc to use it. Only works with Claude Code target.

List available skills

curl -fsSL https://raw.githubusercontent.com/MrGKanev/agent-skills/master/install.sh | bash -s -- --list

What Gets Installed

Target	Skills	Safety
Claude Code	~/.claude/skills/	~/.claude/hooks/ (blocks commands)
GitHub Copilot	~/.github/skills/	copilot-instructions.md (text rules)
Cursor	~/.cursor/skills/	.cursor/rules/ (text rules)

Note: Only Claude Code has real protection via executable hooks. Copilot and Cursor receive text-based guidelines that the AI may not always follow.

Safety Hooks

The installer includes a safety hook that blocks destructive commands before they execute.

Blocked commands:

• git reset --hard - destroys uncommitted changes
• git checkout -- . - discards all changes
• git clean -f - removes untracked files
• git push --force - overwrites remote history
• git branch -D - force deletes branches
• rm -rf on project directories

Safe alternatives suggested:

• Use git stash before destructive operations
• Use git clean --dry-run to preview
• Use git push --force-with-lease instead of --force

Available Skills

WordPress Development (from Automattic)

Skill	Description
wordpress-router	Project classification and routing
wp-project-triage	Auto-detect project type and versions
wp-block-development	Gutenberg blocks, attributes, deprecations
wp-block-themes	Block themes, theme.json, patterns
wp-plugin-development	Plugin architecture, hooks, security
wp-interactivity-api	Frontend interactivity with data-wp-*
wp-abilities-api	Capabilities and REST authentication
wp-wpcli-and-ops	WP-CLI commands and automation
wp-performance	Profiling, caching, optimization
wp-phpstan	PHPStan static analysis
wp-playground	WordPress Playground environments
wp-rest-api	REST API routes, controllers, schemas
wpds	WordPress Design System UIs, components, tokens

Research & Academic Writing

Skill	Description
academic-writing	Academic manuscript preparation and formatting
grant-writing	Grant proposal writing assistance
hypothesis-dev	Research hypothesis development
lit-review	Systematic literature review methodology
manuscript-review	Peer review and manuscript feedback
paper-search	Academic paper discovery and search
reference-management	Citation and bibliography management

Development Workflow

Skill	Description
ask-questions-if-underspecified	Clarify requirements before implementing
avoid-feature-creep	Prevent scope creep, stay focused on MVP
optimise-github-actions	Measure and cut GitHub Actions cost and CI time (from enesgules)
i-have-adhd	ADHD-friendly output: action first, numbered steps, fewer tangents (from ayghri)

Marketing & CRO (from coreyhaines31)

Names follow upstream v2 (renamed from the old *-cro / *-strategy names).

Area	Skills
Strategy & research	marketing-plan, marketing-ideas, marketing-psychology, marketing-council, marketing-loops, product-marketing, customer-research, competitors, competitor-profiling, offers
CRO & experiments	cro, signup, onboarding, paywalls, popups, pricing, ab-testing, analytics, attribution
Content & copy	copywriting, copy-editing, content-strategy, social, emails, lead-magnets, image, video
SEO	seo-audit, programmatic-seo, schema, site-architecture, ai-seo, aso, directory-submissions
Paid, outbound & growth	ads, ad-creative, cold-email, sms, prospecting, sales-enablement, revops, launch, free-tools, referrals, churn-prevention, community-marketing, co-marketing, events, influencer-marketing, public-relations

SEO & AI Marketing

Skill	Description
aeo	Answer Engine Optimization - optimize content for AI assistant recommendations (ChatGPT, Perplexity, Claude, Gemini)

Local Development

If you clone this repo, you can use skills-manage.sh to manage skills and evals locally.

Quick Start

# Clone and install locally (includes your custom my-skills/)
git clone https://github.com/MrGKanev/agent-skills.git
cd agent-skills
./install.sh --local

Directory Structure

agent-skills/
├── skills/          # Upstream skills (from Automattic, etc.)
├── my-skills/       # Your custom skills (not synced upstream)
├── hooks/           # Safety hooks for Claude Code
├── install.sh       # Installer script
└── skills-manage.sh # Management script

Note: my-skills/ is for your personal/custom skills. These are installed with --local but won't be included when others install via curl from GitHub (unless you push them).

Skills Management

# List all skills
./skills-manage.sh list

# Create a new custom skill
./skills-manage.sh new my-custom-skill

# Show skill info
./skills-manage.sh info wp-block-development

# Sync from upstream
./skills-manage.sh sync

Evals (Test Scenarios)

Evals are JSON files that define test scenarios for skills.

# List all evals
./skills-manage.sh evals

# Create a new custom eval
./skills-manage.sh new-eval my-test-scenario

# Run eval validation
./skills-manage.sh run-evals

Sources & Attribution

All original authors retain their rights. See CREDITS.md for details.

Source	License	Skills
Automattic	MIT	WordPress development skills
coreyhaines31	MIT	Marketing & CRO skills
ayghri	MIT	ADHD-friendly output style

License

This repository is a collection. Each skill retains its original license. See CREDITS.md and individual LICENSE files for details.