convez.ai
SkillDesenvolvimento WebIntermediário
glueful

Glueful Skills

glueful/skills

Skills para dominar Glueful e evitar padrões Laravel

Ver no GitHub
InicialPluginScore · de 0 a 100

Conjunto 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/skills

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
62%
Último commit
há 3 semanas
Versão
—
Issues abertas
0
Contribuidores
2

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

SkillUse when
using-gluefulWriting 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-appDeciding 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-migrationAdding or changing database schema — MigrationInterface + the schema builder, idempotency guards, a working down(), and the version-safe alterTable form.
glueful-add-controllerBuilding API endpoints — BaseController, reading/validating input, the authenticated-user context, and the Response envelope.
glueful-add-routeRegistering & 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-testWriting PHPUnit tests — the SQLite-backed Connection harness, mocking framework services, ApplicationContext/cache/JWTService setup, and the TDD loop.
glueful-build-orm-queryQuerying/persisting with the ORM — context-first Model statics, the Builder, eager loading, relations, N+1 safety, and query result caching.
glueful-add-filterList-endpoint filtering/sorting/search — a QueryFilter subclass (filterable/sortable/searchable allow-lists), custom filter{Field}() methods, and safe public filtering.
glueful-add-event-listener-jobSide effects — define a BaseEvent, dispatch from a service, handle via an EventSubscriberInterface subscriber, and defer heavy work to a queued Job.
glueful-build-validation-dtoValidating/normalizing request input — a final DTO + Validator rule map, ValidationException, building from sanitized filtered() values, and custom Rule classes.
glueful-create-extensionPackaging 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

Ver o original no GitHub

Bom para

Relacionados