sdd
genkovich/sdd
Generates API contracts and integration specifications based on upstream architectural and data models, including automatic drift detection and reconciliation.
97 32MITUpdated 2026-08-08
82
GreatOverview
This skill analyzes project artifacts like data models, sequence diagrams, and specifications to automatically derive interface contracts such as OpenAPI definitions, gRPC protocols, CLI surfaces, or event streams. It performs bidirectional drift checks to ensure alignment between the interface, data model, and user stories, while identifying gaps and handling reconciliation processes without manual boilerplate generation.
Capabilities
- ▸Interface contract generation (OpenAPI, gRPC, CLI, public API, events)
- ▸Bidirectional drift check against architectural and specification models
- ▸Automatic derivation of error responses from sequence diagram branches
- ▸Idempotency and retry pattern enforcement for asynchronous flows
- ▸Upstream gap detection and reporting
Best for
Generating OpenAPI 3.1 specifications from feature data models and sequence diagrams, Detecting drift between implemented API contracts and upstream design documentation, Creating gRPC, CLI, library, or event-driven interface specifications based on project surfaces
Works with
Claude CodeCursorGitHub Copilot
Evoa Score breakdown= Σ (score × weight)
82Task usefulness20%88 → +17.6
実タスクにどれだけ役立つか（機能の豊富さ・用途の明確さ）。 — AIによるcapabilities/use-cases解析
Code quality15%90 → +13.5
実装・指示の品質。 — AIによるSKILL.md/README解析
Maintenance15%100 → +15.0
リポジトリがどれだけ活発に保守されているか。 — GitHub 最終push日時の新しさ
Documentation12%37 → +4.4
ドキュメントの充実度・分かりやすさ。 — README/独自要約の情報量
Security15%100 → +15.0
危険・不審な挙動が無いか。 — AIによるセキュリティレビュー
Originality10%85 → +8.5
ありふれたラッパーではない独自性。 — AIによる独自性判定
Popularity8%55 → +4.4
コミュニティの採用度。 — GitHub Stars/Forks（対数スケール）
Compatibility5%75 → +3.8
対応AIエージェントの広さ。 — AIによる対応エージェント判定
Weighted total82.2 / 100
ライセンス不明/制限あり（Red）のSkillは総合スコアに0.85倍の補正を適用します。 ランキングはこのScoreのみで決まり、広告で変わりません。 算出方法の詳細 →
Security considerations
Ensures placeholder values are used in generated examples rather than real PII, and identifies authorization branches during sequence analysis.
Categories
Summary and analysis are original content generated by AI Skills Rank. The skill's source text is not reproduced here — view it on the linked repository.