Use kongctl with AI agent skills

kongctl includes skills for AI coding agents that work with Konnect resources from a repository. Skills give an agent product-specific instructions and workflows while kongctl remains the source of truth for schema discovery, planning, and execution.

Install the bundled skills into the project folder where you want to use kongctl with an agent.

You can preview the files and symlinks before writing them:

kongctl install skills --dry-run

Then, install the skills:

kongctl install skills

The installer writes skill files to .kongctl/skills/ and creates symlinks for supported agent tooling under .agents/skills/ and .claude/skills/.

kongctl comes bundled with the following skills.

kongctl-declarative

Use kongctl-declarative when you want an agent to help set up or maintain declarative configuration for Konnect. The skill helps an agent:

• Discover supported resource fields with kongctl explain.
• Generate starter YAML with kongctl scaffold.
• Create manifests for APIs, Dev Portals, control planes, and other supported resources.
• Integrate decK Gateway state through _deck.
• Generate API configuration from OpenAPI documents.
• Work through plan, diff, apply, sync, delete, and adopt workflows.
• Scaffold CI/CD workflows for declarative configuration.

kongctl-extension-builder

Use kongctl-extension-builder when you want an agent to help create, validate, or test a local kongctl CLI extension.

Always review agent-generated configuration before applying changes to Konnect. A typical workflow looks like this:

1. Install skills with kongctl install skills.
2. Ask the agent to use kongctl explain and kongctl scaffold before writing unfamiliar resources or fields.
3. Review the generated YAML in your repository.
4. Preview changes with kongctl diff --mode apply or kongctl plan.
5. Apply reviewed changes with kongctl apply or kongctl sync.

Warning: Use proper agent approvals and controls when deploying more advanced workflows with agents executing changes directly.

See the kongctl install skills command reference for the complete command syntax.