CtrlK
BlogDocsLog inGet started
Tessl Logo

stock-announcements

获取A股上市公司公告信息(真实数据)。基于AkShare从东方财富网获取当日全部公告,支持按股票代码筛选、关键词过滤。 适用于监控重大事件、业绩快报、股东变动、重组公告等投资决策关键信息。数据源:东方财富网(稳定可靠)。

68

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A strong, executable skill body: copy-paste commands cover all documented variants, the parameter table is precise, and the referenced script exists and matches the documented interface. The only real slack is mild promotional filler in the "真实数据保证" section and the repeated encoding-export line, plus the absence of an explicit error/empty-result handling step in the workflow.

DimensionReasoningScore

Conciseness

The body is dominated by lean, high-value material: five ready-to-run commands, a compact parameter table, a three-step workflow, and honest limitations. Minor trimming is possible — the "真实数据保证" section reads as promotional filler ("官方权威数据", "数据质量"), and `export PYTHONIOENCODING=utf-8` is repeated verbatim in all five examples — which matches 'efficient; minor instances of over-explanation that could be trimmed' rather than the uniformly lean level 5.

4 / 5

Actionability

Every usage pattern is a copy-paste-ready executable command against a real script (`scripts/announcements.py` exists in the bundle), the parameter table gives concrete examples and defaults for every flag, and the workflow even specifies fallback handling for non-numeric input ("先用 web-search 查询股票代码"). This matches 'fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

The workflow is a clearly sequenced three steps — normalize the stock code (with per-format handling), execute the query command, then interpret/categorize the results. It is a read-only operation, so the destructive/batch validation cap does not apply, but there is no explicit checkpoint for the failure modes the skill itself documents (e.g. what to do on the 7–10s timeout or empty results), keeping it at 'clear sequence with most checkpoints present; minor validation gaps' rather than the level-5 feedback-loop anchor.

4 / 5

Progressive Disclosure

The SKILL.md is a clean overview whose only external dependency is a single clearly-signaled, one-level-deep reference to `scripts/announcements.py` (verified to exist, with matching CLI parameters), and all logic lives in that script rather than being inlined. Sections are well-organized and navigable (Dependencies, When to Use, Usage, Parameters, Workflow, Limitations), matching 'clear overview with well-signaled one-level-deep references; content appropriately split'.

5 / 5

Total

18

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A well-formed, domain-specific description that states what the skill does, its data source, and applicable scenarios with natural trigger terms. Its only weaknesses are mild self-promotion ("数据源:东方财富网(稳定可靠)") and a 'when' clause that describes use scenarios rather than explicit user-trigger phrases.

DimensionReasoningScore

Specificity

The description names concrete actions — "获取当日全部公告" (fetch all daily announcements), "支持按股票代码筛选、关键词过滤" (filter by stock code and keyword) — grounded in a specific stack (AkShare / 东方财富网). It stops short of comprehensive coverage (no mention of PDF detail extraction, JSON output, or multi-day ranges), matching the 'several specific actions; minor gaps' anchor rather than the fully comprehensive level 5 or the 1–2-action level 3.

4 / 5

Completeness

Both parts are present: the 'what' is explicit (fetch A-share company announcements from Eastmoney via AkShare, with code/keyword filtering), and a 'when' clause exists ("适用于监控重大事件、业绩快报、股东变动、重组公告等投资决策关键信息"). The 'when' states applicable scenarios but is not phrased as explicit user-trigger guidance (no '当用户询问公告时...'), so it matches level 4 ('when' could be more explicit) rather than the level-5 anchor with concrete trigger phrases, and it is clearly above level 3 since a 'when' clause is present.

4 / 5

Trigger Term Quality

Natural Chinese trigger terms are present: "公告" (announcements), "业绩快报", "股东变动", "重组公告", "重大事件" — phrases a user monitoring A-share disclosures would actually say. A few common variations are missing (e.g. "年报/财报", "信息披露", "公告查询"), which fits the 'good keyword coverage; a few natural terms missing' anchor rather than the synonym-complete level 5.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche — A-share listed-company announcements from a named source (东方财富网) via a named library (AkShare) — with distinct triggers like 业绩快报 and 重组公告. This is narrowly scoped enough that it would rarely fire for the wrong skill; no broader overlap (e.g. general stock quotes or news) is claimed.

5 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
netease-youdao/LobsterAI
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.