feat: add Flash Trade perpetuals DEX skill

[Kaleb-Rupe]

Summary

Adds a comprehensive developer integration skill for Flash Trade, a perpetual futures DEX on Solana.

What's included:

• SKILL.md — Skill manifest with intent router, quick-start examples, and documentation map
• ApiReference.md — Complete REST API reference (28 endpoints, transaction builders, previews)
• SdkReference.md — TypeScript SDK guide (PerpetualsClient, positions, orders, composability)
• TransactionFlow.md — Build-sign-submit lifecycle with TypeScript, Python, and cURL examples
• WebSocketStreaming.md — Real-time position/order streaming via WebSocket
• McpIntegration.md — MCP server integration (flash-trade-mcp on NPM) for AI agents
• ProtocolConcepts.md — Domain knowledge (pools, custodies, markets, fees, oracles)
• ErrorReference.md — 69 error codes with causes and recovery patterns
• Workflows/ — Step-by-step guides for setup, querying data, building transactions, and managing positions
• examples/ — Quick-start examples (cURL, TypeScript, Python) and WebSocket bot patterns
• templates/ — Production-ready Python trading bot template

Integration paths covered: REST API (any language), TypeScript SDK (direct on-chain), MCP Server (AI agents), WebSocket (real-time monitoring)

Program IDs:

• Mainnet: FLASH6Lo6h3iasJKWDs2F8TkW2UKf3s15C8PMGuVfgBn
• Devnet: FTPP4jEWW1n8s2FEccwVfS9KCPjpndaswg7Nkkuz4ER4

Placement Note

We placed this as a top-level flash-trade/ directory alongside the existing skill/ directory. Happy to restructure if you'd prefer a different location (e.g., under skill/references/flash-trade/).

Test plan

• All markdown files render correctly on GitHub
• Code examples in TypeScript, Python, and cURL are syntactically valid
• SKILL.md intent router links resolve to correct reference files
• No modifications to existing skill/ directory or other files

🤖 Generated with Claude Code