Skip to content

LiorCohen/sdd / plugin/fullstack-typescript/skills/components/contract/contract-scaffolding

contract-scaffolding

Verified

Scaffolds OpenAPI contract component with type generation.

FileKindSize
SKILL.mdskill md5.6 KB
schemas/input.schema.jsonconfig646 B
schemas/output.schema.jsonconfig1.4 KB
templates/openapi.yamlconfig2.0 KB
templates/package.jsonmanifest333 B

templates/openapi.yaml

View on GitHub
openapi: 3.0.3
info:
  title: {{PROJECT_NAME}} API
  version: 1.0.0
  description: API specification for {{PROJECT_NAME}}

servers:
  - url: /api/v1
    description: API v1

paths:
  # NOTE: Health check endpoints (/health, /readiness, /liveness) are NOT defined here.
  # They are infrastructure endpoints implemented directly in the controller.
  #
  # Add your API endpoints here as features are implemented.
  # Example:
  # /users:
  #   post:
  #     operationId: createUser
  #     ...

components:
  schemas:
    # Add your domain schemas here as entities are defined.
    # Example:
    # User:
    #   type: object
    #   required:
    #     - id
    #     - email
    #   properties:
    #     id:
    #       type: string
    #     email:
    #       type: string

    Error:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: Error code
        message:
          type: string
          description: Human-readable error message
        details:
          type: object
          description: Additional error details

  responses:
    BadRequest:
      description: Invalid request
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                $ref: '#/components/schemas/Error'

    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                $ref: '#/components/schemas/Error'

    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                $ref: '#/components/schemas/Error'

    InternalError:
      description: Internal server error
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                $ref: '#/components/schemas/Error'
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall