Syarif Laravel AI Skills

Laravel-focused AI skills for Codex, Claude Code, and any AI coding assistant that can read Markdown files. Install them with npx skills add, use the generated plugin packages, or point a generic assistant at the universal manifest and canonical skills/ folder.

Skills follow the Agent Skills format.

Language: English | Bahasa Indonesia

What You Get

  • 68 installable Laravel skills - a focused Laravel skill catalog with overlapping topics consolidated into stronger canonical skills.
  • Personal core standards - 12 local standards extracted from reviewed Laravel projects, with client details removed.
  • Public topic coverage - 54 additional topics mapped from public Laravel skill catalogs without copying third-party skill body text.
  • Responsive UI testing - a focused Playwright skill for mobile, tablet, desktop, overflow, clipping, tables, modals, navigation, and Livewire state checks.
  • Simple discovery - npx skills add <repo> --list reads each skills/<folder>/SKILL.md.
  • Universal assistant support - usable by Codex, Claude Code, Copilot, Cursor, Windsurf, Cline, Aider, OpenCode, Gemini CLI, and generic agents that can read files.

Installation

Browse the skills.sh page:

https://skills.sh/soden46/syarif-laravel-ai-skills

List available skills:

npx skills add soden46/syarif-laravel-ai-skills --list

Install all skills:

npx skills add soden46/syarif-laravel-ai-skills -s "*" -y

Install all skills globally for Codex:

npx skills add soden46/syarif-laravel-ai-skills -g -a codex -s "*" -y

Interactive install prompt:

Select the Laravel App Skills group to select every skill, then press Enter.

Install one skill:

npx skills add soden46/syarif-laravel-ai-skills -g -a codex -s form-requests -y

Verify installation:

npx skills list --global --agent codex

Codex Plugin

This repository can be submitted directly to codex-marketplace.com because the root .codex-plugin/plugin.json points to canonical skills/.

This repo also ships a Codex plugin marketplace:

codex plugin marketplace add soden46/syarif-laravel-ai-skills --ref main
codex plugin add syarif-laravel-ai-skills@syarif-laravel-ai-skills

For local development from this checkout:

codex plugin marketplace add .
codex plugin add syarif-laravel-ai-skills@syarif-laravel-ai-skills

Claude Code Plugin

The generated Claude plugin package lives at plugins/laravel-app-skills:

claude --plugin-dir ./plugins/laravel-app-skills

Inside Claude Code, reload and call a skill:

/reload-plugins
/laravel-app-skills:using-laravel-standards

For personal-only usage without a plugin package, install skills directly:

npx skills add soden46/syarif-laravel-ai-skills -g -a claude-code -s "*" -y

Universal AI Usage

For assistants without native skill/plugin support, add this repo to the workspace and start with:

Read AGENTS.md, then use skills/using-laravel-standards/SKILL.md as the entry skill for this Laravel repo. Load focused skills from skills/<skill-name>/SKILL.md only when relevant to the task.

Machine-readable metadata lives in agent-skills.json. Full assistant-specific notes are in docs/UNIVERSAL_USAGE.md.

Quick Start

After installation, ask your assistant to start with:

Use using-laravel-standards for this Laravel repo.

For focused tasks, call a smaller skill directly:

Use form-requests to move this validation out of the controller.
Use database-transactions to review this checkout flow.
Use quality-checks before final handoff.

What's Inside

Core Local Standards

  • using-laravel-standards - entry point and skill selector.
  • extract-laravel-standards - audit finished projects and propose reusable standards.
  • architecture - Laravel-native architecture decisions.
  • controller-cleanup - thin controllers and route boundaries.
  • form-requests - validation and request authorization.
  • actions-and-services - use-case boundaries, services, and integrations.
  • database-transactions - atomic writes, locks, and after-commit work.
  • eloquent-patterns - explicit models, relationships, and query shape.
  • livewire-development - version-aware Livewire components, state, security, performance, and tests.
  • queues-and-jobs - jobs, schedules, workers, and operational safety.
  • security - authorization, request forgery, uploads, secrets, and APIs.
  • testing - focused tests and verification before handoff.

