Claude Integration

Claude Code Integration

gqlcli ships with a ready-made skill definition for Claude Code. This lets Claude discover and drive the gqlcli binary automatically from your terminal.

Installing the Skill

The easiest way to install the skill is via the built-in command:\n

gqlcli install-skill

This command:

1. Locates your home directory
2. Creates ~/.claude/skills/gqlcli/ if it does not exist
3. Writes SKILL.md into that directory from the version embedded in the gqlcli binary

If the skill file already exists, install-skill is a no-op and prints a message indicating the existing location.

Skill Location

After running gqlcli install-skill, you should have:

~/.claude/skills/gqlcli/SKILL.md

Claude Code scans ~/.claude/skills/ for skills and uses the definitions to understand how to call tools from within your repo. The gqlcli skill teaches Claude:

• Where the gqlcli binary lives (relative to the project)
• How to invoke commands like query, mutation, batch, types, describe, login, and config
• How to work with .gqlcli.json environments and common usage patterns

Updating the Skill

When you upgrade gqlcli, you can re-run:

gqlcli install-skill

If the file already exists, it will not be overwritten. To force a fresh copy, remove the old file and rerun the command:

rm -f ~/.claude/skills/gqlcli/SKILL.md
gqlcli install-skill

More Details

For a deeper look at the skill contents, see the SKILL.md embedded in the repo under pkg/skill/SKILL.md. That file is what install-skill copies into your ~/.claude/skills/gqlcli/ directory.