Skip to content

Guide · Agent skill

How to use the Bottleneck Hunter agent skill (supply chain)

Updated · written with AI from the project's own documentation and checked against our catalogue data

Bottleneck Hunter is an agent skill from the HKUDS/Vibe-Trading repository that asks an AI agent to break a large trend, such as AI infrastructure or the energy transition, into its physical supply chain and look for hard-to-replace choke points. This guide explains what the skill makes the agent do, how to install it, how to phrase requests so it runs, and what to check in its output. The skill is a research framework for investment ideas, not a source of reliable buy or sell advice.

Supply-Chain Bottleneck HunterHKUDS/Vibe-Trading · MIT

Quick start

  1. 1Download the ZIP. Get the bottleneck-hunter ZIP from this page and unzip it so the folder contains SKILL.md.
  2. 2Choose where to install. Place the folder in ~/.claude/skills/ for personal use, or in a project's .claude/skills/ folder for one project.
  3. 3Or upload in the Claude apps. In the Claude apps, open Settings, go to Capabilities, then Skills, and upload the skill.
  4. 4Make sure the tools are available. The skill needs web search, financial_rigor, screen_market, and get_financial_statements or get_stock_news.
  5. 5Name a super-trend. Ask for a specific trend such as AI infrastructure or the energy transition, and ask for under-the-radar listed suppliers.
  6. 6Review the bottleneck board. Check the ranked board, the grades, and the valuation notes for each company.
  7. 7Verify before acting. Confirm the key figures against primary filings and the bear-case points before drawing any conclusion.

What is an agent skill, and what does this one do?

An agent skill is a folder containing a SKILL.md file that gives an AI agent a set of instructions for a specific kind of task. When a request matches the skill, the agent follows its method instead of answering from general knowledge alone.

Bottleneck Hunter starts from a super-trend you name, such as AI infrastructure, energy transition, defense, semiconductor reshoring, or the space economy. It decomposes that trend into physical layers, identifies Layer 2 and Layer 3 choke points such as optics, lasers, InP and SOI substrates, IC substrates, probe cards and specialty fiberglass, and looks for listed companies tied to those links.

  • Confirms the trend against durability, physicality, scale and acceleration criteria using web search.
  • Scores each supply-chain link on six scarcity criteria and grades it.
  • Screens listed companies tied to S- and A-grade bottlenecks.
  • Runs valuation gates through the financial_rigor tool and a bear-case reverse check.
  • Outputs a ranked bottleneck opportunity board.

Install the Bottleneck Hunter skill

Download the ZIP file for the skill from this page and unzip it. The skill folder is named bottleneck-hunter and contains SKILL.md. Place it in one of two locations depending on how you use the agent.

For a personal setup, put the folder in ~/.claude/skills/. For a single project, put it in that project's .claude/skills/ folder so it applies only there.

In the Claude apps, you can instead upload the skill under Settings → Capabilities → Skills.

  • Personal install: ~/.claude/skills/bottleneck-hunter/
  • Project install: the project's .claude/skills/bottleneck-hunter/ folder
  • Claude apps: Settings → Capabilities → Skills, then upload the skill
~/.claude/skills/bottleneck-hunter/SKILL.md

How do you trigger the skill with a natural request?

You do not need a special command. The skill's description says to use it when you want hidden beneficiaries of a structural trend rather than already-priced leaders, so ask for that directly. Name the trend and say you want under-the-radar companies tied to its bottlenecks.

Specific requests work better than general ones. Naming the trend, the layers you care about, and the market or listing venues you want covered helps the agent stay on the method. The skill is written around listed companies in markets such as A, HK, US, JP, TW and EU.

  • "Use the bottleneck hunter on AI infrastructure and list under-the-radar suppliers of optical components."
  • "Find hidden beneficiaries of the semiconductor reshoring trend, starting from Layer 2 choke points."
  • "Run a supply-chain bottleneck screen on the energy transition, focusing on grid and storage components."

What output should you expect?

The main deliverable is a ranked bottleneck opportunity board. Each row lists the company, ticker, market cap, revenue, PS and PE, the bottleneck link, its grade, revenue share from that link, growth, a signal strength rating and a valuation note. Market cap, revenue, PS and PE are required fields in the source, and if financials cannot be obtained the signal strength is capped at two stars.

