Agent Skills

PostKit ships with agent skills — reusable instruction sets that teach AI coding assistants (Claude Code, Cursor, Codex, etc.) how to work with PostKit workflows. Skills follow the Agent Skills open standard.

Available Skills

Skill	Invoke	When It Triggers
postkit-migrate	/postkit-migrate	Database migrations, deploys, schema diffs
postkit-setup	/postkit-setup	Project init, config, remotes setup
postkit-schema	/postkit-schema	Editing db/schema/ files
postkit-auth	/postkit-auth	Keycloak, auth config, SSO

Install Skills

Use the skills CLI to install PostKit skills into your project:

# Install all PostKit skills (interactive)
npx skills add appritechnologies/Postkit

# List available skills first
npx skills add appritechnologies/Postkit --list

# Install specific skills only
npx skills add appritechnologies/Postkit --skill postkit-migrate --skill postkit-schema

# Install for a specific agent (e.g., Claude Code)
npx skills add appritechnologies/Postkit -a claude-code

# Non-interactive (CI/CD friendly)
npx skills add appritechnologies/Postkit --all -y

Scope

Scope	Flag	Location	Use Case
Project (default)		./<agent>/skills/	Committed with your project, shared with team
Global	-g	~/<agent>/skills/	Available across all your projects

By default, skills are symlinked — a single source of truth that's easy to update. Use --copy for independent copies when symlinks aren't supported.

Update Skills

# Update all installed skills
npx skills update

# Update a specific skill
npx skills update postkit-auth

Supported Agents

PostKit skills work with any agent that supports the Agent Skills standard, including:

Agent	--agent flag
Claude Code	claude-code
Cursor	cursor
Codex	codex
Cline	cline
Gemini CLI	gemini-cli
GitHub Copilot	github-copilot
Windsurf	windsurf
Roo Code	roo

The npx skills add CLI auto-detects which agents you have installed. See the full list of supported agents.