An open API service indexing awesome lists of open source software.

https://github.com/constructive-io/postgraphile-skills


https://github.com/constructive-io/postgraphile-skills

Last synced: 4 months ago
JSON representation

Awesome Lists containing this project

README

          

# 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](skills/graphile-v5-presets/) | Create and compose PostGraphile v5 presets |
| [graphile-v5-minimal](skills/graphile-v5-minimal/) | Create minimal setup without Node/Relay features |
| [graphile-v5-inflection](skills/graphile-v5-inflection/) | Customize GraphQL naming and inflection |
| [graphile-v5-behaviors](skills/graphile-v5-behaviors/) | Control schema generation with the behavior system |
| [graphile-v5-connection-filter](skills/graphile-v5-connection-filter/) | Configure connection filtering |
| [graphile-v5-plugins](skills/graphile-v5-plugins/) | Create custom plugins with hooks |
| [graphile-v5-debugging](skills/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](https://agentskills.io/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