Topic Coverage

  • Start Here - using-laravel-standards, runner-selection, daily-workflow, brainstorming, writing-plans, executing-plans, laravel-specialist, laravel-11-12-app-guidelines.
  • Architecture - architecture, actions-and-services, controller-cleanup, routes-best-practices, ports-and-adapters, interfaces-and-di, strategy-pattern, template-method-and-plugins, complexity-guardrails, constants-and-configuration, custom-helpers.
  • HTTP and Security - form-requests, api-resources-and-pagination, api-surface-evolution, policies-and-authorization, rate-limiting, request-forgery-protection, security.
  • Data and Eloquent - migrations-and-factories, eloquent-patterns, eloquent-relationships, database-transactions, data-chunking-large-datasets.
  • Performance - laravel-database-optimization, performance-caching, performance-eager-loading, performance-select-columns.
  • UI and Admin - blade-components-and-layouts, livewire-development, nova-resource-patterns, internationalization-and-translation.
  • Ops and Integrations - queues-and-jobs, horizon-metrics-and-dashboards, task-scheduling, filesystem-uploads, http-client-resilience, integrate-whatsapp-baileys-laravel, exception-handling-and-logging, config-env-storage.
  • Quality - testing, tdd-with-pest, controller-tests, e2e-playwright, responsive-ui-testing, quality-checks, documentation-best-practices, dependencies-trim-packages.
  • Modern Laravel - ai-sdk, vector-search, php-attributes, upgrade-13.
  • Prompting - effective-context, prompt-structure, debugging-prompts, code-review-requests, iterating-on-code, specifying-constraints, using-examples-in-prompts, laravel-prompting-patterns, extract-laravel-standards.

Run the list command for the complete catalog, or read docs/SUPERPOWERS_SKILL_MAPPING.md and docs/LARAVEL_SKILLS_CLOUD_MAPPING.md for public-topic mapping.

How It Works

  1. Each installable skill lives at skills/<skill-folder>/SKILL.md.
  2. The name frontmatter uses <skill-folder>.
  3. The description frontmatter appears in npx skills add <repo> --list.
  4. The tags frontmatter includes laravel and php for Laravel Skills import.
  5. skills.sh.json groups the skills shown on the skills.sh repository page.
  6. plugin-groups.json assigns every skill to an installable plugin bundle.
  7. agent-skills.json exposes neutral metadata for generic AI assistants and integration tools.
  8. .codex-plugin/plugin.json exposes the repo root as a codex-marketplace.com artifact and points directly to skills/.
  9. .agents/plugins/marketplace.json exposes the repo as a Codex/ChatGPT plugin marketplace.
  10. plugins/laravel-app-skills/.claude-plugin/plugin.json makes the generated bundle usable with claude --plugin-dir after npm run sync.
  11. npm run sync regenerates agent-skills.json, .codex-plugin/plugin.json, .agents/plugins/marketplace.json, .claude-plugin/marketplace.json, and local generated plugin output.
  12. Generated plugins/<plugin>/skills/ copies are ignored in Git so marketplace submissions stay under the 128-file scan limit.
  13. package.json is only for local helper scripts. Users install from GitHub with npx skills add, not npm install.

Marketplace Indexing

This repository is designed for skills.sh and Laravel Skills discovery:

  1. skills.sh sees GitHub repositories after someone installs from the repo with the skills CLI.
  2. skills.sh repo pages are cached, so updates can take time after a valid install.
  3. Each skill includes laravel and php tags for Laravel Skills classification.
  4. skills.laravel.cloud imports from the skills.sh ecosystem and lists Laravel/PHP skills after its import and security-audit pass.
  5. Run npx skills add soden46/syarif-laravel-ai-skills -s "*" -y after pushing a release to refresh skills.sh telemetry.

Local Development

npm run validate
npm run list
npm run install:local
npm run sync

To sync missing public topics from Superpowers Laravel:

npm run import:superpowers
npm run validate
npx skills add . --list

Use docs/ADDING_SKILLS.md as the standard for every future skill.

For contribution rules, privacy checks, and PR checklist, read CONTRIBUTING.md.

Reference

This README follows the readable documentation pattern from jpcaparas/superpowers-laravel: clear summary, install commands, quick start, catalog overview, workflow notes, and release links.

Related files:

License

MIT License - see LICENSE.

