CtrlK
BlogDocsLog inGet started
Tessl Logo

bottleneck-hunter

AI Berkshire skill: 供应链瓶颈猎手:AI驱动的全球产业链瓶颈套利. Source: skills/bottleneck-hunter.md.

44

Quality

46%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./codex-skills/bottleneck-hunter/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 a richly detailed, highly actionable multi-step research workflow with concrete search templates, numeric gates, and report formats. Its main weaknesses are length/repetition and a monolithic structure that does not use progressive disclosure to offload detail into reference files.

Suggestions

Move the elaborate report templates and the AI-infrastructure Layer 2-4 teardown example into reference files under references/ (e.g. REPORT-TEMPLATES.md, TEARDOWNS.md) and link to them, reducing SKILL.md to the workflow overview.

Consolidate the repeated valuation guidance into a single authoritative section and cross-reference it from step 6.1 and the core principles instead of restating the red/yellow/green rules three times.

Add an explicit validate→fix→retry loop for the hourly scan (e.g. on missing financial data, fall back to watchlist-only output and log the gap) to strengthen feedback for the batch mode.

DimensionReasoningScore

Conciseness

The body does not explain concepts Claude already knows and is dense with actionable tables and templates, but at ~490 lines it is long and repeats the valuation emphasis across steps 4.2.1, 6.1, and the core principles, so it could be tightened.

3 / 5

Actionability

It provides copy-paste-ready search query templates ('WebSearch "{趋势} supply chain bottleneck 2026"'), concrete numeric thresholds (PS>30x, market cap<$10B), explicit tool commands ('python3 tools/twstock_data.py'), and fill-in report templates, with only minor reliance on judgment for data sourcing.

4 / 5

Workflow Clarity

A clearly sequenced 7-step process with explicit validation gates (trend confirmation ✅/❌, 6-criterion bottleneck rating, mandatory valuation check) and checklists, but it lacks a validate→fix→retry feedback loop for the batch hourly-scan mode.

4 / 5

Progressive Disclosure

Section headers organize the content well, but it is a monolithic ~490-line SKILL.md with no bundle files in references/scripts/assets, and content that could be split out (report templates, the AI-infrastructure teardown example, hourly-scan mode) is fully inlined.

3 / 5

Total

14

/

20

Passed

Description

28%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 functions as a titled category rather than a capability statement: it names a niche domain but specifies no concrete actions and gives no usage triggers. It is distinguishable but vague, capping its quality at the low-mid range.

Suggestions

Add concrete actions, e.g. 'Scans physical supply chains for bottleneck chokepoints, screens listed suppliers, and runs valuation checks to surface arbitrage candidates.'

Append a 'Use when...' clause with natural triggers such as 'when researching supply-chain bottlenecks, finding shortage-driven stock opportunities, or screening second/third-tier component suppliers'.

Drop the meta 'Source: skills/bottleneck-hunter.md' provenance line from the user-facing description and replace it with capability/trigger content.

DimensionReasoningScore

Specificity

The description names the domain ('供应链瓶颈猎手' / supply-chain bottleneck arbitrage) but lists no concrete actions — it is a themed title rather than a statement of what the skill does, matching the 'names the domain but actions are minimal' anchor.

2 / 5

Completeness

It gives only a vague 'what' (a thematic category) and entirely omits any 'when' guidance; the missing 'Use when' clause caps completeness at 3 and the vague 'what' pulls it down to 2.

2 / 5

Trigger Term Quality

It surfaces one or two domain keywords ('供应链瓶颈', '套利') but offers none of the natural trigger phrases a user would say to invoke the skill, and there is no 'Use when' clause or synonyms.

2 / 5

Distinctiveness Conflict Risk

The niche (supply-chain bottleneck arbitrage) is somewhat specific, but the description would still overlap with general investment-research or stock-analysis skills and lacks distinct trigger phrases.

3 / 5

Total

9

/

20

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
xbtlin/ai-berkshire
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.