bagisto/agent-skills

Agent skills for Bagisto — a Laravel-based open-source e-commerce platform.

These skills provide domain-specific, reusable context for AI agents (Claude Code, Cursor, Windsurf, etc.) working inside a Bagisto codebase.

Available Skills

package-development

Package development in Bagisto.

Activates when: creating packages, migrations, models, repositories, routes, controllers, views, localization, DataGrid, menus, ACL, or system configuration — or when the user mentions package, migration, model, repository, controller, DataGrid, menu, or ACL.

---

shipping-method-development

Shipping method development in Bagisto.

Activates when: creating shipping methods, integrating shipping carriers like FedEx, UPS, DHL, or any third-party shipping provider — or when the user mentions shipping, shipping method, shipping carrier, delivery, or needs to add a new shipping option to checkout.

---

payment-method-development

Payment gateway development in Bagisto.

Activates when: creating payment methods, integrating payment gateways like Stripe, PayPal, or any third-party payment processor — or when the user mentions payment, payment gateway, payment method, Stripe, PayPal, or needs to add a new payment option to the checkout.

---

product-type-development

Product type development in Bagisto.

Activates when: creating custom product types, defining product behaviors, or implementing specialized product logic — or when the user mentions product type, custom product, or needs to implement product-specific behavior.

---

shop-theme-development

Shop theme development in Bagisto.

Activates when: creating custom storefront themes, modifying shop layouts, building theme packages, or working with Vite-powered assets for the customer-facing side of the application.

---

admin-theme-development

Admin theme development in Bagisto.

Activates when: creating custom admin themes, modifying admin layouts, building admin theme packages, or working with admin panel styling and interface customization.

---

pest-testing

Tests applications using the Pest 3 PHP framework.

Activates when: writing tests, creating unit or feature tests, adding assertions, testing Livewire components, architecture testing, debugging test failures, working with datasets or mocking — or when the user mentions test, spec, TDD, expects, assertion, coverage, or needs to verify functionality works.

---

Install

Install all skills from this repo into your AI agent:

npx skills add bagisto/agent-skills

Install a specific skill only:

npx skills add bagisto/agent-skills --skill "package-development"
npx skills add bagisto/agent-skills --skill "shipping-method-development"
npx skills add bagisto/agent-skills --skill "payment-method-development"
npx skills add bagisto/agent-skills --skill "product-type-development"
npx skills add bagisto/agent-skills --skill "shop-theme-development"
npx skills add bagisto/agent-skills --skill "admin-theme-development"
npx skills add bagisto/agent-skills --skill "pest-testing"

Install for a specific agent:

npx skills add bagisto/agent-skills -a claude-code
npx skills add bagisto/agent-skills -a cursor

Repository Structure

agent-skills/
├── skills/
│   ├── package-development/
│   │   └── SKILL.md
│   ├── shipping-method-development/
│   │   └── SKILL.md
│   ├── payment-method-development/
│   │   └── SKILL.md
│   ├── product-type-development/
│   │   └── SKILL.md
│   ├── shop-theme-development/
│   │   └── SKILL.md
│   ├── admin-theme-development/
│   │   └── SKILL.md
│   └── pest-testing/
│       └── SKILL.md
├── AGENTS.md
└── README.md

Each skill folder contains a SKILL.md file with agent-readable instructions and a YAML frontmatter block that defines when the skill activates.