smartsheet-sdk-tests: Skill for Claude Code

Creating WireMock Mappings for Smartsheet SDK

Overview

Generate comprehensive WireMock mapping files for Smartsheet API endpoints based on OpenAPI specifications. This skill ensures systematic endpoint discovery, deprecated endpoint exclusion, and accurate schema-based mock generation.

Core principle: Never guess API schemas. Always derive mappings from OpenAPI specification.

When to Use

Use this skill when:

• Creating WireMock mappings for Smartsheet SDK tests
• Adding test coverage for new Smartsheet API endpoints
• Working with endpoint groups (users, workspaces, sheets, etc.)
• User provides local or remote OpenAPI specification
• Generating mock API responses for testing

Do NOT use for:

• Reviewing existing mappings (use review-wiremock-mappings skill)
• Non-Smartsheet API mocking
• Manual API testing without SDK context

Required Inputs

User MUST provide:

• Endpoint group name (e.g., "users", "workspaces", "contacts")
• OpenAPI specification source:
  • Remote URL: https://developers.smartsheet.com/_spec/api/smartsheet/openapi.json
  • Local file path: e.g., ./specs/contacts-openapi.json

Additional references:

• CONTRIBUTING.md - WireMock mapping conventions
• Project-specific test patterns and examples

Workflow

digraph create_workflow {
    "Start" [shape=doublecircle];
    "Verify OpenAPI spec source" [shape=box];
    "Has local spec?" [shape=diamond];
    "Use local file" [shape=box];
    "Use remote URL" [shape=box];
    "Discover endpoints by tag" [shape=box];
    "Check for deprecated endpoints" [shape=box];
    "Has deprecated?" [shape=diamond];
    "Document exclusions" [shape=box];
    "Parse endpoint schemas" [shape=box];
    "Generate mappings from spec" [shape=box];
    "Verify against checklist" [shape=box];
    "Complete" [shape=doublecircle];

    "Start" -> "Verify OpenAPI spec source";
    "Verify OpenAPI spec source" -> "Has local spec?";
    "Has local spec?" -> "Use local file" [label="yes"];
    "Has local spec?" -> "Use remote URL" [label="no"];
    "Use local file" -> "Discover endpoints by tag";
    "Use remote URL" -> "Discover endpoints by tag";
    "Discover endpoints by tag" -> "Check for deprecated endpoints";
    "Check for deprecated endpoints" -> "Has deprecated?";
    "Has deprecated?" -> "Document exclusions" [label="yes"];
    "Has deprecated?" -> "Parse endpoint schemas" [label="no"];
    "Document exclusions" -> "Parse endpoint schemas";
    "Parse endpoint schemas" -> "Generate mappings from spec";
    "Generate mappings from spec" -> "Verify against checklist";
    "Verify against checklist" -> "Complete";
}