Yang Didapat

  • 68 skill Laravel installable - katalog skill Laravel yang fokus dengan topik tumpang tindih digabung menjadi skill canonical yang lebih kuat.
  • Standar inti pribadi - 12 standar lokal dari proyek Laravel yang sudah direview, tanpa detail client.
  • Cakupan topik publik - 54 topik tambahan yang dimapping dari katalog skill Laravel publik tanpa menyalin isi body skill pihak ketiga.
  • Responsive UI testing - skill Playwright khusus untuk mobile, tablet, desktop, overflow, clipping, tabel, modal, navigasi, dan state Livewire.
  • Discovery sederhana - npx skills add <repo> --list membaca setiap skills/<folder>/SKILL.md.
  • Support AI universal - bisa dipakai Codex, Claude Code, Copilot, Cursor, Windsurf, Cline, Aider, OpenCode, Gemini CLI, dan agent generik yang bisa membaca file.

Instalasi

Lihat halaman skills.sh:

https://skills.sh/soden46/syarif-laravel-ai-skills

Lihat daftar skill:

npx skills add soden46/syarif-laravel-ai-skills --list

Install semua skill:

npx skills add soden46/syarif-laravel-ai-skills -s "*" -y

Install semua skill global untuk Codex:

npx skills add soden46/syarif-laravel-ai-skills -g -a codex -s "*" -y

Prompt install interaktif:

Pilih group Laravel App Skills untuk memilih semua skill, lalu tekan Enter.

Install satu skill:

npx skills add soden46/syarif-laravel-ai-skills -g -a codex -s form-requests -y

Cek hasil install:

npx skills list --global --agent codex

Plugin Codex

Repository ini bisa langsung disubmit ke codex-marketplace.com karena root .codex-plugin/plugin.json menunjuk ke canonical skills/.

Repo ini juga menyediakan marketplace plugin Codex:

codex plugin marketplace add soden46/syarif-laravel-ai-skills --ref main
codex plugin add syarif-laravel-ai-skills@syarif-laravel-ai-skills

Untuk development lokal dari checkout ini:

codex plugin marketplace add .
codex plugin add syarif-laravel-ai-skills@syarif-laravel-ai-skills

Plugin Claude Code

Package plugin Claude yang digenerate ada di plugins/laravel-app-skills:

claude --plugin-dir ./plugins/laravel-app-skills

Di dalam Claude Code, reload lalu panggil skill:

/reload-plugins
/laravel-app-skills:using-laravel-standards

Kalau cuma dipakai sendiri tanpa package plugin, install skill langsung:

npx skills add soden46/syarif-laravel-ai-skills -g -a claude-code -s "*" -y

Penggunaan AI Universal

Untuk assistant yang belum punya support skill/plugin native, masukkan repo ini ke workspace lalu mulai dengan:

Read AGENTS.md, then use skills/using-laravel-standards/SKILL.md as the entry skill for this Laravel repo. Load focused skills from skills/<skill-name>/SKILL.md only when relevant to the task.

Metadata machine-readable ada di agent-skills.json. Catatan lengkap per assistant ada di docs/UNIVERSAL_USAGE.md.

Quick Start

Setelah install, minta assistant mulai dari:

Use using-laravel-standards for this Laravel repo.

Untuk task yang lebih spesifik, panggil skill kecil langsung:

Use form-requests to move this validation out of the controller.
Use database-transactions to review this checkout flow.
Use quality-checks before final handoff.

Isi Repository

Standar Inti Lokal

  • using-laravel-standards - entry point dan pemilih skill.
  • extract-laravel-standards - audit proyek selesai dan usulkan standar reusable.
  • architecture - keputusan arsitektur Laravel-native.
  • controller-cleanup - controller tipis dan batas route.
  • form-requests - validasi dan request authorization.
  • actions-and-services - use-case boundary, service, dan integrasi.
  • database-transactions - atomic write, lock, dan after-commit work.
  • eloquent-patterns - model, relationship, dan query shape yang eksplisit.
  • livewire-development - komponen Livewire version-aware, state, security, performa, dan test.
  • queues-and-jobs - job, schedule, worker, dan operational safety.
  • security - authorization, request forgery, upload, secret, dan API.
  • testing - test yang fokus dan verifikasi sebelum handoff.

