Fähigkeiten openapi-to-typescript
📦

openapi-to-typescript

Inhaltsrevision r1 Sicher ⚙️ Externe Befehle

TypeScript aus OpenAPI-Spezifikationen generieren

API-Teams benötigen TypeScript-Modelle, die mit OpenAPI-Verträgen synchron bleiben. Dieser Skill konvertiert OpenAPI-3.0-Spezifikationen in Schnittstellen, Endpunkttypen und Runtime-Guards.

Unterstützt: Claude Codex Code(CC)
🥉 78 Bronze

Mit meinem Agent installieren

Kopieren Sie diese Anfrage in Ihren Agent. Sie enthält die maßgebliche Skill-Seite und das Manifest.

Agent-Anfrage
Review the Skillstore skill "openapi-to-typescript" from https://skillstore.io/skills/softaworks-openapi-to-typescript.md and its manifest at https://skillstore.io/api/skills/softaworks-openapi-to-typescript/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Ihr Agent sollte weiterhin seinen Plan anzeigen und alle von der Sicherheitsrichtlinie verlangten Bestätigungen anfordern.

Agent-lesbare Ressourcen

Verwenden Sie diese Links, wenn ein KI-Agent, Crawler oder Skript sauberen Kontext benötigt, statt die vollständige Seite zu lesen.

Markdown-Detailseite GET /skills/softaworks-openapi-to-typescript.md Signiertes manifest GET /api/skills/softaworks-openapi-to-typescript/manifest Signiertes lockfile GET /api/skills/softaworks-openapi-to-typescript/lockfile

Testen

„openapi-to-typescript“ wird verwendet. Eine OpenAPI-3.0-Produkatalogspezifikation mit Product- und Order-Schemas.

Erwartetes Ergebnis:

Eine TypeScript-Datei mit Product- und Order-Schnittstellen, Endpunkt-Anfrage- und Antworttypen, Type Guards und einem API-Fehlertyp.

„openapi-to-typescript“ wird verwendet. Eine Service-Spezifikation mit Enum-Feldern, Arrays und Pfadparametern.

Erwartetes Ergebnis:

Generierte Union-Typen für Enums, Array-Eigenschaftstypen, Pfadanfragetypen und Warnungen für nicht unterstützte Schemareferenzen.

„openapi-to-typescript“ wird verwendet. Ein ungültiges OpenAPI-Dokument, in dem der Abschnitt paths fehlt.

Erwartetes Ergebnis:

Eine Validierungsmeldung, die das fehlende Feld paths erklärt, ohne generierte Ausgabedatei.

Sicherheitsaudit

Sicher
v5 • 7.7.2026 Versionsbericht öffnen

All 58 static findings were adjudicated as false positives. The external command alerts came from Markdown backticks, inline identifiers, JSON examples, and TypeScript examples rather than executable shell or Ruby code. The system reconnaissance alerts matched type-checking examples and OpenAPI validation text, and no prompt-injection or exfiltration intent was found.

2
Gescannte Dateien
645
Analysierte Zeilen
0
Prüfelemente
0
Falschmeldungen ignoriert

Risikofaktoren

⚙️ Externe Befehle (54)
SKILL.md:24 SKILL.md:25 SKILL.md:27 SKILL.md:34-38 SKILL.md:38-48 SKILL.md:48 SKILL.md:49 SKILL.md:50 SKILL.md:51 SKILL.md:52 SKILL.md:58 SKILL.md:59 SKILL.md:60 SKILL.md:61 SKILL.md:62 SKILL.md:67-73 SKILL.md:73-76 SKILL.md:76-79 SKILL.md:79-82 SKILL.md:82-85 SKILL.md:85-88 SKILL.md:88-91 SKILL.md:91-94 SKILL.md:94-99 SKILL.md:99-105 SKILL.md:105-112 SKILL.md:112-116 SKILL.md:116-118 SKILL.md:118-132 SKILL.md:132-135 SKILL.md:135 SKILL.md:136 SKILL.md:140-142 SKILL.md:142-160 SKILL.md:160-163 SKILL.md:163-164 SKILL.md:164-170 SKILL.md:170-183 SKILL.md:183-186 SKILL.md:186-187 SKILL.md:187-188 SKILL.md:188-189 SKILL.md:189-190 SKILL.md:190-194 SKILL.md:194-211 SKILL.md:211-215 SKILL.md:215-216 SKILL.md:216-219 SKILL.md:219-223 SKILL.md:223-228 SKILL.md:228-261 SKILL.md:261-264 SKILL.md:264-335 SKILL.md:335-343
Das letzte abgeschlossene statische und semantische Audit erkannte keine bestätigten Sicherheitsbefunde. Dies beweist nicht, dass der Skill keine Nebenwirkungen hat.
Geprüft von: codex Audit-Verlauf anzeigen →
Diesen Bericht teilen & zitieren

Teile den versionierten Bewertungsbericht, das neutrale Badge, die Einbettungskarte und Zitate. Skillstore berichtet Nachweise, ohne zu entscheiden, ob dieser Skill sicher ist.

Versionsbericht öffnen
Sicherheitsbewertung

Berichtslink kopieren

https://skillstore.io/skills/softaworks-openapi-to-typescript/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown-Badge

