Skip to content
Back to search

agent-skills

Skills for AI coding agents — Laravel, PHP, React, TypeScript, testing, security, and code quality.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/asyrafhussin-agent-skills/badge.svg)](/listings/asyrafhussin-agent-skills)

HTML

<a href="/listings/asyrafhussin-agent-skills"><img src="/api/listings/asyrafhussin-agent-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 364 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Agent Skills
  2. ![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)
  3. A collection of skills for AI coding agents. Works with Claude Code, Cursor, Codex, and [70+ agents](https://github.com/vercel-labs/skills#supported-agents).
  4. Skills follow the [Agent Skills](https://agentskills.io/) specification. Discover more at [skills.sh](https://skills.sh).
  5. ## Installation
  6. ### Using npx (recommended)
  7. ```bash
  8. # Install all skills
  9. npx skills add AsyrafHussin/agent-skills
  10. # Install a specific skill
  11. npx skills add AsyrafHussin/agent-skills --skill laravel-best-practices
  12. # Install multiple skills
  13. npx skills add AsyrafHussin/agent-skills --skill laravel-best-practices --skill seo-best-practices
  14. # Install globally (available across all projects)
  15. npx skills add AsyrafHussin/agent-skills -g
  16. # Install to a specific agent
  17. npx skills add AsyrafHussin/agent-skills -a claude-code
  18. # List available skills without installing
  19. npx skills add AsyrafHussin/agent-skills --list
  20. ```
  21. | Scope | Flag | Location | Use Case |
  22. |-------|------|----------|----------|
  23. | Project | (default) | `.claude/skills/` | Shared with team via git |
  24. | Global | `-g` | `~/.claude/skills/` | Available across all projects |
  25. ### Manual installation
  26. ```bash
  27. git clone https://github.com/AsyrafHussin/agent-skills.git
  28. # Copy all skills
  29. cp -r agent-skills/skills/* .claude/skills/
  30. # Or copy a single skill
  31. cp -r agent-skills/skills/laravel-best-practices .claude/skills/
  32. ```
  33. Each skill contains `SKILL.md`, `AGENTS.md`, `rules/`, and `metadata.json`.
  34. ### Managing skills
  35. ```bash
  36. npx skills list # List installed skills
  37. npx skills find laravel # Search for skills
  38. npx skills remove # Remove installed skills
  39. npx skills update # Update all skills to latest
  40. ```
  41. ## Available Skills
  42. ### [laravel-best-practices](skills/laravel-best-practices)
  43. Laravel 13 conventions and architecture. Contains 31 rules across 7 categories.
  44. **Example:** `Review this Laravel controller for best practices`
  45. ```bash
  46. npx skills add AsyrafHussin/agent-skills --skill laravel-best-practices
  47. ```
  48. ---
  49. ### [technical-debt](skills/technical-debt)
  50. 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.
  51. **Example:** `Audit technical debt in this project` or `What should we refactor first?`
  52. ```bash
  53. npx skills add AsyrafHussin/agent-skills --skill technical-debt
  54. ```
  55. ---
  56. ### [code-slop](skills/code-slop)
  57. 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.
  58. **`code-slop` vs `technical-debt` — which to pick?**
  59. | Use `code-slop` when… | Use `technical-debt` when… |
  60. |---|---|
  61. | Reviewing a PR — keeping the bar for clean code | Auditing the codebase for ranked debt to pay down |
  62. | Concern is **taste**: comments, naming, over-engineering, defensive overdose, test quality | Concern is **metrics**: complexity, duplication, CVEs, missing indexes, N+1 queries |
  63. | Question: "Is this clean code or sloppy patterns to reject?" | Question: "What should we refactor first?" |
  64. | Output: classified diff verdicts (CLEAN / SUSPICIOUS / INFLATED / CRITICAL) | Output: ranked debt ledger (P0–P3) |
  65. Run **both** for a full audit — taste check (`code-slop`) catches what metrics miss; metric audit (`technical-debt`) catches what taste-review misses.
  66. **Example:** `Review this PR for code quality` or `Find sloppy patterns in app/Services/`
  67. ```bash
  68. npx skills add AsyrafHussin/agent-skills --skill code-slop
  69. ```
  70. ---
  71. ### [project-docs](skills/project-docs)
  72. 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).
  73. **Example:** `Set up docs for this project` or `Audit the markdown files in this repo`
  74. ```bash
  75. npx skills add AsyrafHussin/agent-skills --skill project-docs
  76. ```
  77. ---
  78. ### [laravel-inertia-react](skills/laravel-inertia-react)
  79. Laravel 13 + Inertia.js + React 18 full-stack patterns. Covers page components, form handling, layouts, file uploads, and real-time features.
  80. **Example:** `How do I share data from Laravel to a React component with Inertia?`
  81. ```bash
  82. npx skills add AsyrafHussin/agent-skills --skill laravel-inertia-react
  83. ```
  84. ---
  85. ### [laravel-testing](skills/laravel-testing)
  86. 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`.
  87. **Example:** `Write feature tests for this Laravel controller`
  88. ```bash
  89. npx skills add AsyrafHussin/agent-skills --skill laravel-testing
  90. ```
  91. ---
  92. ### [laravel-owasp-security](skills/laravel-owasp-security)
  93. OWASP Top 10 security audit and secure coding guidelines for Laravel + React/Inertia.js.
  94. **Example:** `Run OWASP security audit on my Laravel app`
  95. ```bash
  96. npx skills add AsyrafHussin/agent-skills --skill laravel-owasp-security
  97. ```
  98. ---
  99. ### [php-best-practices](skills/php-best-practices)
  100. Modern PHP 8.0–8.5 patterns, type system, PSR standards, and SOLID principles. Contains 51 rules for secure, maintainable code.
  101. **Example:** `Review my PHP class for SOLID principles`
  102. ```bash
  103. npx skills add AsyrafHussin/agent-skills --skill php-best-practices
  104. ```
  105. ---
  106. ### [react-vite-best-practices](skills/react-vite-best-practices)
  107. 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.
  108. **Example:** `Review this React component for performance issues`
  109. ```bash
  110. npx skills add AsyrafHussin/agent-skills --skill react-vite-best-practices
  111. ```
  112. ---
  113. ### [typescript-react-patterns](skills/typescript-react-patterns)
  114. Type-safe React with TypeScript. Contains 33 rules across 7 categories covering component typing, hooks, event handling, refs, generics, context, and utility types.
  115. **Example:** `How do I properly type this React component with TypeScript?`
  116. ```bash
  117. npx skills add AsyrafHussin/agent-skills --skill typescript-react-patterns
  118. ```
  119. ---
  120. ### [state-management](skills/state-management)
  121. Server state with TanStack Query v5 and client state with Zustand v5. Covers caching, mutations, optimistic updates, and devtools.
  122. **Example:** `How do I manage server state with React Query?`
  123. ```bash
  124. npx skills add AsyrafHussin/agent-skills --skill state-management
  125. ```
  126. ---
  127. ### [tailwind-best-practices](skills/tailwind-best-practices)
  128. 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.
  129. **Example:** `Review my Tailwind classes for best practices`
  130. ```bash
  131. npx skills add AsyrafHussin/agent-skills --skill tailwind-best-practices
  132. ```
  133. ---
  134. ### [web-design-guidelines](skills/web-design-guidelines)
  135. WCAG accessibility, semantic HTML, keyboard navigation, forms, and performance. Contains 23 rules across 4 categories. Supports accessibility audit mode with PASS/FAIL checklist output.
  136. **Example:** `Run accessibility audit on this project` or `Review this component for accessibility`
  137. ```bash
  138. npx skills add AsyrafHussin/agent-skills --skill web-design-guidelines
  139. ```
  140. ---
  141. ### [clean-code-principles](skills/clean-code-principles)
  142. Language-agnostic SOLID, DRY, KISS principles and design patterns (Factory, Strategy, Repository). Contains 23 rules for maintainable software.
  143. **Example:** `Review this class for code smells and SOLID violations`
  144. ```bash
  145. npx skills add AsyrafHussin/agent-skills --skill clean-code-principles
  146. ```
  147. ---
  148. ### [api-design-patterns](skills/api-design-patterns)
  149. RESTful API design patterns. Contains 38 rules across 7 categories covering resource design, error handling, security, pagination, versioning, response format, and OpenAPI documentation.
  150. **Example:** `Review my API endpoints for REST best practices`
  151. ```bash
  152. npx skills add AsyrafHussin/agent-skills --skill api-design-patterns
  153. ```
  154. ---
  155. ### [git-workflow](skills/git-workflow)
  156. 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.
  157. **Example:** `Review my git workflow and suggest improvements`
  158. ```bash
  159. npx skills add AsyrafHussin/agent-skills --skill git-workflow
  160. ```
  161. ---
  162. ### [prd-writing](skills/prd-writing)
  163. 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.
  164. **Example:** `Write a PRD for this feature`
  165. ```bash
  166. npx skills add AsyrafHussin/agent-skills --skill prd-writing
  167. ```
  168. ---
  169. ### [testing-best-practices](skills/testing-best-practices)
  170. 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.
  171. **Example:** `Write tests for this Laravel service class`
  172. ```bash
  173. npx skills add AsyrafHussin/agent-skills --skill testing-best-practices
  174. ```
  175. ---
  176. ### [e2e-playwright-testing](skills/e2e-playwright-testing)
  177. 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.
  178. **Example:** `Write E2E tests for this login flow` or `Set up Playwright for this project`
  179. ```bash
  180. npx skills add AsyrafHussin/agent-skills --skill e2e-playwright-testing
  181. ```
  182. ---
  183. ### [seo-best-practices](skills/seo-best-practices)
  184. 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.
  185. **Example:** `Run SEO audit on this project` or `Set up Open Graph meta tags`
  186. ```bash
  187. npx skills add AsyrafHussin/agent-skills --skill seo-best-practices
  188. ```
  189. ---
  190. ### [laravel-database-optimization](skills/laravel-database-optimization)
  191. 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.
  192. **Example:** `Optimize the database queries in this controller`
  193. ```bash
  194. npx skills add AsyrafHussin/agent-skills --skill laravel-database-optimization
  195. ```
  196. ---
  197. ### [laravel-queues](skills/laravel-queues)
  198. 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.
  199. **Example:** `Audit our queue setup` or `Review this job class`
  200. ```bash
  201. npx skills add AsyrafHussin/agent-skills --skill laravel-queues
  202. ```
  203. ---
  204. ### [laravel-ai-sdk](skills/laravel-ai-sdk)
  205. 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.
  206. **Example:** `Create an AI agent that analyzes sales transcripts`
  207. ```bash
  208. npx skills add AsyrafHussin/agent-skills --skill laravel-ai-sdk
  209. ```
  210. ---
  211. ### [laravel-mcp](skills/laravel-mcp)
  212. Laravel MCP server development. Contains 7 rules across 5 categories covering server creation, tools with schemas, prompts, resources, authentication (OAuth/Sanctum), and testing.
  213. **Example:** `Create an MCP tool that exposes weather data to AI clients`
  214. ```bash
  215. npx skills add AsyrafHussin/agent-skills --skill laravel-mcp
  216. ```
  217. ---
  218. ## License
  219. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.