Northflank agent skills extend your AI coding assistant with domain-specific knowledge about Northflank. Instead of your agent having only general programming knowledge, it understands Northflank's architecture, APIs, CLI commands, and best practices.
When you work with an agent on Northflank infrastructure, the skill enables the agent to make informed decisions about deployments, configurations, and architecture patterns specific to Northflank.
How Northflank agent skills work
Northflank agent skills are markdown files that contain structured knowledge about a platform. They include:
- Conceptual guidance on how Northflank works
- Step-by-step instructions for common tasks
- API and CLI references
- Best practices and patterns
- Examples of deployments and configurations
When you ask your AI agent to do something with Northflank, like deploy a service, create a database, or write infrastructure-as-code, the agent reads the skill and understands the context, capabilities, and constraints of Northflank. This lets the agent make better decisions without you having to explain Northflank every time.
Install Northflank agent skills
Northflank agent skills are installed into your AI code editor. The installation process depends on which editor you use.
Claude Code
From inside an interactive Claude Code session:
/plugin marketplace add northflank/skills
/plugin install northflank@northflank
Or from your terminal using the Claude CLI:
claude plugin marketplace add northflank/skills
claude plugin install northflank@northflank
northflank/skills is the GitHub shorthand for github.com/northflank/skills. Claude Code resolves it to the marketplace at the repo root. Pass a full URL (https://github.com/northflank/skills) if you prefer to be explicit.
OpenAI Codex
Install using Codex's built-in skill installer:
$skill-installer https://github.com/northflank/skills/tree/master/skills/northflank
Skills CLI
Install using the Skills CLI, which supports Codex, Claude Code, Cursor, OpenCode, and other coding agents:
npx skills add northflank/skills --global
Manual installation
If your editor supports loading skills from a directory, copy skills/northflank into the appropriate skills directory:
| Editor | Skill directory |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
| OpenCode | ~/.config/opencode/skills/ |
| OpenAI Codex | ~/.codex/skills/ |
| Windsurf | ~/.windsurf/skills/ |
Use Northflank agent skills
After installation, ask your coding agent to do Northflank work directly. The skill should load automatically when the task involves Northflank projects, services, jobs, addons, preview environments, release workflows, AI sandboxes, GPU workloads, domains, secrets, templates, or the Northflank API and CLI.
Examples:
- "Deploy this service to Northflank from
ghcr.io/acme/api:latest" - "Create a preview environment for this branch on Northflank"
- "Set up a Postgres addon and wire its credentials into my service"
- "Help me write a Northflank template for this stack"
- "Use the Northflank CLI to exec into this service and triage this issue"
- "Show me how to deploy this workload to a GPU node pool on Northflank"