Cakupan Topik

  • Mulai Di Sini - using-laravel-standards, runner-selection, daily-workflow, brainstorming, writing-plans, executing-plans, laravel-specialist, laravel-11-12-app-guidelines.
  • Arsitektur - architecture, actions-and-services, controller-cleanup, routes-best-practices, ports-and-adapters, interfaces-and-di, strategy-pattern, template-method-and-plugins, complexity-guardrails, constants-and-configuration, custom-helpers.
  • HTTP dan Security - form-requests, api-resources-and-pagination, api-surface-evolution, policies-and-authorization, rate-limiting, request-forgery-protection, security.
  • Data dan Eloquent - migrations-and-factories, eloquent-patterns, eloquent-relationships, database-transactions, data-chunking-large-datasets.
  • Performance - laravel-database-optimization, performance-caching, performance-eager-loading, performance-select-columns.
  • UI dan Admin - blade-components-and-layouts, livewire-development, nova-resource-patterns, internationalization-and-translation.
  • Operasional dan Integrasi - queues-and-jobs, horizon-metrics-and-dashboards, task-scheduling, filesystem-uploads, http-client-resilience, integrate-whatsapp-baileys-laravel, exception-handling-and-logging, config-env-storage.
  • Quality - testing, tdd-with-pest, controller-tests, e2e-playwright, responsive-ui-testing, quality-checks, documentation-best-practices, dependencies-trim-packages.
  • Modern Laravel - ai-sdk, vector-search, php-attributes, upgrade-13.
  • Prompting - effective-context, prompt-structure, debugging-prompts, code-review-requests, iterating-on-code, specifying-constraints, using-examples-in-prompts, laravel-prompting-patterns, extract-laravel-standards.

Jalankan command list untuk katalog lengkap, atau baca docs/SUPERPOWERS_SKILL_MAPPING.md dan docs/LARAVEL_SKILLS_CLOUD_MAPPING.md untuk mapping topik publik.

Cara Kerja

  1. Setiap skill installable berada di skills/<skill-folder>/SKILL.md.
  2. Frontmatter name memakai format <skill-folder>.
  3. Frontmatter description tampil di npx skills add <repo> --list.
  4. Frontmatter tags berisi laravel dan php untuk import Laravel Skills.
  5. skills.sh.json mengelompokkan skill yang tampil di halaman repository skills.sh.
  6. plugin-groups.json menempatkan setiap skill ke bundle plugin installable.
  7. agent-skills.json menyediakan metadata netral untuk AI assistant generik dan tool integrasi.
  8. .codex-plugin/plugin.json membuat root repo bisa discan sebagai artifact codex-marketplace.com dan langsung menunjuk ke skills/.
  9. .agents/plugins/marketplace.json membuat repo ini bisa dipakai sebagai marketplace plugin Codex/ChatGPT.
  10. plugins/laravel-app-skills/.claude-plugin/plugin.json membuat bundle generated bisa dipakai dengan claude --plugin-dir setelah npm run sync.
  11. npm run sync membuat ulang agent-skills.json, .codex-plugin/plugin.json, .agents/plugins/marketplace.json, .claude-plugin/marketplace.json, dan output plugin generated lokal.
  12. Copy generated plugins/<plugin>/skills/ di-ignore dari Git supaya submission marketplace tetap di bawah limit scan 128 file.
  13. package.json hanya untuk helper script lokal. User install dari GitHub dengan npx skills add, bukan npm install.

Indexing Marketplace

Repository ini disiapkan untuk discovery skills.sh dan Laravel Skills:

  1. skills.sh melihat repository GitHub setelah ada yang install dari repo memakai skills CLI.
  2. Halaman repo skills.sh memakai cache, jadi update bisa butuh waktu setelah install valid.
  3. Setiap skill punya tag laravel dan php untuk klasifikasi Laravel Skills.
  4. skills.laravel.cloud import dari ekosistem skills.sh dan menampilkan skill Laravel/PHP setelah proses import dan security audit lolos.
  5. Jalankan npx skills add soden46/syarif-laravel-ai-skills -s "*" -y setelah push release untuk refresh telemetry skills.sh.

Development Lokal

npm run validate
npm run list
npm run install:local
npm run sync

Untuk sync topik publik yang belum ada dari Superpowers Laravel:

npm run import:superpowers
npm run validate
npx skills add . --list

Gunakan docs/ADDING_SKILLS.md sebagai standar setiap kali menambah skill baru.

Untuk aturan kontribusi, pengecekan privasi, dan checklist PR, baca CONTRIBUTING.md.

Referensi

README ini mengikuti pola dokumentasi yang mudah dibaca dari jpcaparas/superpowers-laravel: ringkasan jelas, command install, quick start, overview katalog, catatan workflow, dan link release.

File terkait:

Lisensi

MIT License - lihat LICENSE.