Claude Skills to build a destination

[abhandage]

This pull request introduces comprehensive documentation for the Destination Generator Skills, including a detailed README and a quick start guide. These documents explain how to use the suite of skills to automate the creation of Segment action-destinations from OpenAPI specs or website documentation, and how to generate TypeScript code, tests, and implementation notes. The new docs guide users through the workflow, outline best practices, and clarify what is automated versus what requires manual work.

Key documentation additions:

1. Core Documentation

• Added .claude/skills/README.md describing the overall workflow, purpose, and capabilities of the Destination Generator Skills, including detailed explanations for /openapi-analyze, /web-analyze, and /implement-destination commands, file structure, supported authentication schemes, tips, limitations, and future enhancements.

2. Quick Start Guide

• Added .claude/skills/QUICK_START.md as a concise, step-by-step guide with decision trees, command references, file location tables, and troubleshooting tips to help new users rapidly get started with the skills and understand the end-to-end process.

Testing

tested a datadog destination in this branch https://github.com/segmentio/action-destinations/tree/claude-skills-to-build-destination

Demo Recording here

• Added unit tests for new functionality
• Tested end-to-end using the local server
• [If destination is already live] Tested for backward compatibility of destination. Note: New required fields are a breaking change.
• [Segmenters] Tested in the staging environment
• [Segmenters] [If applicable for this change] Tested for regression with Hadron.

Security Review

Please ensure sensitive data is properly protected in your integration.

• Reviewed all field definitions for sensitive data (API keys, tokens, passwords, client secrets) and confirmed they use type: 'password'

New Destination Checklist

• Extracted all action API versions to verioning-info.ts file. example