{
  "markdown": "# Agent Skills\n\n![Release](https://img.shields.io/github/v/release/AsyrafHussin/agent-skills?style=flat-square) ![Stars](https://img.shields.io/github/stars/AsyrafHussin/agent-skills?style=flat-square) ![License](https://img.shields.io/github/license/AsyrafHussin/agent-skills?style=flat-square)\n\nA collection of skills for AI coding agents. Works with Claude Code, Cursor, Codex, and [70+ agents](https://github.com/vercel-labs/skills#supported-agents).\n\nSkills follow the [Agent Skills](https://agentskills.io/) specification. Discover more at [skills.sh](https://skills.sh).\n\n## Installation\n\n### Using npx (recommended)\n\n```bash\n# Install all skills\nnpx skills add AsyrafHussin/agent-skills\n\n# Install a specific skill\nnpx skills add AsyrafHussin/agent-skills --skill laravel-best-practices\n\n# Install multiple skills\nnpx skills add AsyrafHussin/agent-skills --skill laravel-best-practices --skill seo-best-practices\n\n# Install globally (available across all projects)\nnpx skills add AsyrafHussin/agent-skills -g\n\n# Install to a specific agent\nnpx skills add AsyrafHussin/agent-skills -a claude-code\n\n# List available skills without installing\nnpx skills add AsyrafHussin/agent-skills --list\n```\n\n| Scope | Flag | Location | Use Case |\n|-------|------|----------|----------|\n| Project | (default) | `.claude/skills/` | Shared with team via git |\n| Global | `-g` | `~/.claude/skills/` | Available across all projects |\n\n### Manual installation\n\n```bash\ngit clone https://github.com/AsyrafHussin/agent-skills.git\n\n# Copy all skills\ncp -r agent-skills/skills/* .claude/skills/\n\n# Or copy a single skill\ncp -r agent-skills/skills/laravel-best-practices .claude/skills/\n```\n\nEach skill contains `SKILL.md`, `AGENTS.md`, `rules/`, and `metadata.json`.\n\n### Managing skills\n\n```bash\nnpx skills list              # List installed skills\nnpx skills find laravel      # Search for skills\nnpx skills remove            # Remove installed skills\nnpx skills update            # Update all skills to latest\n```\n\n## Available Skills\n\n### [laravel-best-practices](skills/laravel-best-practices)\n\nLaravel 13 conventions and architecture. Contains 31 rules across 7 categories.\n\n**Example:** `Review this Laravel controller for best practices`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill laravel-best-practices\n```\n\n---\n\n### [technical-debt](skills/technical-debt)\n\nTechnical 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.\n\n**Example:** `Audit technical debt in this project` or `What should we refactor first?`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill technical-debt\n```\n\n---\n\n### [code-slop](skills/code-slop)\n\nCode-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.\n\n**`code-slop` vs `technical-debt` — which to pick?**\n\n| Use `code-slop` when… | Use `technical-debt` when… |\n|---|---|\n| Reviewing a PR — keeping the bar for clean code | Auditing the codebase for ranked debt to pay down |\n| Concern is **taste**: comments, naming, over-engineering, defensive overdose, test quality | Concern is **metrics**: complexity, duplication, CVEs, missing indexes, N+1 queries |\n| Question: \"Is this clean code or sloppy patterns to reject?\" | Question: \"What should we refactor first?\" |\n| Output: classified diff verdicts (CLEAN / SUSPICIOUS / INFLATED / CRITICAL) | Output: ranked debt ledger (P0–P3) |\n\nRun **both** for a full audit — taste check (`code-slop`) catches what metrics miss; metric audit (`technical-debt`) catches what taste-review misses.\n\n**Example:** `Review this PR for code quality` or `Find sloppy patterns in app/Services/`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill code-slop\n```\n\n---\n\n### [project-docs](skills/project-docs)\n\nDocumentation 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).\n\n**Example:** `Set up docs for this project` or `Audit the markdown files in this repo`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill project-docs\n```\n\n---\n\n### [laravel-inertia-react](skills/laravel-inertia-react)\n\nLaravel 13 + Inertia.js + React 18 full-stack patterns. Covers page components, form handling, layouts, file uploads, and real-time features.\n\n**Example:** `How do I share data from Laravel to a React component with Inertia?`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill laravel-inertia-react\n```\n\n---\n\n### [laravel-testing](skills/laravel-testing)\n\nLaravel 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`.\n\n**Example:** `Write feature tests for this Laravel controller`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill laravel-testing\n```\n\n---\n\n### [laravel-owasp-security](skills/laravel-owasp-security)\n\nOWASP Top 10 security audit and secure coding guidelines for Laravel + React/Inertia.js.\n\n**Example:** `Run OWASP security audit on my Laravel app`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill laravel-owasp-security\n```\n\n---\n\n### [php-best-practices](skills/php-best-practices)\n\nModern PHP 8.0–8.5 patterns, type system, PSR standards, and SOLID principles. Contains 51 rules for secure, maintainable code.\n\n**Example:** `Review my PHP class for SOLID principles`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill php-best-practices\n```\n\n---\n\n### [react-vite-best-practices](skills/react-vite-best-practices)\n\nReact + 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.\n\n**Example:** `Review this React component for performance issues`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill react-vite-best-practices\n```\n\n---\n\n### [typescript-react-patterns](skills/typescript-react-patterns)\n\nType-safe React with TypeScript. Contains 33 rules across 7 categories covering component typing, hooks, event handling, refs, generics, context, and utility types.\n\n**Example:** `How do I properly type this React component with TypeScript?`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill typescript-react-patterns\n```\n\n---\n\n### [state-management](skills/state-management)\n\nServer state with TanStack Query v5 and client state with Zustand v5. Covers caching, mutations, optimistic updates, and devtools.\n\n**Example:** `How do I manage server state with React Query?`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill state-management\n```\n\n---\n\n### [tailwind-best-practices](skills/tailwind-best-practices)\n\nTailwind 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.\n\n**Example:** `Review my Tailwind classes for best practices`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill tailwind-best-practices\n```\n\n---\n\n### [web-design-guidelines](skills/web-design-guidelines)\n\nWCAG accessibility, semantic HTML, keyboard navigation, forms, and performance. Contains 23 rules across 4 categories. Supports accessibility audit mode with PASS/FAIL checklist output.\n\n**Example:** `Run accessibility audit on this project` or `Review this component for accessibility`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill web-design-guidelines\n```\n\n---\n\n### [clean-code-principles](skills/clean-code-principles)\n\nLanguage-agnostic SOLID, DRY, KISS principles and design patterns (Factory, Strategy, Repository). Contains 23 rules for maintainable software.\n\n**Example:** `Review this class for code smells and SOLID violations`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill clean-code-principles\n```\n\n---\n\n### [api-design-patterns](skills/api-design-patterns)\n\nRESTful API design patterns. Contains 38 rules across 7 categories covering resource design, error handling, security, pagination, versioning, response format, and OpenAPI documentation.\n\n**Example:** `Review my API endpoints for REST best practices`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill api-design-patterns\n```\n\n---\n\n### [git-workflow](skills/git-workflow)\n\nGit 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.\n\n**Example:** `Review my git workflow and suggest improvements`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill git-workflow\n```\n\n---\n\n### [prd-writing](skills/prd-writing)\n\nStep-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.\n\n**Example:** `Write a PRD for this feature`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill prd-writing\n```\n\n---\n\n### [testing-best-practices](skills/testing-best-practices)\n\nUnit, 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.\n\n**Example:** `Write tests for this Laravel service class`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill testing-best-practices\n```\n\n---\n\n### [e2e-playwright-testing](skills/e2e-playwright-testing)\n\nEnd-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.\n\n**Example:** `Write E2E tests for this login flow` or `Set up Playwright for this project`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill e2e-playwright-testing\n```\n\n---\n\n### [seo-best-practices](skills/seo-best-practices)\n\nSEO 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.\n\n**Example:** `Run SEO audit on this project` or `Set up Open Graph meta tags`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill seo-best-practices\n```\n\n---\n\n### [laravel-database-optimization](skills/laravel-database-optimization)\n\nLaravel 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.\n\n**Example:** `Optimize the database queries in this controller`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill laravel-database-optimization\n```\n\n---\n\n### [laravel-queues](skills/laravel-queues)\n\nProduction-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.\n\n**Example:** `Audit our queue setup` or `Review this job class`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill laravel-queues\n```\n\n---\n\n### [laravel-ai-sdk](skills/laravel-ai-sdk)\n\nLaravel 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.\n\n**Example:** `Create an AI agent that analyzes sales transcripts`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill laravel-ai-sdk\n```\n\n---\n\n### [laravel-mcp](skills/laravel-mcp)\n\nLaravel MCP server development. Contains 7 rules across 5 categories covering server creation, tools with schemas, prompts, resources, authentication (OAuth/Sanctum), and testing.\n\n**Example:** `Create an MCP tool that exposes weather data to AI clients`\n\n```bash\nnpx skills add AsyrafHussin/agent-skills --skill laravel-mcp\n```\n\n---\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 13366,
  "sha": "19d9c93b7b965e4f046ae984ebb15e7e2d75d68b219bc6ace986408e82760dab",
  "repo_slug": "asyrafhussin/agent-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_asyrafhussin_agent_skills_laravel_best_p_e70e19e7/readme"
}