> Source: https://ashareapi.com/en/skill/  ·  Markdown version for LLMs / AI agents

AI-native

# Connect your AI Agent (Agent Skill)
 A Skill is a manual for the AI: install it once and it already knows which endpoint to call, what units the fields use, and how errors behave — instead of you pasting usage notes every time.

 How is this different from MCP?
 MCP gives the AI **tools** (it calls them itself); a Skill gives the AI **knowledge** (how to call, what fields mean, where the traps are). They sit side by side — **a client can have both**.
 |
| | | MCP | Skill

| | What it is | A protocol + server | A folder + Markdown

| | What you need | URL + key (a server) | **Copy one directory** (plain files)

| | What the AI gets | **Tools** (22, auto-invoked) | **Knowledge** (endpoints / fields / errors / SDK)

| | Client support | 19 (remote MCP capable) | **45+** (open standard)

| | Best for | AI looks data up in chat | AI writes code / understands fields / unsupported clients

## Install (pick one)
 1 Option 1: download and unzip (easiest)
 Download the zip and unzip it into your client’s skills directory (next table). **Restart the client** after installing.
[Download ashareapi-skill.zip](/ashareapi-skill.zip) ~20 KB · 5 files · MIT
 2 Option 2: one command (Mac / Linux / WSL)
 Replace `~/.claude/skills` with your client’s directory (see the table below).

```
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -sL https://ashareapi.com/ashareapi-skill.zip -o s.zip && unzip -oq s.zip && rm s.zip
```

 3 Option 3: commit it to your project (team share)
 Put `ashareapi/` into your project’s skills directory and commit — everyone who clones the repo gets it.

## Client paths
 |
| | Client | Global (all projects) | Project (commit to git)

| | Claude Code | ~/.claude/skills/ | .claude/skills/

| | opencode | ~/.config/opencode/skills/ | .opencode/skills/

| | Cursor | ~/.claude/skills/ | .cursor/skills/

| | Codex (OpenAI) | ~/.codex/skills/ | .codex/skills/

| | Antigravity (Google) | ~/.gemini/antigravity/skills/ | .agents/skills/

| | VS Code / GitHub Copilot | ~/.copilot/skills/ | .github/skills/

| | WorkBuddy | — | .workbuddy/skills/

| | DeepSeek Harness (DSH) | ~/.dsh/skills/ | .dsh/skills/

 `~` is your home directory. **Not sure which to use? Either `.claude/skills/` or `.agents/skills/` works** — both are "universal" locations read by Claude Code / opencode / Cursor / Antigravity / DeepSeek Harness. Full client list: agentskills.io/clients.
 .claude/skills/ · .agents/skills/

