Agent Skills

A collection of skills for AI coding agents. Works with Claude Code, Cursor, Codex, and 70+ agents.

Skills follow the Agent Skills specification. Discover more at skills.sh.

Installation

Using npx (recommended)

# Install all skills
npx skills add AsyrafHussin/agent-skills

# Install a specific skill
npx skills add AsyrafHussin/agent-skills --skill laravel-best-practices

# Install multiple skills
npx skills add AsyrafHussin/agent-skills --skill laravel-best-practices --skill seo-best-practices

# Install globally (available across all projects)
npx skills add AsyrafHussin/agent-skills -g

# Install to a specific agent
npx skills add AsyrafHussin/agent-skills -a claude-code

# List available skills without installing
npx skills add AsyrafHussin/agent-skills --list

Scope	Flag	Location	Use Case
Project	(default)	.claude/skills/	Shared with team via git
Global	-g	~/.claude/skills/	Available across all projects

Manual installation

git clone https://github.com/AsyrafHussin/agent-skills.git

# Copy all skills
cp -r agent-skills/skills/* .claude/skills/

# Or copy a single skill
cp -r agent-skills/skills/laravel-best-practices .claude/skills/

Each skill contains SKILL.md, AGENTS.md, rules/, and metadata.json.

Managing skills

npx skills list              # List installed skills
npx skills find laravel      # Search for skills
npx skills remove            # Remove installed skills
npx skills update            # Update all skills to latest

Available Skills

laravel-best-practices

Laravel 13 conventions and architecture. Contains 31 rules across 7 categories.

Example: Review this Laravel controller for best practices

npx skills add AsyrafHussin/agent-skills --skill laravel-best-practices

---

technical-debt

Technical debt audit and prioritization for PHP/Laravel (MySQL) and Node/TypeScript/React. Contains 42 rules across 10 categories. Produces a ranked debt ledger (effort × impact, P0–P3) and supports audit mode with PASS/FAIL/N/A output.

Example: Audit technical debt in this project or What should we refactor first?

npx skills add AsyrafHussin/agent-skills --skill technical-debt

---

code-slop

Code-quality enforcement for PHP/Laravel and TypeScript/React — catches the sloppy patterns that pass every metric but degrade the codebase: narration comments, generic names, premature interfaces, defensive overdose, mock-everything tests. Most devs use AI now, so these patterns are common; this skill is how you keep code clean regardless of who (or what) wrote it. 24 rules across 6 categories. Verdicts: CLEAN / SUSPICIOUS / INFLATED / CRITICAL.

code-slop vs technical-debt — which to pick?

Use code-slop when…	Use technical-debt when…
Reviewing a PR — keeping the bar for clean code	Auditing the codebase for ranked debt to pay down
Concern is taste: comments, naming, over-engineering, defensive overdose, test quality	Concern is metrics: complexity, duplication, CVEs, missing indexes, N+1 queries
Question: "Is this clean code or sloppy patterns to reject?"	Question: "What should we refactor first?"
Output: classified diff verdicts (CLEAN / SUSPICIOUS / INFLATED / CRITICAL)	Output: ranked debt ledger (P0–P3)

Run both for a full audit — taste check (code-slop) catches what metrics miss; metric audit (technical-debt) catches what taste-review misses.

Example: Review this PR for code quality or Find sloppy patterns in app/Services/

npx skills add AsyrafHussin/agent-skills --skill code-slop

---

project-docs

Documentation lifecycle for PHP/Laravel and Node/TypeScript/React. Contains 25 rules across 6 categories (structure, naming, essential files, quality, cleanup, lifecycle). Supports bootstrap, audit, and reference modes — including AI-slop detection in both file names (PLAN.md, IMPLEMENTATION-SUMMARY.md) and content (filler phrases, generic praise, closing sign-offs).

Example: Set up docs for this project or Audit the markdown files in this repo

npx skills add AsyrafHussin/agent-skills --skill project-docs

---

laravel-inertia-react

Laravel 13 + Inertia.js + React 18 full-stack patterns. Covers page components, form handling, layouts, file uploads, and real-time features.

Example: How do I share data from Laravel to a React component with Inertia?

npx skills add AsyrafHussin/agent-skills --skill laravel-inertia-react

---

laravel-testing

Laravel 13 testing with Pest PHP 4 and PHPUnit 12. Contains 24 rules across 6 categories covering HTTP feature tests, model factories, database assertions, facade faking (Mail, Queue, Notification, Event, Storage, AI SDK), authentication testing, and test organisation patterns. Detects Pest or PHPUnit automatically from composer.json.

Example: Write feature tests for this Laravel controller

npx skills add AsyrafHussin/agent-skills --skill laravel-testing

---

laravel-owasp-security

OWASP Top 10 security audit and secure coding guidelines for Laravel + React/Inertia.js.

Example: Run OWASP security audit on my Laravel app

npx skills add AsyrafHussin/agent-skills --skill laravel-owasp-security

---

php-best-practices

Modern PHP 8.0–8.5 patterns, type system, PSR standards, and SOLID principles. Contains 51 rules for secure, maintainable code.

Example: Review my PHP class for SOLID principles

npx skills add AsyrafHussin/agent-skills --skill php-best-practices

---

react-vite-best-practices

React + Vite performance optimization. Contains 23 rules across 6 categories covering build config (OXC minification, tree shaking), code splitting (React.lazy, Suspense), asset handling, environment config, and bundle analysis.

Example: Review this React component for performance issues

npx skills add AsyrafHussin/agent-skills --skill react-vite-best-practices

---

typescript-react-patterns

Type-safe React with TypeScript. Contains 33 rules across 7 categories covering component typing, hooks, event handling, refs, generics, context, and utility types.

Example: How do I properly type this React component with TypeScript?

npx skills add AsyrafHussin/agent-skills --skill typescript-react-patterns

---

state-management

Server state with TanStack Query v5 and client state with Zustand v5. Covers caching, mutations, optimistic updates, and devtools.

Example: How do I manage server state with React Query?

npx skills add AsyrafHussin/agent-skills --skill state-management

---

tailwind-best-practices

Tailwind CSS v3.4+ and v4 best practices. Contains 29 rules across 8 categories covering responsive design, dark mode, component patterns, configuration, and v3-to-v4 migration.

Example: Review my Tailwind classes for best practices

npx skills add AsyrafHussin/agent-skills --skill tailwind-best-practices

---

web-design-guidelines

WCAG accessibility, semantic HTML, keyboard navigation, forms, and performance. Contains 23 rules across 4 categories. Supports accessibility audit mode with PASS/FAIL checklist output.

Example: Run accessibility audit on this project or Review this component for accessibility

npx skills add AsyrafHussin/agent-skills --skill web-design-guidelines

---

clean-code-principles

Language-agnostic SOLID, DRY, KISS principles and design patterns (Factory, Strategy, Repository). Contains 23 rules for maintainable software.

Example: Review this class for code smells and SOLID violations

npx skills add AsyrafHussin/agent-skills --skill clean-code-principles

---

api-design-patterns

RESTful API design patterns. Contains 38 rules across 7 categories covering resource design, error handling, security, pagination, versioning, response format, and OpenAPI documentation.

Example: Review my API endpoints for REST best practices

npx skills add AsyrafHussin/agent-skills --skill api-design-patterns

---

git-workflow

Git workflow conventions for commits, branching, pull requests, and history management. Contains 31 rules covering conventional commits, git hooks, workflow strategies (GitHub Flow, GitFlow, Trunk-Based), monorepo workflows, git worktree, and .gitignore best practices.

Example: Review my git workflow and suggest improvements

npx skills add AsyrafHussin/agent-skills --skill git-workflow

---

prd-writing

Step-by-step workflow for writing Product Requirements Documents. 6-step process: assess project state, ask clarifying questions (with lettered options), draft using 12-section template, review, revise, and save. Contains 25 rules across 7 categories as supporting knowledge.

Example: Write a PRD for this feature

npx skills add AsyrafHussin/agent-skills --skill prd-writing

---

testing-best-practices

Unit, integration, and E2E testing with TypeScript/Vitest. Contains 34 rules across 7 categories covering test structure (AAA), isolation, assertions, test data factories, mocking, coverage strategy, and test performance.

Example: Write tests for this Laravel service class

npx skills add AsyrafHussin/agent-skills --skill testing-best-practices

---

e2e-playwright-testing

End-to-end browser testing with Playwright. Contains 8 rules across 6 categories covering locator strategies, authentication reuse (storageState), React form gotchas (date inputs, sr-only checkboxes), web-first assertions, test organization, and reliability. Includes stack detection for React/Inertia/Vue projects.

Example: Write E2E tests for this login flow or Set up Playwright for this project

npx skills add AsyrafHussin/agent-skills --skill e2e-playwright-testing

---

seo-best-practices

SEO patterns for Laravel Blade and Laravel + Inertia.js + React. Contains 31 rules across 8 categories covering Core Web Vitals, meta tags, structured data (JSON-LD), Open Graph, performance, and mobile-first indexing. Supports SEO audit mode with PASS/FAIL checklist output. Auto-detects project type.

Example: Run SEO audit on this project or Set up Open Graph meta tags

npx skills add AsyrafHussin/agent-skills --skill seo-best-practices

---

laravel-database-optimization

Laravel 13 database optimization. Contains 33 rules across 9 categories covering N+1 prevention, indexing strategies, Eloquent performance, Redis caching, cursor pagination, transactions, zero-downtime migrations, naming conventions, and query debugging.

Example: Optimize the database queries in this controller

npx skills add AsyrafHussin/agent-skills --skill laravel-database-optimization

---

laravel-queues

Production-grade queue patterns for Laravel 13 (MySQL + Redis). 20 rules across 6 categories: driver choice (database/redis/sqs), job design (ShouldQueue, IDs-not-models, idempotency), retry & failure (#[Backoff], #[FailOnTimeout], failed()), worker scaling and Supervisor config, Bus::batch vs Bus::chain, and when to adopt Horizon.

Example: Audit our queue setup or Review this job class

npx skills add AsyrafHussin/agent-skills --skill laravel-queues

---

laravel-ai-sdk

Laravel AI SDK for building AI-powered features. Contains 17 rules across 7 categories covering agents, tools, structured output, streaming, images, audio, embeddings, vector stores, and testing with fakes.

Example: Create an AI agent that analyzes sales transcripts

npx skills add AsyrafHussin/agent-skills --skill laravel-ai-sdk

---

laravel-mcp

Laravel MCP server development. Contains 7 rules across 5 categories covering server creation, tools with schemas, prompts, resources, authentication (OAuth/Sanctum), and testing.

Example: Create an MCP tool that exposes weather data to AI clients

npx skills add AsyrafHussin/agent-skills --skill laravel-mcp

---

License

MIT