Skip to main content

Coshine AI Skills

Ready-to-install Claude Code Skills that guide AI developer tools (Claude Code, Claude Desktop, and compatible tools) through integrating with Coshine EastPay APIs.

A Skill is a bundle of protocol knowledge, field dictionaries, flow descriptions, and behavior rules that lets an AI tool generate correct integration code in any language, without the developer having to first read the full API docs.

Available Skills (MVP)​

SkillPurposeDownload
card-issuingEntry point — intent routing to the other skillscard-issuing.zip
card-issuing-authAuthentication (Bearer + timestamp, plain JSON) and future OAuth2/JWE migration pathcard-issuing-auth.zip
card-issuing-quickstartEnd-to-end 3-step minimum loop (CardApplication → CustomerCardInfoInquiry → CardActivation)card-issuing-quickstart.zip
card-issuing-referencesKnowledge base: public headers, data dictionary, error codes, endpoints catalog, sample JSON payloadscard-issuing-references.zip
All-in-one bundleAll 4 skills + installer in a single zipcoshine-skills-all.zip

Supported AI Dev Tools​

These skills work out of the box with:

ToolInstall path
Claude Code~/.claude/skills/<name>/
Gemini CLI~/.agents/skills/<name>/ (shared standard)
OpenAI Codex CLI~/.agents/skills/<name>/ (shared standard)

The SKILL.md format (markdown + name / description YAML frontmatter) is identical across all three. Each skill also ships agents/openai.yaml to enable implicit activation on Codex.

Installation​

Option 0 — Claude Code plugin marketplace (recommended)​

In Claude Code, add this repo as a plugin marketplace and install the plugin:

/plugin marketplace add jacobxu1972/issuingskills          # public mirror on GitHub
# or, from inside your corporate network:
/plugin marketplace add ssh://<you>@gitblit.sandbox.efaka.net:29418/docs/coshine-developer.git

/plugin install coshine-card-issuing@coshine-plugins

You'll get all 4 skills, /plugin update handles future upgrades, and /plugin shows them in the UI.

Option 1 — Download zip (no git required)​

  1. Download coshine-skills-all.zip (or a single skill zip) above.
  2. Unzip anywhere, e.g. ~/coshine-skills/.
  3. Run the installer — one of: 
    cd ~/coshine-skills
    bash scripts/install_skills.sh                 # both Claude and Gemini/Codex
    bash scripts/install_skills.sh --claude-only   # only ~/.claude/skills/
    bash scripts/install_skills.sh --agents-only   # only ~/.agents/skills/ (Gemini/Codex)
  4. Restart your AI tool (Claude Code / Gemini CLI / Codex CLI) to pick up the skills.

The installer creates symlinks from the unzipped skills/*, so future updates are as simple as overwriting the unzipped folder.

Option 2 — Clone the repository (recommended for easy updates)​

git clone ssh://<your-user>@gitblit.sandbox.efaka.net:29418/docs/coshine-developer.git
cd coshine-developer
bash scripts/install_skills.sh

To update later:

cd coshine-developer && git pull
# Installed skills are symlinks — they pick up changes instantly.

What's inside each Skill​

Each skill is a directory containing a SKILL.md (the skill entry point consumed by AI tools) plus optional supporting .md and sample JSON files. The content is language-agnostic: the skill describes the HTTP protocol, field semantics, and flow — it does not ship code templates for a specific language. Developers can ask their AI tool to generate the code in whatever stack they use (Java, Python, Node.js, Go, etc.).

Scope — MVP (v0.1)​

The MVP covers the 3-API minimum integration loop for virtual card issuing:

  1. POST /cardmgr/cardApply — apply for a card → get cardToken
  2. POST /custmgr/inquiryCardListByCIF — look up cards by customer ID
  3. POST /cardmgr/cardActivate — activate the card

Additional APIs (card lifecycle operations, transactions, PIN, tokens, loyalty, etc.) will arrive in Phase 1 P1 and Phase 2 releases.

Feedback​

Found an issue in a Skill, or want additional API coverage? Contact your Coshine integration lead.