feat: add Context7 AI coding skills for documentation navigation and SDK integration

[tinu-hareesswar]

Problem Statement

Developers using AI coding assistants to navigate the Hyperswitch documentation receive generic, often inaccurate guidance. The docs repository contains rich, well-structured content — but no machine-readable skill definitions exist to help AI assistants surface the right doc page for a given developer question.

The result: developers who ask an AI assistant "how do I set up intelligent routing?" or "where is the 3DS decision manager doc?" either receive hallucinated paths, outdated information from training data, or generic answers that don't reference the actual Hyperswitch documentation structure.

---

Proposed Solution

Add a .agents/skills/ directory with Context7-compatible skill files that:

1. Map developer questions to the correct documentation paths
2. Provide accurate summaries of each doc section
3. Include working code examples cross-referenced against the actual docs
4. Are automatically invoked by AI assistants when relevant questions are asked

These skills complement the main juspay/hyperswitch API skills — while those cover request/response formats, these cover documentation navigation, dashboard workflows, and SDK integration patterns.

---

Scope (8 skills across 5 categories)

integration/ — SDK integration guides

• 00-web-sdk-quickstart.md — React, vanilla JS, HTML checkout integration; server setup; loadHyper → HyperElements → confirmPayment
• 01-mobile-sdk.md — Android (Kotlin), iOS (Swift), React Native, Flutter

workflows/ — Feature workflow configuration

• 00-intelligent-routing.md — Auth rate, least cost, volume, rule-based routing; smart retries; self-hosted routing engine
• 01-3ds-and-authentication.md — 3DS Decision Manager; PSP-native, external, intelligence engine, import results, native mobile
• 02-vault-and-tokenization.md — Vault architecture options (Juspay, external, self-hosted); vault SDK; payment methods management SDK

connectors/ — Connector onboarding

• 00-activate-connector.md — Connector activation walkthrough; available connectors index; split payments

operations/ — Analytics and production

• 00-analytics-and-disputes.md — Analytics dashboard, data export, dispute management, fraud blocklist, surcharge
• 01-going-live.md — Pre-launch checklist, live API keys, production deployment options, MCP server setup

---

Impact

Once merged, developers with Context7-integrated AI assistants get accurate, doc-grounded answers to questions like:

• "How do I set up intelligent routing?" → routes to the correct dashboard workflow
• "Where is the React SDK integration guide?" → returns the actual file path and code
• "How do I handle 3DS on mobile?" → references native-3ds-authentication-for-mobile-payments.md

Install after merge:

npx ctx7 skills install /juspay/hyperswitch-docs

---

Future Roadmap

MASTER_SKILLS_LIST.md documents 28 additional planned skills covering: headless SDK, WooCommerce/Saleor plugins, split payments, payouts, self-hosting guides, and account management workflows.