The grading is mechanical. Each link is scored red, yellow or green on six criteria, and four or more reds make an S-grade single-point risk, three reds make an A-grade, one or two make a B-grade, and no reds means the link is skipped.

  • Bottleneck grades: S (four or more red criteria), A (three), B (one or two), skipped (none).
  • Signal strength runs from one to five stars and depends on cross-validation and valuation colour.
  • Valuation gates can cap a signal at two stars when the valuation is red.

Read the valuation gate and the bear case

The valuation gate is mandatory in the method. For each company the agent should compute PE, PB, ROE and FCF yield with financial_rigor (command=verify_valuation) and run scenario valuation with financial_rigor (command=three_scenario). Red-light flags include a market cap above 20% of TAM and a PS above 30x with revenue growth under 100%. Yellow flags include loss-making companies with PS above 15x.

The skill also asks a sanity question: if the most optimistic scenario fully plays out and you exit at 25x PE in ten years, what is the annualised return? An answer under 10% per year should be flagged as having no margin of safety at the current price.

The reverse checks ask why smart investors are not already buying, whether the bottleneck can be bypassed, whether competitors can add capacity quickly, and what happens to the company if end demand falls by half.

  • Red light: caps signal strength at two stars and flags valuation stretched.
  • Yellow light: needs extra justification or is downgraded.
  • Green light: a bonus, for example PS under 10x with growing revenue.

Safety, data limits and what the skill needs

The skill needs a web search tool, the financial_rigor tool, and screen_market plus get_financial_statements or get_stock_news for market data. It does not run scripts, but it does use the network to fetch information. Treat its outputs as research notes that you verify yourself.

The source states that the skill does not verify data against primary filings, that its outputs depend on web search results and model judgment, and that errors are likely. Its output can also encourage speculative trading. Check every company against its own filings and do not treat a ranking as a recommendation.

The method is also weak for trends with little physical supply chain, such as pure software, because its core approach assumes hardware or material bottlenecks.

  • Required tools: web search, financial_rigor (verify_valuation and three_scenario), screen_market, get_financial_statements, get_stock_news.
  • No scripts are run; network access is used.
  • Verify figures against primary filings before acting on them.

What people use it for

  • An analyst mapping which optical or substrate suppliers sit behind AI data-centre networking build-outs.
  • A student learning how Layer 1 and Layer 2 bottlenecks differ in an industrial supply chain.
  • A researcher building a repeatable checklist for valuation gates and contrarian questions on a trend.
  • An investor reviewing which listed companies tied to semiconductor reshoring are less widely followed, then checking their valuations independently.

Frequently asked questions

Is the Bottleneck Hunter skill free to use?

The source states that the HKUDS/Vibe-Trading repository is MIT licensed, and the skill is listed under agent/src/skills/bottleneck-hunter. The source does not list prices for the skill, but the skill depends on tools such as web search and financial_rigor, whose availability depends on your own setup.

What do I need to run the bottleneck-hunter skill?

You need an AI agent environment that can load skills, plus a web search tool, the financial_rigor tool with its verify_valuation and three_scenario commands, and screen_market, get_financial_statements or get_stock_news for market data. The skill runs no scripts but uses the network.

Where do I install a Claude agent skill like this one?

Unzip the bottleneck-hunter folder into ~/.claude/skills/ for personal use or into a project's .claude/skills/ folder for one project. In the Claude apps, you can upload it under Settings, then Capabilities, then Skills.

Can I trust the stock picks this skill produces?

No. The source says the skill is a research framework for investment ideas, not a source of guaranteed picks. Its outputs depend on web search and model judgment, it does not verify data against primary filings, and errors are likely.

Why did the skill cap a company's signal at two stars?

A signal is capped at two stars when a valuation red light applies, such as a market cap above 20% of TAM or a PS above 30x with revenue growth under 100%, or when financials cannot be obtained. The cap is a rule in the method rather than a judgment about the company's business.

How does this compare with other supply-chain or stock research tools?

The source does not compare this skill with other tools. It is a structured method for finding bottleneck-linked listed companies and running valuation and contrarian checks, and it is not a neutral supply-chain analysis tool.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Bottleneck Hunter suits investors, analysts and students who want a structured checklist for finding listed companies tied to structural supply-chain constraints and for stress-testing their valuations. It is a poor fit for anyone who wants reliable buy or sell advice, a neutral supply-chain study, or analysis of trends that have little physical supply chain, so pick a different tool or a human analyst for those needs.

Download the skill