port-blueprints

port-blueprints is a skill for Claude Code from port-labs/port-skills. It costs 87 tokens per session (2,109 once invoked), scanned A, original, MIT.

A reference for defining Port blueprints, which are schemas for kinds of objects such as services, packages, or clusters. It covers their fields, relationships, and calculated or copied values.

In plain words
What is it for?
Use it to create blueprints, add typed properties, connect object types, or define calculation, mirror, and aggregation properties.
Why use it?
It provides the JSON and API details needed to create or change a Port data model consistently.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions Claude Code; mentions Codex.

Part of the port-skills plugin — 10 skills, 1 command, 2 MCP servers shipped together

Good fit Use it to create blueprints, add typed properties, connect object types, or define calculation, mirror, and aggregation properties.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/port-labs/port-skills/port-blueprints
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add port-labs/port-skills --skill port-blueprints
Clone the repo
git clone --depth 1 https://github.com/port-labs/port-skills

Made for: Claude Code.

Or install port-skills, the plugin that ships this one along with the rest of its 10 skills, 1 command, 2 MCP servers.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for port-blueprints

README.md
[![agentmods](https://agentmods.dev/badge/skills/port-labs/port-skills/port-blueprints/github.svg)](https://agentmods.dev/skills/port-labs/port-skills/port-blueprints)
Your own site
<a href="https://agentmods.dev/skills/port-labs/port-skills/port-blueprints"><img src="https://agentmods.dev/badge/skills/port-labs/port-skills/port-blueprints/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for port-blueprints

Your own site · 80×15
<a href="https://agentmods.dev/skills/port-labs/port-skills/port-blueprints"><img src="https://agentmods.dev/badge/skills/port-labs/port-skills/port-blueprints.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 87 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,109 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00087 $0.02109
Opus 5 $0.00044 $0.01055
Sonnet 5 $0.00017 $0.00422
Haiku 4.5 $0.00009 $0.00211

Measured 12d ago against content hash dadc5d293a03, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

port-blueprints scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -L -X POST 'https://api.port.io/v1/blueprints' \
skills/port-blueprints/SKILL.md · 162 lines

How it starts

The opening of the file, as written. The whole thing — 162 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Port blueprints

A blueprint is Port's schema primitive. It defines a type of asset in the context lake (a service, a package, a cluster, anything), the properties that describe it, and how it relates to other blueprints. Every entity in Port's context lake is an instance of a blueprint, the same way a database row is an instance of a table schema.

Use this skill when

Use this skill to design or edit a Port data model: creating a new blueprint, adding or typing a property, relating two blueprints, or adding a calculation, mirror, or aggregation property. It is reference-only, built from the static blueprint JSON schema and the raw Port API, so it works without a live Port account or Port MCP server connected. Without credentials it still produces valid blueprint JSON the user can apply later.

Out of scope: workflows (port-workflows), scorecards (port-scorecards), integration mapping (port-integrations), the Terraform/Pulumi provider reference (port-terraform, pointed to in Step 6), and deciding what to model and how blueprints should relate at the data-model-design level (port-context-lake owns that; this skill is the JSON mechanics it points to).

Prerequisites

  • Go over the port-getting-started skill first if this is your first time working with Port.
  • To apply changes without MCP: a CLIENT_ID/CLIENT_SECRET pair (... menu > Credentials in the Port app), exchanged for a bearer token at POST https://api.port.io/v1/auth/access_token.
  • If Port's MCP server is connected, this skill can use it to read the current blueprint (list_blueprints) and apply the result directly (upsert_blueprint) instead of you copying JSON in by hand; the raw API calls below always work as a fallback. Search search_port_knowledge_sources for anything this skill doesn't cover.

Step 1 - Check whether the blueprint already exists

Precondition: you have a bearer token. Action: GET /v1/blueprints/<identifier>. 200 means it exists, edit it instead of duplicating it. 404 means it's safe to create. Fallback: no credentials yet. Draft the JSON and tell the user to verify uniqueness before applying it.

Read the full file on GitHub · 162 lines

Files

What ships with it

6 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 162 lines · 87 tokens per session scan A dadc5d293a03

Subscribe to this mod's changes

port-blueprints is a skill published in the GitHub repository port-labs/port-skills (3 stars, last pushed 10d ago), licensed MIT. It adds 87 tokens to every session and 2,109 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

backend-patterns

Guides backend service architecture — layering, N+1 query prevention, caching, retries, rate limiting, and background job processing, in Go primarily and TypeScript/PHP where the pattern is language-agnostic. Use when structuring handler/service/repository layers, reviewing a service for N+1 queries, adding a cache in…

shennawardana23/skillme · 88 tokens

erd-expert

Designs entity-relationship schemas for the hotel domain (reservations, guests, rooms, rate plans, folios) on PostgreSQL, following Archipelago International's Sentec platform conventions — hotelid LIST partitioning, naming, and required audit columns. Use when designing a new table or ERD for Sentec PMS, Sentec…

shennawardana23/skillme · 100 tokens

mysql-patterns

Guides MySQL/MariaDB query design, indexing strategy, data types, and concurrency patterns — the InnoDB-specific counterpart to postgres-patterns. Use when choosing a primary key strategy, picking a charset, writing an UPSERT, deciding on isolation level, or porting a query pattern from PostgreSQL to MySQL/MariaDB (or…

shennawardana23/skillme · 85 tokens

postgres-patterns

Guides PostgreSQL query design, indexing strategy, data types, and row-level security patterns — the query/schema layer, as distinct from the migration-execution safety covered by database-migrations and the hotelid partition-pruning rules covered by postgres-hotel-partitioning. Use when choosing an index type…

shennawardana23/skillme · 95 tokens

golang-database

This skill should be used when the user asks to "configure a Go database connection pool", "use database/sql in Go", "set up pgxpool", "why is my Go app running out of connections", "scan rows into a Go struct", "handle sql.ErrNoRows", or writes Go code that opens, pools, queries, or scans a PostgreSQL/MySQL…

shennawardana23/skillme · 160 tokens

raw-sql-querybuilder-testing-patterns

Guides Go services that use database/sql directly with a lightweight in-house query builder (not an ORM like GORM or a codegen tool like sqlc), including how to make repositories unit-testable via mock-generated interfaces. Use when writing or reviewing a repository method built on database/sql, adding a new…

shennawardana23/skillme · 87 tokens