Glueful Skills
glueful/skills
Skills para dominar Glueful e evitar padrões Laravel
Ver no GitHubConjunto de skills para ensinar a assistentes de IA as convenções reais do framework PHP Glueful, evitando alucinações de APIs Laravel. Inclui guias instaláveis para ApplicationContext, ORM, roteamento, migrations, testes e muito mais. Compatível com Claude Code, Codex e SDKs similares.
Instalação
npx convez-ai glueful/skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Assistir na escrita de controllers, modelos e rotas em projetos Glueful
- Gerar migrations de banco de dados idempotentes
- Construir queries ORM seguras sem N+1
- Escrever testes PHPUnit com harness SQLite
- Documentar e arquitetar aplicações em camadas (controllers → DTOs → services → repositories → models)
Veredito

Skill altamente especializada e prática para quem trabalha com Glueful. Resolve um problema real — evitar que LLMs caiam na armadilha de gerar código Laravel em projetos Glueful — com documentação clara e modular. Recomendado para equipes que usam esse framework específico.
README
A tradução para o português deste README ainda está na fila.
Glueful Skills
Coding-assistant skills for building with the Glueful PHP framework. Installable guides that teach LLMs Glueful's real conventions — ApplicationContext, the framework helpers, the ORM and query builder, routing, events, and extensions — and stop them from hallucinating Laravel-style APIs. Compatible with Claude Code, Codex, and similar agent SDKs.
Why
Glueful is not Laravel. The most common failure mode for an AI assistant working in a Glueful codebase is reaching for a Laravel API that doesn't exist (DB::transaction(), Model::create(), facades, php artisan, Blade). These skills encode the framework's actual patterns so assistants write idiomatic Glueful instead of guessing.
Install
Universal (Claude Code, Codex, Cursor, and others) — via the skills CLI
# 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 — as a plugin
This repo is also a self-contained Claude Code plugin marketplace:
/plugin marketplace add glueful/skills
/plugin install glueful-skills@glueful-skills
Skills
| Skill | Use when |
|---|---|
using-glueful | Writing or modifying any PHP in a Glueful project — controllers, models/ORM, routes, middleware, events, services, extensions, migrations. The baseline "this is not Laravel" conventions. |
glueful-architect-app | Deciding where code belongs in a non-trivial app — the layered map (controllers → DTOs → services → repositories/contracts → models), events/listeners/jobs, filters, app DI wiring, and extension reuse. The composition anchor for the slice skills. |
glueful-write-migration | Adding or changing database schema — MigrationInterface + the schema builder, idempotency guards, a working down(), and the version-safe alterTable form. |
glueful-add-controller | Building API endpoints — BaseController, reading/validating input, the authenticated-user context, and the Response envelope. |
glueful-add-route | Registering & documenting routes — the fluent router, groups, attribute routing, middleware, builder-form rate limiting, and OpenAPI docs via the reflect generator (typed #[ApiOperation]/#[QueryParam]/#[ApiResponse] attributes + RequestData/ResponseData DTOs; framework ≥ 1.57.0). |
glueful-write-test | Writing PHPUnit tests — the SQLite-backed Connection harness, mocking framework services, ApplicationContext/cache/JWTService setup, and the TDD loop. |
glueful-build-orm-query | Querying/persisting with the ORM — context-first Model statics, the Builder, eager loading, relations, N+1 safety, and query result caching. |
glueful-add-filter | List-endpoint filtering/sorting/search — a QueryFilter subclass (filterable/sortable/searchable allow-lists), custom filter{Field}() methods, and safe public filtering. |
glueful-add-event-listener-job | Side effects — define a BaseEvent, dispatch from a service, handle via an EventSubscriberInterface subscriber, and defer heavy work to a queued Job. |
glueful-build-validation-dto | Validating/normalizing request input — a final DTO + Validator rule map, ValidationException, building from sanitized filtered() values, and custom Rule classes. |
glueful-create-extension | Packaging an extension — the glueful-extension composer manifest, ServiceProvider, static services() DI, and the register()/boot() lifecycle. |
Further surfaces (resources, CLI commands, webhooks, uploads, seeders, API versioning) are intentionally deferred until real usage proves they recur — a skill earns its place by frequency × surprise, not coverage for its own sake.
Each skill is plain Markdown (SKILL.md with name + description frontmatter), so it works with any agent SDK that reads the skills convention. New task-scoped skills follow a glueful-<verb>-<noun> naming pattern and should be verified against the framework source before merging — see Versioning & accuracy.
Versioning & accuracy
Skills target framework conventions, which can change between releases. When the framework changes a convention (e.g. a method signature or a default), the affected skill must be updated — stale guidance spreads wrong patterns. Each skill notes the framework version where version-sensitive behavior applies. Issues and PRs welcome.
License
MIT © Glueful