[![Skillstore security assessment](https://skillstore.io/badges/skills/softaworks-openapi-to-typescript/security.svg)](https://skillstore.io/skills/softaworks-openapi-to-typescript?utm_source=security_passport_badge)

HTML-Badge

<a href="https://skillstore.io/skills/softaworks-openapi-to-typescript?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/softaworks-openapi-to-typescript/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Einbettungskarte

<iframe src="https://skillstore.io/embed/skills/softaworks-openapi-to-typescript.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
Wissenschaftliche Zitate (APA · BibTeX · CFF)

APA-Zitat

softaworks. (2026). openapi-to-typescript security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/softaworks-openapi-to-typescript/audits/5

BibTeX-Zitat

@techreport{softaworks-softaworks-openapi-to-typescript-2026, author = {softaworks}, title = {openapi-to-typescript security audit report (audit version 5)}, institution = {Skillstore}, year = {2026}, number = {5}, url = {https://skillstore.io/skills/softaworks-openapi-to-typescript/audits/5}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "openapi-to-typescript security audit report (audit version 5)" version: "unspecified" type: report authors: - name: "softaworks" date-released: "2026-07-07" url: "https://skillstore.io/skills/softaworks-openapi-to-typescript/audits/5" identifiers: - type: other value: "skillstore:softaworks-openapi-to-typescript:audit:5" description: "Skillstore immutable audit report identifier"

Skillstore-Score

Warum dieser Score Evidenzvertrauen: Hoch
55
Architektur
85
Wartbarkeit
87
Inhalt
71
Gemeinschaft
83
Spezifikationskonformität

Was Sie erstellen können

Frontend-API-Integration

Backend-OpenAPI-Spezifikationen in TypeScript-Verträge für UI-Datenabruf und Antwortverarbeitung konvertieren.

Gemeinsame Service-Verträge

Generierte Anfrage- und Antworttypen für Teams veröffentlichen, die interne APIs nutzen.

Antwortvalidierung in Tests

Generierte Type Guards verwenden, um API-Antworten in automatisierten Test-Workflows zu validieren.

Diese Prompts ausprobieren

Grundlegende Typen generieren 
Generiere TypeScript-Schnittstellen aus ./openapi.json und speichere sie in types/api.ts. Melde Validierungsfehler, bevor Dateien geschrieben werden.
Benutzerdefinierten Ausgabepfad verwenden 
Konvertiere ./specs/service.yaml in TypeScript-Anfrage-, Antwort- und Schematypen. Speichere das Ergebnis in src/generated/api-types.ts.
Neu generierte Typen vergleichen 
Generiere Typen aus ./openapi.yaml neu, vergleiche das Ergebnis mit src/types/api.ts und fasse alle Breaking Type Changes zusammen.
Komplexe Schemas behandeln 
Konvertiere ./api/openapi.yaml und prüfe oneOf, allOf, enums, arrays und nicht aufgelöste Referenzen. Markiere Bereiche, die eine manuelle Prüfung erfordern.

Bewährte Praktiken

  • Validiere die OpenAPI-Spezifikation vor der Generierung, um Vertragsfehler früh zu beheben.
  • Generiere Typen neu, wann immer sich die Quell-API-Spezifikation ändert.
  • Prüfe Warnungen zu unbekannten Typen, zirkulären Referenzen und komplexen allOf-Schemas.

Vermeiden

  • Bearbeite generierte Dateien nicht manuell, wenn die Quellspezifikation aktualisiert werden kann.
  • Behandle generierte Type Guards nicht als vollständige Validierung von Geschäftsregeln.
  • Ignoriere keine nicht aufgelösten Referenzen oder unbekannten Typen in der generierten Ausgabe.

Häufig gestellte Fragen

Welche OpenAPI-Versionen werden unterstützt?
Der Skill unterstützt OpenAPI 3.0.x. Er dokumentiert keine Unterstützung für Swagger 2.0 oder OpenAPI 3.1.
Generiert er einen vollständigen API-Client?
Nein. Er generiert Schnittstellen, Endpunkttypen, Type Guards und einen gemeinsamen API-Fehlertyp.
Kann er YAML- und JSON-Spezifikationen lesen?
Ja. Die Skill-Dokumentation gibt an, dass JSON- und YAML-OpenAPI-Dateien akzeptiert werden.
Wie werden Enums behandelt?
String-Enums werden in TypeScript-Union-Typen konvertiert, die die erlaubten Literal-Auswahlmöglichkeiten darstellen.
Was passiert, wenn die Spezifikation ungültig ist?
Der Skill meldet den Validierungsfehler und stoppt, bevor eine Ausgabe generiert wird.
Kann ich die Ausgabedatei auswählen?
Ja. Er fragt, wo das generierte TypeScript gespeichert werden soll, und verwendet types/api.ts als Standard.

Entwicklerdetails

Lizenz

MIT

Skillstore-Revision

r1

Versionshinweis

Der Autor hat keine Version angegeben.

Repository

https://github.com/softaworks/agent-toolkit/tree/main/skills/openapi-to-typescript/

Ref.

f93e9bb0daca99badb6a7e574b97737155d57cb3

Aktualität der Wartung

18.7.2026

Nutzung

7 Downloads · 269 Aufrufe

Dateistruktur

📄 README.md

📄 SKILL.md

Mehr von softaworks

Alle anzeigen

Ähnliche Skills

Alle anzeigen