juspay / juspay/hyperswitch-docs
feat: add Context7 AI coding skills for documentation navigation and SDK integration
- Dominant language
- No language data
- Stars
- 24
- Forks
- 37
- Avg merge
- 18h 45m
- Merged PRs (30d)
- 65
Description
## 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:
```bash
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.
Contributor guide
No contributing guide indexed for this repository
Assessment
This issue has not been assessed yet.