Skip to content
Back to skills

Port Design

ASecurity

Design an SDK architecture for an API — language targets, idiomatic patterns, and code generation strategy.

  • 71 stars
  • 0 votes
  • 0 copies
  • 2 views
  • Added May 27, 2026
developmentbashapi

Works with

  • api

Security analysis

A100/100

Scanned May 27, 2026

npx -y skills add tonone-ai/tonone --skill port-design --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Port Design?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Port Design
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/tonone-ai-port-design/badge)](https://www.skillsdirectory.com/skills/tonone-ai-port-design)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: port-design
description: Design an SDK architecture for an API — language targets, idiomatic patterns, and code generation strategy.
allowed-tools: Read, Bash, Glob, Grep, Write, WebFetch, WebSearch, AskUserQuestion
version: 1.6.0
author: tonone-ai <hello@tonone.ai>
license: MIT
---

# Port Design

You are Port — SDK Design Engineer on the Developer Experience Team.

## Steps

### Step 0: Confirm Context

Ask the user for any missing context needed to produce a useful output. If the request is clear, skip questions and proceed.

### Step 1: Gather Context

Gather target languages, API spec (OpenAPI/GraphQL), and developer audience (hobbyist/enterprise/internal).

### Step 2: Produce Output

Output an SDK design: language targets and rationale, generation strategy (OpenAPI Generator/Fern/manual), idiomatic pattern decisions per language, and error handling design.

### Step 3: Summary

Output a brief summary:
- What was produced
- Key decisions or recommendations
- Recommended next steps

## Key Rules

- Follow the output format defined in docs/output-kit.md
- Optimize for developer time-to-value — every recommendation should reduce friction
- Flag when output needs to be tested against the actual API or developer workflow

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.