Skip to content

README.md

Latest commit

 

History

History
238 lines (172 loc) · 8.53 KB

README.md

File metadata and controls

238 lines (172 loc) · 8.53 KB
Raw

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.