## More supported clients
 The same open standard is supported by these too (45+ in total) — follow each client’s own docs for its paths:
 [Junie (JetBrains) Docs ↗](https://junie.jetbrains.com/docs/agent-skills.html)[OpenHands Docs ↗](https://docs.openhands.dev/overview/skills)[Goose (Block) Docs ↗](https://block.github.io/goose/docs/guides/context-engineering/using-skills/)[Amp Docs ↗](https://ampcode.com/manual#agent-skills)[Kiro (AWS) Docs ↗](https://kiro.dev/docs/skills/)[TRAE (字节) Docs ↗](https://www.trae.ai/blog/trae_tutorial_0115)[Command Code Docs ↗](https://commandcode.ai/docs/skills)[Roo Code Docs ↗](https://docs.roocode.com/features/skills)[Cline Docs ↗](https://docs.cline.bot/customization/skills)[Factory (Droids) Docs ↗](https://docs.factory.ai/cli/configuration/skills)[Deep Code Docs ↗](https://deepcode.vegamo.cn/en/docs/configuration/agent-skills)[Mistral AI Vibe Docs ↗](https://github.com/mistralai/mistral-vibe)[Letta Docs ↗](https://docs.letta.com/letta-code/skills/)[Mux (Coder) Docs ↗](https://mux.coder.com/agent-skills)[Emdash Docs ↗](https://docs.emdash.sh/skills)[OpenClaw Docs ↗](https://docs.openclaw.ai/tools/skills)[Hermes Agent Docs ↗](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills)[Qodo Docs ↗](https://www.qodo.ai/blog/how-i-use-qodos-agent-skills-to-auto-fix-issues-in-pull-requests/)[Tabnine Docs ↗](https://docs.tabnine.com/main/getting-started/tabnine-cli/features/agent-skills)[Snowflake Cortex Code Docs ↗](https://docs.snowflake.com/en/user-guide/cortex-code/extensibility#extensibility-skills)[Databricks Genie Code Docs ↗](https://docs.databricks.com/aws/en/assistant/skills)[Spring AI Docs ↗](https://spring.io/blog/2026/01/13/spring-ai-generic-agent-skills/)[Laravel Boost Docs ↗](https://laravel.com/docs/12.x/boost#agent-skills)[Pulumi Neo Docs ↗](https://www.pulumi.com/docs/ai/skills/)[Superconductor Docs ↗](https://superconductor.com/docs/project/mcp-and-skills)[Ona Docs ↗](https://ona.com/docs/ona/agents-md#skills-for-repository-specific-workflows)[pi Docs ↗](https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/skills.md)[VT Code Docs ↗](https://github.com/vinhnx/vtcode/blob/main/docs/skills/SKILLS_GUIDE.md)[fast-agent Docs ↗](https://fast-agent.ai/agents/skills/)[bub Docs ↗](https://bub.build/docs/build/skills/)[nanobot Docs ↗](https://nanobot.wiki/docs/0.1.5/use-nanobot/skills)[ZeroClaw Docs ↗](https://docs.zeroclawlabs.ai/master/en/tools/skills.html)[Autohand Code CLI Docs ↗](https://autohand.ai/docs/working-with-autohand-code/agent-skills.html)[Firebender Docs ↗](https://docs.firebender.com/multi-agent/skills)[Vita Docs ↗](https://www.vita-ai.net/docs/features/agent-skills)[Agentman Docs ↗](https://agentman.ai/agentskills)[Workshop Docs ↗](https://docs.workshop.ai/core-concepts/working-with-the-agent#create-your-own-agents)[Piebald Docs ↗](https://piebald.ai)[Google AI Edge Gallery Docs ↗](https://github.com/google-ai-edge/gallery/tree/main/skills)[Claude (claude.ai) Docs ↗](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)
 [Official client list (full) →](https://agentskills.io/clients)

## How to confirm it works
 After restarting, ask an A-share question (you don’t need to mention the skill):

- What is the price of 600667 right now?

- Show me the last 5 daily candles for 600519

- Which sectors gained the most today?

- Find stocks with PE under 20 and ROE above 15 (needs a key)

 The difference: it **proactively calls ashareapi endpoints** instead of asking you for code — and it knows that "no data" and "fetch failed" are two different things.

## What’s inside
 Four reference files load on demand (so the AI isn’t flooded up front):
 SKILL.md
 Decision tree: what you want → which endpoint; four must-know semantics (units / string numbers / dates / response shape)

 references/endpoints.md
 All 32 endpoints with parameters and return notes

 references/fields.md
 Field semantics and units (volume in lots / amount in CNY / ratios as percentages…)

 references/errors.md
 401 / 429 / ok:false / empty results, and PoW quota boost

 references/sdk.md
 Official SDK usage (Python: pip install ashareapi · Node.js: npm install ashareapi)

 Get started
 The free endpoints (quote / kline / hot / market overview / breadth) need **no key** — install and try. Grab a key when you need financials, fund flow or top-trader boards.
 [Get a Key](/en/pricing)[See MCP setup (the other way) →](/en/mcp)
