AGENT SKILL

port-review

Review an existing SDK for idiomatic quality, consistency, and developer ergonomics. Use when asked to "review this SDK", "is our SDK idiomatic", or "assess SDK developer ergonomics".

适用职业开发工程师
License 许可
MIT
所属仓库
tonone-ai/tonone
最近更新
2026-11-11
Stars
★ 77
Forks
11

01 前言 Front Matter

name
port-review
tags
[ "devex", "sdk", "review" ]
author
tonone-ai <hello@tonone.ai>
license
MIT
version
1.6.0
description
Review an existing SDK for idiomatic quality, consistency, and developer ergonomics. Use when asked to "review this SDK", "is our SDK idiomatic", or "assess SDK developer ergonomics".
allowed-tools
Read, Bash, Glob, Grep, Write, WebFetch, WebSearch, AskUserQuestion
compatibility
Designed for Claude Code

02 资源文件 1

03 SKILL.md 正文

<!-- GENERATED from SKILL.md.tmpl by scripts/gen-skill-docs.py — edit the .tmpl or skills/_sections/*.md, not this file -->

Port Review

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

Read SDK source code in the target language. Check against idiomatic patterns for that language.

Step 2: Produce Output

Report: non-idiomatic patterns, inconsistencies with other language SDKs, missing error types, auth handling gaps, and recommended improvements.

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

Delivery

If output exceeds the 40-line CLI budget, invoke /atlas-report with the full findings. The HTML report is the output. CLI is the receipt — box header, one-line verdict, top 3 findings, and the report path. Never dump analysis to CLI.

04 同仓库更多 Skills