AI Skills
AI Skills
Glueful Skills is a set of official coding-assistant skills that teach AI agents Glueful's actual conventions — ApplicationContext, the framework helpers, the ORM and query builder, routing, events, and extensions — so they write idiomatic Glueful instead of guessing.
Compatible with Claude Code, Codex, Cursor, and any agent SDK that reads the skills convention.
Why
Glueful has its own conventions — most calls take an ApplicationContext, the ORM and router have their own APIs, and there are no static facades. Without guidance an AI assistant tends to guess: it invents methods that don't exist, or assumes a familiar-looking one shares a signature it doesn't. These skills encode the framework's real patterns so your assistant writes correct Glueful from the first try, instead of code you have to unwind.
Install
Universal (Claude Code, Codex, Cursor, …)
Uses the skills CLI to install into your agent's skills directory:
# All skills, universal install (writes to .agents/skills)
npx skills add glueful/skills --skill '*' --agent universal --yes
# Or target a specific agent
npx skills add glueful/skills --skill '*' --agent claude-code --yes
npx skills add glueful/skills --skill '*' --agent codex --yes
# Update later
npx skills update
Claude Code plugin
The repo is also a self-contained Claude Code plugin marketplace:
/plugin marketplace add glueful/skills
/plugin install glueful-skills@glueful-skills
What's included
| Skill | Use when |
|---|---|
using-glueful | Writing or modifying any PHP in a Glueful project — the baseline framework conventions every other skill builds on. |
glueful-architect-app | Deciding where code belongs — the layered controllers → DTOs → services → repositories/contracts → models map. |
glueful-add-controller | Building API endpoints — BaseController, reading/validating input, the authenticated-user context, the Response envelope. |
glueful-add-route | Registering & documenting routes — the fluent router, groups, attribute routing, middleware, and the OpenAPI docblocks that generate the spec/SDK. |
glueful-build-orm-query | Querying/persisting with the ORM — context-first Model statics, the Builder, eager loading, relations, N+1 safety, and result caching. |
glueful-build-validation-dto | Validating/normalizing request input — a final DTO + Validator rule map, ValidationException, and custom Rule classes. |
glueful-write-migration | Adding or changing schema — MigrationInterface + the schema builder, idempotency guards, a working down(), and the version-safe alterTable form. |
glueful-add-filter | List-endpoint filtering/sorting/search — a QueryFilter subclass with filterable/sortable/searchable allow-lists. |
glueful-add-event-listener-job | Side effects — define a BaseEvent, dispatch from a service, handle via a subscriber, and defer heavy work to a queued Job. |
glueful-write-test | Writing PHPUnit tests — the SQLite-backed Connection harness, mocking framework services, and the TDD loop. |
glueful-create-extension | Packaging an extension — the glueful-extension manifest, ServiceProvider, static services() DI, and the register()/boot() lifecycle. |
The glueful/skills repository is the canonical, always-current list. Skills target framework conventions and are updated when those conventions change between releases, so install from the repo to stay current.
Related
- Extensions — runtime packages you install into your app (distinct from these editor-time skills)
- Getting Started