asyrafhussin/agent-skills
24 skills12.8k installs1.4k starsGitHub
Install
npx skills add https://github.com/asyrafhussin/agent-skillsSkills in this repo
1Php Best PracticesThe php-best-practices skill applies modern PHP 8.x patterns, PSR standards, SOLID principles, and security guidance through 51 rules grouped by type system, modern features, PSR compliance, SOLID, error handling, performance, and security priorities. Step one detects the project PHP version from composer.json require php constraints and runtime php -v output before suggesting syntax because features differ from 8.0 through 8.5 including enums, readonly classes, property hooks, and the 8.5 pipe operator. Type rules demand strict_types, return types, parameter and property types, union and intersection types, and avoiding mixed. Modern rules promote constructor promotion, match expressions, nullsafe operators, enums with methods, readonly properties, typed constants, Override attributes, and property hooks when version allows. PSR coverage spans PSR-4 autoloading, PSR-12 style, naming, and one class per file. Security rules require prepared SQL, password_hash, input validation, contextual output escaping, and safe upload handling. Audits output file:line category descriptions such as missing return types or deprecated patterns.2.5kinstalls2React Vite Best PracticesReact and Vite performance optimization guidelines Use when writing reviewing or optimizing React components built with Vite Triggers on tasks involving Vite configuration build optimization code splitting lazy loading HMR bundle size or React performance The react-vite-best-practices skill documents workflows and patterns from the repository SKILL md name react-vite-best-practices description React and Vite performance optimization guidelines Use when writing reviewing or optimizing React components built with Vite Triggers on tasks involving Vite configuration build optimization code splitting lazy loading HMR bundle size or React performance license MIT metadata author agent-skills version 2 0 0 React Vite Best Practices Comprehensive performance optimization guide for React applications built with Vite Contains 23 rules across 6 categories for build optimization code splitting development performance asset handling environment configuration and bundle analysis Metadata Version 2 0 0 Framework React Vite Rule Count 23 rules across 6 categories License MIT When to Apply Reference these guidelines when Configuring Vite for React projects Implementing code splitting and lazy loadi.1.9kinstalls3Laravel Best PracticesThe laravel-best-practices skill is designed for apply Laravel 13 conventions for controllers, models, migrations, and services. Laravel 13 Best Practices Comprehensive best practices guide for Laravel 13 applications. Contains 31 rules across 7 categories for building scalable, maintainable Laravel applications. Invoke when the user creates Laravel controllers, models, migrations, validation, or services.1.4kinstalls4Clean Code Principlesclean-code-principles is a language-agnostic agent skill (version 1.0.2, MIT) from asyrafhussin/agent-skills documenting 23 rules across 7 priority categories—10 SOLID, 12 core principles, and design patterns—with bad and good examples per rule. Categories span CRITICAL SOLID and core principles down to LOW-priority comment guidance, giving agents concrete refactoring guardrails instead of vague style advice. Activate it when generating new modules, reviewing pull requests, or refactoring legacy services where drift toward god objects and duplication is likely. The skill fits any stack because rules reference patterns, not framework APIs. A fourth pattern category is noted as planned in the documentation. Reach for clean-code-principles when you want agents to self-check architecture during implementation—not when you only need a language-specific linter config. Each rule pairs explanations with practical before-and-after snippets agents can apply immediately.960installs5Laravel Inertia Reactlaravel-inertia-react is a comprehensive agent skill for building modern monolithic applications with a Laravel backend, Inertia.js adapter, and React frontend. It organizes guidance into 24 rules across six categories covering Inertia page components, useForm hook forms, Link-based navigation, HandleInertiaRequests shared data, and Laravel-Inertia integration conventions. Developers reach for laravel-inertia-react when AI agents need consistent, production-aligned patterns instead of mixing SPA routing approaches that fight Inertia's server-driven model.954installs6Typescript React Patternstypescript-react-patterns is an agent skill from asyrafhussin/agent-skills version 2.0.0 that codifies 33 TypeScript rules across 7 categories for React development. Categories span component typing (props interfaces, forwardRef, polymorphic as props), hook typing (useState, useReducer, useCallback, custom hooks), event handlers, ref patterns including useImperativeHandle, generic list/select/table components, typed Context providers, and utility types like ComponentPropsWithoutRef and discriminated unions. Developers reach for typescript-react-patterns when fixing TypeScript errors in React code, typing new components and hooks, or standardizing folder-level patterns during agent-assisted UI work. Each rule uses prefixed identifiers such as comp-props-interface and hook-use-reducer with detailed explanations in individual rules/ files and a compiled AGENTS.md reference. Priority ranks component and hook typing as CRITICAL, event and ref typing as HIGH, and utility types as LOW impact guidance.477installs7Tailwind Best Practicestailwind-best-practices (version 1.0.0, MIT) in asyrafhussin/agent-skills packages 29 rules across 8 priority categories for Tailwind CSS v3.4+ and v4.0+. Agents start by detecting the installed version from package.json and config signals—tailwind.config.js for v3 versus @import "tailwindcss" and @theme blocks for v4—then apply prefixed rule sets for responsive design, dark mode, component patterns, configuration, migration, spacing, animation, and performance. Critical rules cover mobile-first breakpoints, dark: class variants, clsx and tailwind-merge cn() utilities, component variant patterns, and v4 @theme configuration replacing JS config files. The skill includes worked examples for responsive grids, form styling, reduced-motion animations, and side-by-side v3 versus v4 theme setup. Developers reach for it when writing Tailwind classes, implementing dark mode toggles, extracting reusable button variants, or migrating projects from Tailwind v3 to v4. Triggers include responsive design, dark mode, CSS styling, and migrate to Tailwind v4 requests.404installs8Api Design Patternsapi-design-patterns is a MIT-licensed version 2.0.0 skill from asyrafhussin/agent-skills encoding RESTful API design principles for consistent, developer-friendly HTTP services. It organizes 38 rules across seven priority categories: resource design (nouns, plural resources, HTTP methods, status codes, idempotency, HATEOAS), error handling (machine-readable codes, validation details, request IDs), security (OAuth2/JWT, RBAC, rate limiting, CORS, HTTPS), pagination and filtering (cursor and offset), versioning (URL and header strategies), response format conventions, and OpenAPI documentation with changelogs. Prefixes like rest-, error-, sec-, page-, ver-, resp-, and doc- tag each rule for quick reference during reviews. Developers reach for api-design-patterns when designing new endpoints, reviewing existing routes, implementing error envelopes, or planning deprecation. Triggers include design API, review API, REST best practices, and API patterns prompts. The skill suits backend engineers and agent-tool authors who need predictable contracts before clients integrate.371installs9Testing Best Practicestesting-best-practices is version 2.0.0 of asyrafhussin/agent-skills, an MIT-licensed guide containing 34 rules across 7 prioritized categories for TypeScript tests with Jest or Vitest. Categories span Test Structure (struct-*), Test Isolation (iso-*), Assertions (assert-*), Test Data (data-*), Mocking with MSW boundaries (mock-*), Coverage (cov-*), and Performance targets under 50ms per unit test (perf-*). Individual rule files live under rules/ and the compiled AGENTS.md expands every guideline with AAA, describe/it organization, factories, builders, and meaningful coverage guidance. Developers invoke testing-best-practices when writing new tests, reviewing PR test quality, debugging flaky suites, or setting CI-friendly testing strategy rather than improvising patterns ad hoc.362installs10Git WorkflowTeaches agent-friendly git workflow conventions—branching, atomic commits, rebasing, and pull request hygiene—so automated coding sessions produce clean, reviewable history on shared repositories.355installs11Laravel Database OptimizationApplies Laravel-specific database optimization techniques including query tuning, indexing strategies, N+1 elimination, eager loading, and migration-safe performance improvements for production PHP SaaS and API applications.349installs12Laravel Owasp SecurityLaravel OWASP security skill for agent-assisted PHP apps: maps OWASP risks to Laravel middleware, Eloquent queries, validation, sessions, and deployment settings so APIs and ecommerce backends ship with fewer exploitable flaws.339installs13Web Design GuidelinesWeb design guidelines skill gives agents practical UI/UX rules for typography, color contrast, layout grids, spacing, and accessible interactions when building SaaS dashboards, content sites, and ecommerce storefront interfaces.326installs14State ManagementCovers frontend state management patterns for modern web and mobile clients, helping developers structure stores, handle async updates, and keep UI state consistent across components and navigation.276installs15Laravel TestingLaravel-focused testing skill for PHPUnit or Pest suites covering HTTP APIs, Eloquent models, middleware, jobs, and service layers with factories, mocks, and database refresh patterns before production deploys.273installs16E2e Playwright TestingProvides Playwright end-to-end testing guidance for web applications, covering test structure, browser automation, assertion patterns, and regression coverage so teams can validate user flows before release.243installs17Seo Best PracticesSEO best practices skill teaches agents how to implement search-friendly titles, headings, canonical tags, sitemaps, structured data, and content structure for SaaS landings, blogs, and ecommerce pages at go-live.219installs18Laravel Ai SdkThis skill guides building AI-powered features with the Laravel AI SDK (laravel/ai). It contains 17 rules across 7 categories covering agents, tools, media generation, embeddings, vector stores, and testing. Developers use it when creating AI agents, generating images or audio, building RAG features, or testing AI features with fakes.184installs19Prd Writingprd-writing is a Claude Code skill that walks through a 6-step process for writing a Product Requirements Document. It assesses project state, asks clarifying questions, drafts a 12-section PRD, and saves it to docs/prd. A developer uses it when scoping a new feature or product before building.183installs20Laravel McpThis skill guides building MCP (Model Context Protocol) servers with Laravel to expose tools, prompts, and resources to AI clients. It contains 7 rules across 5 categories covering server creation, tools, prompts, resources, authentication, and testing. Developers use it when building MCP servers or tools for AI client integration, including protecting them with OAuth or Sanctum.177installs21Code SlopThis skill provides a taste-level code review that detects AI-generated patterns in PHP/Laravel and TypeScript/React code. It runs a 24-rule checklist covering comment narration, generic naming, premature interfaces, defensive overdose, mock-everything tests, and style fingerprints. Developers use it when reviewing AI-assisted PRs or hardening a code-review checklist, and it ends with a per-file slop ledger.166installs22Technical Debttechnical-debt is a Claude Code skill that audits and prioritizes technical debt in PHP/Laravel and Node/TypeScript/React projects. It runs a checklist across code, security, design, dependency, test, performance, data, docs, infra, and process debt, then produces a ranked ledger by effort and impact. A developer uses it to decide what to refactor first.155installs23Laravel QueuesThis skill covers production-grade Laravel 13 queue and job patterns for MySQL and Redis, optionally with Horizon. It contains 20 rules across 6 categories spanning driver choice, job design, retry and failure handling, worker scaling, batching and chaining, and testing. Developers use it when designing async jobs, configuring Horizon, debugging stuck jobs, or auditing queue health.146installs24Project Docsproject-docs is a Claude Code skill that manages the documentation lifecycle for PHP/Laravel and Node/TypeScript/React projects. It bootstraps a docs folder, audits existing markdown into a keep/update/archive/delete ledger, and looks up naming and folder conventions. A developer uses it to set up docs baselines or clean up accumulated AI-generated junk.137installs