Skip to content

graphile-contrib/postgraphile-skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 

Repository files navigation

PostGraphile Agent Skills

A collection of agent skills for working with PostGraphile v5. These skills help AI coding agents (Claude, Cursor, Copilot, etc.) understand and implement PostGraphile v5 patterns correctly.

Skills

Skill Description
graphile-v5-presets Create and compose PostGraphile v5 presets
graphile-v5-minimal Create minimal setup without Node/Relay features
graphile-v5-inflection Customize GraphQL naming and inflection
graphile-v5-behaviors Control schema generation with the behavior system
graphile-v5-connection-filter Configure connection filtering
graphile-v5-plugins Create custom plugins with hooks
graphile-v5-debugging Debug schema generation issues

Why These Skills Exist

PostGraphile v5 is highly configurable with presets, plugins, behaviors, and inflectors. These skills document patterns for customizing PostGraphile v5 to match your project's needs, whether you're building a Relay-compatible API, a simple REST-like GraphQL API, or something in between.

Key Concepts

Presets

PostGraphile v5 uses a preset system for configuration. Presets can extend other presets, add plugins, disable plugins, and configure schema options.

Behaviors

The behavior system controls what gets generated in your GraphQL schema. Behaviors like single, update, delete, filterBy can be enabled or disabled at various levels.

Inflection

Inflectors control how PostgreSQL names become GraphQL names. Override inflectors to customize naming conventions.

Plugins

Plugins extend PostGraphile's functionality using hooks that run at build time.

Contributing

Contributions welcome! Please follow the Agent Skills specification when creating new skills. Each skill should be a folder containing a SKILL.md file with YAML frontmatter (name and description required) followed by markdown instructions.

License

MIT

About

PostGraphile Agent Skills

Resources

Stars

Watchers

Forks