sn-search-year-report

用于搜索免费官方年报、年度报告、定期报告、上市公司披露文件、债券发行人报告和海外公司年度账目。

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/sn-search-year-report/SKILL.md

Quality

Content

76%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.

The body is highly actionable with executable commands and a real script, well-structured with clear progressive disclosure, but the search/download workflow lacks explicit validation checkpoints for a batch operation, capping workflow clarity.

Suggestions

Add a verification step to the workflow, e.g. after locating a PDF, confirm the report period and disclosure date match the request and that the URL is publicly accessible before reporting it.

Consider moving the large browser-resource URL table into a separate references file (e.g. references/browser_sources.md) and summarizing entry points in SKILL.md.

Fix the subcommand typo inconsistency ('sec-filings' in examples vs 'sec-filings' in the table) to keep the command surface unambiguous.

Dimension	Reasoning	Score
Conciseness	Efficient tables and executable command examples with minimal concept over-explanation; most prose (credential handling, dropped-source rationale) earns its place, with only minor padding (repeated '免费、免 key' phrasing) that could be trimmed.	4 / 5
Actionability	Fully executable bash examples for every subcommand, real source URLs, and a real Python script with a concrete CLI covering the common cases; copy-paste ready guidance with specific examples.	5 / 5
Workflow Clarity	A clear numbered sequence exists (classify subject type, mix script/browser, accept only official sources) but this batch search/download operation has no validation checkpoint confirming the returned PDF matches the requested report period or is genuinely accessible, which caps workflow clarity at 3 per the batch-operation guideline.	3 / 5
Progressive Disclosure	Well-organized sections (workflow, API script, browser resources, dropped sources, output spec) with a real one-level-deep bundle reference to scripts/year_report_api.py; the large inline browser-resource table could live in a separate references file, leaving a minor organization gap.	4 / 5
	Total	16 / 20 Passed

Description

61%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.

The description clearly scopes a distinct niche (free official annual reports across A-share, HK, US, UK, bond issuer, and other markets) with good trigger-term coverage, but it lacks an explicit 'Use when...' trigger clause and uses only a single generic action verb, capping completeness and specificity.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks for annual reports, 10-K/20-F/40-F filings, or listed-company disclosure documents.'

Replace or supplement the single verb '搜索' with concrete actions like 'search, resolve company codes, and download annual-report PDFs'.

Include common file extensions and form names (e.g. '.pdf', '10-K', '20-F', '40-F', 'Annual Report') to strengthen trigger-term coverage.

Dimension	Reasoning	Score
Specificity	Names the domain and several concrete report types ('年报、年度报告、定期报告、上市公司披露文件、债券发行人报告和海外公司年度账目') but relies on a single generic action verb ('搜索'); not comprehensive in actions, so it sits at the anchor rather than above.	3 / 5
Completeness	Has a clear 'what' (search free official annual reports across listed source types) but no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric guideline.	3 / 5
Trigger Term Quality	Good natural keyword coverage with synonyms across markets ('年报'/'年度报告'/'定期报告', '上市公司披露文件', '债券发行人报告', '海外公司年度账目'); a few common variations and file extensions are missing, so it is above the midpoint but not fully comprehensive.	4 / 5
Distinctiveness Conflict Risk	Clear niche of free, official multi-market annual-report sources with distinct triggers and low overlap risk; only minor overlap with generic search skills, so noticeably above the midpoint.	4 / 5
	Total	14 / 20 Passed

Validation

100%

Warnings & errors only

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: OpenSenseNova/SenseNova-Skills
Path: skills/sn-search-year-report/SKILL.md
Commit: 61b60bb

Reviewed: 8 days ago

Table of Contents

Discovery Implementation Validation

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.