AureusERP Agent Skills

This repository stores reusable AI agent skills for the AureusERP Laravel codebase.

Skills follow the Agent Skills format.

Skills in this repo are designed to help coding agents produce plugin-consistent code, APIs, and tests across the plugins/webkul/* ecosystem.

Available Skills

aureuserp-plugin-builder

Builds/refactors AureusERP plugins with project-standard patterns:

• Service provider + plugin registration
• Admin/customer panel wiring
• ACL and policy integration
• Settings, dashboard pages, widgets, and table views
• Translation structure and install/uninstall lifecycle

aureuserp-api-builder

Builds and refactors plugin REST APIs following AureusERP conventions:

• Route conventions and auth middleware
• Controller patterns + Scribe attributes
• FormRequest rules from Filament analysis
• API resources + soft-delete restore/force flows
• Optional plugin dependency guards

aureuserp-test-case-builder

Builds and refactors Pest API feature tests for plugins:

• Factory-first setup and payloads
• Permission/auth bootstrap helpers
• Stable JSON assertions
• Plugin install/bootstrap-safe test strategy

Install

Install all skills:

npx skills add aureuserp/agent-skills

Install a specific skill:

npx skills add aureuserp/agent-skills --skill "aureuserp-plugin-builder"
npx skills add aureuserp/agent-skills --skill "aureuserp-api-builder"
npx skills add aureuserp/agent-skills --skill "aureuserp-test-case-builder"

Install for a specific agent:

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

Repository Structure

agent-skills/
├── skills/
│   ├── aureuserp-api-builder/
│   │   ├── SKILL.md
│   │   └── references/
│   ├── aureuserp-plugin-builder/
│   │   ├── SKILL.md
│   │   └── references/
│   └── aureuserp-test-case-builder/
│       ├── SKILL.md
│       └── references/
├── AGENTS.md
└── README.md

Each skill contains:

• SKILL.md: skill workflow, scope, and constraints
• references/: supporting conventions and implementation checklists

Contribution Guidelines

When adding or updating a skill:

• Keep it focused on a single capability
• Start SKILL.md with YAML frontmatter (name, description)
• Reuse real AureusERP conventions from sibling plugins
• Prefer plugin-local guidance and avoid cross-plugin assumptions
• Keep instructions actionable and deterministic for coding agents