@port-labs/port-skills
v1.0.9
Published
Port's public Agent Skills, installable as an npm package or as a Claude Code / Cursor plugin.
Readme
Port Agent Skills
Give your coding agent the skills of a platform engineer to help build your agentic SDLC platform. These skills cut the time it takes to model your infrastructure, build workflows, and govern access in Port, and make your coding agent smarter about your organization.
Point your agent at Port and ask it to build the thing. Some examples:
- Model your engineering knowledge — turn your services, environments,
and teams into a connected context lake your agent and your whole org can
query. (
port-blueprints,port-context-lake) - Automate the busywork around shipping software — self-service
requests, approvals, and automated reactions to what happens in your
catalog, instead of chasing people in Slack. (
port-workflows) - Give every team visibility and control — dashboards that show what's
actually happening, without a spreadsheet. (
port-dashboards) - Govern who can see and do what — RBAC across your catalog and pages,
defined once. (
port-permissions) - Keep your catalog in sync with the tools you already use — configure
and troubleshoot how data flows in. (
port-integrations) - Manage your whole Port setup as code — version-controlled,
repeatable, reviewable. (
port-terraform)
New to Port? Start with port-getting-started to connect your agent to
Port's MCP server first.
Skills
| Skill | What it does |
|---|---|
| port-blueprints | Model your context lake with Port blueprints, properties, and relations. |
| port-context-lake | Design a Port context lake with connected blueprints and semantic relations. |
| port-create-custom-oauth-app | Register an OAuth app for a custom UI and wire up PKCE login. |
| port-dashboards | Build Port dashboard pages with widgets, layout, and permissions. |
| port-getting-started | Sign up for Port and connect its MCP server to your coding agent. |
| port-integrations | Configure and troubleshoot Port integration mapping. |
| port-permissions | Configure Port's RBAC across the context lake and pages. |
| port-terraform | Manage Port resources as code with the Terraform provider. |
| port-workflows | Build Port workflows with triggers, action nodes, and conditions. |
Install
Using the skills CLI:
npx skills add port-labs/port-skills --skill port-workflowsOr clone the repo and copy the skill you want into your agent's skill directory:
git clone https://github.com/port-labs/port-skills /tmp/port-skills
cp -r /tmp/port-skills/skills/port-workflows ~/.claude/skills/
rm -rf /tmp/port-skillsCursor: ~/.cursor/skills. GitHub Copilot: ~/.copilot/skills. Both
user-level and project-level (.claude/skills, .cursor/skills) paths work.
Claude Code plugin
This repo also ships as a Claude Code plugin,
bundling every skill above plus the Port MCP server
(both port-eu and port-us regional servers) in one install:
/plugin marketplace add port-labs/port-skills
/plugin install port-skillsCursor plugin
The repo also ships as a Cursor plugin, bundling every skill above plus the Port MCP server for Cursor:
Install from the Cursor Marketplace:
- Open Cursor Settings → Plugins
- Search for Port MCP
- Click Install
Or paste the plugin reference in Cursor Settings → Plugins:
portAfter installing, run /setup-region to configure your Port MCP server region (EU or US).
Contributing
See port-skill-creator for the skill format,
authoring conventions, and how to validate a new skill before opening a PR.
See TESTING.md for how to load and exercise the plugin locally
before submitting changes.
Learn more
- docs.port.io, Port's product documentation
- Port MCP server
- Agent Skills specification
