Not in the top 1,000 by GitHub stars

joutaojian/arkvol-skill

Arkvol Skill 将 arkvol.com 的数据查询与解读能力接入兼容 Agent Skills 的 AI Agent。安装后，可以直接用自然语言查询 A 股与科技板块、港股、基金与 ETF、美股中期趋势及七巨头轮动等数据，并获得包含数据日期、关键指标和风险边界的分析结果。

Engineering

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

`SKILL.md`

Week of Nov 2, 2026 · +0 / −0 lines

Before Network or broad shell → After Network or broad shell

8137641d347c → 8137641d347c

Diff text is unavailable under the recorded licenses. Line counts and the GitHub link remain available.

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → 8137641d347c

No earlier version was observed for comparison.

Compare on GitHub

View on GitHub Add to my skills

Verified commit 8137641d347ca5faf547aec07c71996cd5255038

200GitHub stars

0stars in 7 days

1skill in this repository

0commits in 30 days

Heat

0.3

Star growth, last 7 daysNot available
Star growth, last 24 hoursNot available
Rank movement, last 7 daysNot available
Commits, last 30 daysNot available
Accounts asking about it through MCP, last 7 daysNot available
Hot votes this weekNot available

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

30-day change not yet available: not enough history.

Individual skills in this repository

arkvol-greed-index /

How it works

arkvol-greed-index

When your agent uses it

查询并深度分析 Arkvol A股、港股、美股、基金、ETF、宽基、贪婪指数、科技板块、七巨头、Mag7、全球资金流、美元美债流动性、中国国债温度和52周低位数据。用于市场情绪、指标解释、筛选、排名、比较、预测、估值、目标价、仓位和策略分析；不提供具体证券买入/卖出推荐或荐股名单。

What it loads into context

Frontmatter

115 tokens

Always available to the agent

SKILL.md

1,744 tokens

When the skill is activated

Reference documents

2,389 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

准备凭据
安装与更新提示
版本检查与升级
查询
荐股边界
解读
错误处理

Scripts executed separately

scripts/client.py
scripts/config.py
scripts/pages.py
scripts/query.py
tests/test_analysis_boundary.py
tests/test_api_key_client.py

Files

.gitignoreasset59 bytes
README.mddoc7,233 bytes
SKILL.mdcore6,381 bytes
SKILL.mdcore6,381 bytes
SKILL.mdcore6,381 bytes
VERSIONasset6 bytes
agents/openai.yamlasset348 bytes
reference.mddoc2,244 bytes
scripts/client.pyruns5,608 bytes
scripts/config.pyruns1,998 bytes
scripts/pages.pyruns5,565 bytes
scripts/query.pyruns5,780 bytes
shared/arkvol-entry.example.jsonasset62 bytes
shared/arkvol-hero-16x9.gifasset6,227,351 bytes
shared/p1.pngasset64,421 bytes
tests/test_analysis_boundary.pyruns6,635 bytes
tests/test_api_key_client.pyruns4,972 bytes

No excerpt is shown for this license. Read the source on GitHub.

View the complete source on GitHub

Skills included

arkvol-greed-index

Repository facts

License: No license detected
Created: Jul 11, 2026
Last pushed: Jul 27, 2026
Forks: 11
Open issues: 0
Project activity: Slowing

Before you install

Network or broad shell

Automated signals, not a guarantee

Checked Nov 7, 2026

Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.

Show 2 notes

SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed

No broad tool permissions
No dangerous shell commands
61 network referencesin 7 files: tests/test_api_key_client.py:64 README.md:9 tests/test_analysis_boundary.py:19 and 4 more
No hidden or obfuscated text
No instruction overrides
6 executable scriptsin 6 files: scripts/client.py:1 scripts/config.py:1 scripts/pages.py:1 and 3 more
34 references to secretsin 7 files: scripts/config.py:23 tests/test_api_key_client.py:19 scripts/client.py:39 and 4 more
No requests to vote in Hot

Show all 101 signals by file

`README.md`

Network accessline 9

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

Network accessline 10

[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Standard-green)](https://agentskills.io)

Network accessline 11

[![skills.sh](https://img.shields.io/badge/skills.sh-Compatible-blue)](https://skills.sh)

Network accessline 12

[![Multi-Runtime](https://img.shields.io/badge/Runtime-Claude%20Code%20%20Codex%20%20Cursor%20%20OpenClaw%20%20Hermes-blueviolet)](#2-安装-skill)

Network accessline 14

[Arkvol.com](https://arkvol.com) · [安装](#2-安装-skill) · [更新](#3-更新-skill) · [安全与合规](#安全与合规)

Network accessline 25

[arkvol.com](https://arkvol.com) 是覆盖 A 股、港股和美股的金融数据分析服务，通过市场情绪、贪婪与恐慌指数、板块轮动等指标，帮助用户观察市场状态和趋势。

Network accessline 27

Arkvol Skill 将 [arkvol.com](https://arkvol.com) 的数据查询与解读能力接入兼容 Agent Skills 的 AI Agent。安装后，可以直接用自然语言查询 A 股与科技板块、港股、基金与 ETF、美股中期趋势、七巨头、全球资金流、中国国债温度和 52 周低位数据。

Network accessline 41

前往 [arkvol.com](https://arkvol.com) 注册或登录，从右上角头像进入 **API Key** 页面创建 Key。完整 Key 仅显示一次。

Network accessline 47

Arkvol Skill 基于开放的 [Agent Skills](https://agentskills.io) 协议，可在兼容 Agent Skills 的 AI Agent 中运行。

Network accessline 54

帮我安装这个 Skill：https://github.com/joutaojian/arkvol-skill，并帮我配置 Arkvol Skill 的 API Key。

Network accessline 73

帮我把 Arkvol Skill 升级到最新版本：https://github.com/joutaojian/arkvol-skill

Network accessline 102

[arkvol.com](https://arkvol.com) is a financial data analysis service covering mainland China A-shares, Hong Kong stocks, and US stocks. It helps users observe market conditions and trends through market sentiment, fear and greed indexes, s

Network accessline 104

Arkvol Skill brings the data querying and interpretation capabilities of [arkvol.com](https://arkvol.com) to AI agents compatible with the Agent Skills standard. Once installed, users can query A-shares and technology sectors, Hong Kong sto

Network accessline 118

Arkvol Skill follows the open [Agent Skills](https://agentskills.io) standard and runs in AI agents that support Agent Skills.

Network accessline 125

Install this Skill: https://github.com/joutaojian/arkvol-skill

Network accessline 135

Upgrade Arkvol Skill to the latest version: https://github.com/joutaojian/arkvol-skill

`SKILL.md`

Access to secretsline 16
```
[Credential-related source omitted]
```
Access to secretsline 24
```
[Credential-related source omitted]
```
Access to secretsline 28
```
[Credential-related source omitted]
```

Network accessline 44

如果脚本返回退出码 `3`、`update_required: true` 或“需要升级”，停止当前数据查询，立即使用当前 Agent 运行时的标准 Skill 更新方式从 `https://github.com/joutaojian/arkvol-skill` 升级。保留仓库外的 `~/.arkvol/arkvol-entry.json`，不要覆盖或输出 API Key。升级后重新读取新版 `SKILL.md`，再次检查版本，再执行原查询。

Network accessline 96

- Key 缺失：明确告知尚未配置成功，并引导用户前往 `https://arkvol.com` 注册或登录，点击右上角头像进入 **API Key** 页面创建 Key，再写入 `~/.arkvol/arkvol-entry.json`。不要反复请求接口。

`scripts/client.py`

Executable scriptline 1
```
Executable file
```

Network accessline 18

latest = status.get('latest_version') or '未知'         current = status.get('current_version') or '未知'         repository_url = status.get('repository_url') or 'https://github.com/joutaojian/arkvol-skill'

Network accessline 19

current = status.get('current_version') or '未知'         repository_url = status.get('repository_url') or 'https://github.com/joutaojian/arkvol-skill'         super().__init__(

Network accessline 20

repository_url = status.get('repository_url') or 'https://github.com/joutaojian/arkvol-skill'

Network accessline 38
```
[Credential-related source omitted]
```
Network accessline 39
```
[Credential-related source omitted]
```
Access to secretsline 39
```
[Credential-related source omitted]
```
Network accessline 40
```
[Credential-related source omitted]
```

Network accessline 41

self.base_url = (base_url or 'https://arkvol.com').rstrip('/')

Access to secretsline 42
```
[Credential-related source omitted]
```
Access to secretsline 71
```
[Credential-related source omitted]
```
Access to secretsline 75
```
[Credential-related source omitted]
```

`scripts/config.py`

Executable scriptline 1
```
Executable file
```
Access to secretsline 23
```
[Credential-related source omitted]
```
Access to secretsline 24
```
[Credential-related source omitted]
```
Access to secretsline 25
```
[Credential-related source omitted]
```
Access to secretsline 39
```
[Credential-related source omitted]
```
Access to secretsline 42
```
[Credential-related source omitted]
```
Access to secretsline 44
```
[Credential-related source omitted]
```
Access to secretsline 45
```
[Credential-related source omitted]
```
Access to secretsline 46
```
[Credential-related source omitted]
```

Network accessline 50

raise ArkvolConfigError(         '未配置 Arkvol API Key。\n'         '1. 前往 https://arkvol.com 注册或登录。\n'

Network accessline 51

'未配置 Arkvol API Key。\n'         '1. 前往 https://arkvol.com 注册或登录。\n'         '2. 点击右上角头像，进入“API Key”页面并创建 Key。\n'

Network accessline 52

'1. 前往 https://arkvol.com 注册或登录。\n'

Access to secretsline 54
```
[Credential-related source omitted]
```
Access to secretsline 55
```
[Credential-related source omitted]
```
Access to secretsline 63
```
[Credential-related source omitted]
```

`scripts/pages.py`

Executable scriptline 1
```
Executable file
```

`scripts/query.py`

Executable scriptline 1
```
Executable file
```
Access to secretsline 13
```
[Credential-related source omitted]
```

Network accessline 40

parser.add_argument('--api-key', help='临时覆盖配置文件中的 API Key')     parser.add_argument('--config', help='API Key 配置文件路径，默认使用 ~/.arkvol/arkvol-entry.json')     parser.add_argument('--base-url', default='https://arkvol.com')

Network accessline 41

parser.add_argument('--config', help='API Key 配置文件路径，默认使用 ~/.arkvol/arkvol-entry.json')     parser.add_argument('--base-url', default='https://arkvol.com')     parser.add_argument('--view', choices=('summary', 'full'), default='full', help=

Network accessline 42

parser.add_argument('--base-url', default='https://arkvol.com')

Access to secretsline 51
```
[Credential-related source omitted]
```
Access to secretsline 52
```
[Credential-related source omitted]
```

Network accessline 80

'update_required': status.get('update_required') is True,         'repository_url': str(             status.get('repository_url') or 'https://github.com/joutaojian/arkvol-skill'

Network accessline 81

'repository_url': str(             status.get('repository_url') or 'https://github.com/joutaojian/arkvol-skill'         ),

Network accessline 82

status.get('repository_url') or 'https://github.com/joutaojian/arkvol-skill'

`shared/arkvol-entry.example.json`

Access to secretsline 2
```
[Credential-related source omitted]
```

`tests/test_analysis_boundary.py`

Executable scriptline 1
```
Executable file
```
Network accessline 19
```
[Credential-related source omitted]
```
Access to secretsline 19
```
[Credential-related source omitted]
```

Network accessline 20

config=None,         base_url='https://example.test',         view=view,

Network accessline 21
```
base_url='https://example.test',
```

Network accessline 41

'update_available': False,             'update_required': False,             'repository_url': 'https://github.com/joutaojian/arkvol-skill',

Network accessline 42

'update_required': False,             'repository_url': 'https://github.com/joutaojian/arkvol-skill',         }

Network accessline 43

'repository_url': 'https://github.com/joutaojian/arkvol-skill',

Network accessline 158

'current_version': '0.3.1',                     'latest_version': '0.4.0',                     'repository_url': 'https://github.com/joutaojian/arkvol-skill',

Network accessline 159

'latest_version': '0.4.0',                     'repository_url': 'https://github.com/joutaojian/arkvol-skill',                 })

Network accessline 160

'repository_url': 'https://github.com/joutaojian/arkvol-skill',

`tests/test_api_key_client.py`

Executable scriptline 1
```
Executable file
```
Access to secretsline 19
```
[Credential-related source omitted]
```
Access to secretsline 38
```
[Credential-related source omitted]
```
Access to secretsline 41
```
[Credential-related source omitted]
```
Access to secretsline 45
```
[Credential-related source omitted]
```
Access to secretsline 49
```
[Credential-related source omitted]
```
Access to secretsline 50
```
[Credential-related source omitted]
```
Access to secretsline 59
```
[Credential-related source omitted]
```

Network accessline 64

def opener(request, timeout):             requests.append((request, timeout))

Network accessline 65
```
requests.append((request, timeout))
```
Network accessline 68
```
[Credential-related source omitted]
```
Access to secretsline 68
```
[Credential-related source omitted]
```

Network accessline 71

self.assertEqual(client.fetch_page(page_id)['code'], 0)                 request, timeout = requests[-1]                 self.assertEqual(request.full_url, f"https://example.test{definition['endpoint']}?view=full")

Network accessline 72

request, timeout = requests[-1]                 self.assertEqual(request.full_url, f"https://example.test{definition['endpoint']}?view=full")                 self.assertEqual(request.get_header('X-api-key'), 'secret-key')

Network accessline 73

self.assertEqual(request.full_url, f"https://example.test{definition['endpoint']}?view=full")

Network accessline 86

def opener(request, timeout):             requests.append((request, timeout))

Network accessline 87
```
requests.append((request, timeout))
```
Network accessline 90
```
[Credential-related source omitted]
```
Access to secretsline 90
```
[Credential-related source omitted]
```

Network accessline 98

'update_available': True,             'update_required': True,             'repository_url': 'https://github.com/joutaojian/arkvol-skill',

Network accessline 99

'update_required': True,             'repository_url': 'https://github.com/joutaojian/arkvol-skill',         }

Network accessline 100

'repository_url': 'https://github.com/joutaojian/arkvol-skill',

Network accessline 111
```
[Credential-related source omitted]
```
Access to secretsline 111
```
[Credential-related source omitted]
```

Network accessline 119

'update_available': True,             'update_required': True,             'repository_url': 'https://github.com/joutaojian/arkvol-skill',

Network accessline 120

'update_required': True,             'repository_url': 'https://github.com/joutaojian/arkvol-skill',         }

Network accessline 121

'repository_url': 'https://github.com/joutaojian/arkvol-skill',

Network accessline 128

client = ArkvolClient(             base_url='https://example.test',

Network accessline 129
```
base_url='https://example.test',
```
Access to secretsline 130
```
[Credential-related source omitted]
```

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Some files could not be read; the facts below still hold.

Signal confidence: 100 facts

Network access in prose of documentationREADME.md:9Low confidence
Network access in prose of documentationREADME.md:10Low confidence
Network access in prose of documentationREADME.md:11Low confidence
Network access in prose of documentationREADME.md:12Low confidence
Network access in prose of documentationREADME.md:14Low confidence
Network access in prose of documentationREADME.md:25Low confidence
Network access in prose of documentationREADME.md:27Low confidence
Network access in prose of documentationREADME.md:41Low confidence
Network access in prose of documentationREADME.md:47Low confidence
Network access in code of documentationREADME.md:54Low confidence
Network access in code of documentationREADME.md:73Low confidence
Network access in prose of documentationREADME.md:102Low confidence
Network access in prose of documentationREADME.md:104Low confidence
Network access in prose of documentationREADME.md:118Low confidence
Network access in code of documentationREADME.md:125Low confidence
Network access in code of documentationREADME.md:135Low confidence
Access to secrets in prose of the SKILL.mdSKILL.md:16Low confidence
Access to secrets in code of the SKILL.md: a variable, placeholder or call, not a stored valueSKILL.md:24Low confidence
Access to secrets in prose of the SKILL.mdSKILL.md:28Low confidence
Network access in prose of the SKILL.mdSKILL.md:44Low confidence
Network access in prose of the SKILL.mdSKILL.md:96Low confidence
Executable script in a comment of a file that runsscripts/client.py:1Low confidence
Network access in code of a file that runsscripts/client.py:18High confidence
Network access in code of a file that runsscripts/client.py:19High confidence
Network access in code of a file that runsscripts/client.py:20High confidence
Network access in code of a file that runsscripts/client.py:38High confidence
Network access in code of a file that runsscripts/client.py:39High confidence
Access to secrets in code of a file that runsscripts/client.py:39High confidence
Network access in code of a file that runsscripts/client.py:40High confidence
Network access in code of a file that runsscripts/client.py:41High confidence
Access to secrets in code of a file that runsscripts/client.py:42High confidence
Access to secrets in code of a file that runsscripts/client.py:71High confidence
Access to secrets in code of a file that runsscripts/client.py:75High confidence
Executable script in a comment of a file that runsscripts/config.py:1Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuescripts/config.py:23Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuescripts/config.py:24Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuescripts/config.py:25Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuescripts/config.py:39Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuescripts/config.py:42Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuescripts/config.py:44Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuescripts/config.py:45Low confidence
Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valuescripts/config.py:46Low confidence
Network access in code of a file that runsscripts/config.py:50High confidence
Network access in code of a file that runsscripts/config.py:51High confidence
Network access in code of a file that runsscripts/config.py:52High confidence
Access to secrets in code of a file that runsscripts/config.py:54High confidence
Access to secrets in code of a file that runsscripts/config.py:55High confidence
Access to secrets in code of a file that runsscripts/config.py:63High confidence
Executable script in a comment of a file that runsscripts/pages.py:1Low confidence
Executable script in a comment of a file that runsscripts/query.py:1Low confidence

and 50 more

Works with

Agent compatibility, from the files in this repository
Agent	Status	Evidence	Install to
Claude Code	Compatible	Standard SKILL.md SKILL.md	`.claude/skills/<skill-name>/`
Codex	Compatible	Standard SKILL.md SKILL.md	`.agents/skills/<skill-name>/`
Cursor	Compatible	Standard SKILL.md SKILL.md	`.cursor/skills/<skill-name>/`
Gemini CLI	Compatible	Standard SKILL.md SKILL.md	`.gemini/skills/<skill-name>/`
GitHub Copilot	Compatible	Standard SKILL.md SKILL.md	`.github/skills/<skill-name>/`
OpenCode	Compatible	Standard SKILL.md SKILL.md	`.opencode/skills/<skill-name>/`

Native The repository ships a manifest, folder or frontmatter field for this agent.
Compatible A standard SKILL.md that this agent can read.
Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.

joutaojian/arkvol-skill

History

SKILL.md

Share this page

Heat

Stars over time

Individual skills in this repository

How it works

arkvol-greed-index

Frontmatter

SKILL.md

Reference documents

The playbook

Scripts executed separately

Files

Skills included

Repository facts

Before you install

README.md

SKILL.md

scripts/client.py

scripts/config.py

scripts/pages.py

scripts/query.py

shared/arkvol-entry.example.json

tests/test_analysis_boundary.py

tests/test_api_key_client.py

How the signals fit together

Works with

You might also use

mattpocock/skills

obra/superpowers

NousResearch/hermes-agent

multica-ai/andrej-karpathy-skills

anthropics/skills

DietrichGebert/ponytail

`SKILL.md`

`README.md`

`SKILL.md`

`scripts/client.py`

`scripts/config.py`

`scripts/pages.py`

`scripts/query.py`

`shared/arkvol-entry.example.json`

`tests/test_analysis_boundary.py`

`tests/test_api_key_client.py`