Skip to content

Guide · Agent skill

How to use the Macroeconomic Analysis agent skill (macro-analysis)

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

The macro-analysis skill is a set of written instructions that teaches an AI agent how to read economic indicators, place the economy in a cycle stage, interpret central-bank statements from the PBOC, Fed and ECB, and suggest which major asset classes to overweight or underweight. It is aimed at investment analysts and students who want a structured first pass at a macro view, and at anyone who wants the same framework applied every time. After this guide you will know what the skill does, how to install it, how to ask for it in plain language, and where its limits are.

Macroeconomic AnalysisHKUDS/Vibe-Trading · MIT

Quick start

  1. 1Download the ZIP. Download the macro-analysis ZIP from this page.
  2. 2Unzip into the skills folder. Unzip the folder into ~/.claude/skills/ for personal use, or into .claude/skills/ inside a project.
  3. 3Or upload in the Claude apps. In the Claude apps, go to Settings → Capabilities → Skills and upload the skill.
  4. 4Gather the latest data. Collect the last three months of the indicators you care about, such as PMI, CPI, PPI, M2 and the Fed rate.
  5. 5Make a plain-language request. Ask for a snapshot, cycle stage, policy read or allocation view for China, the US or Europe.
  6. 6Verify the output. Check the figures and tilts against official sources and independent analysis before relying on them.

What is an agent skill and what does macro-analysis make the agent do?

An agent skill is a folder containing a SKILL.md file. The file tells an AI agent how to handle a certain kind of task. The macro-analysis skill's description is: macroeconomic cycle positioning and central-bank policy interpretation, including GDP, CPI, PMI, rates and FX analysis, with output in the form of major-asset allocation tilts.

Once installed, the agent follows a four-step framework from the file: collect core indicators from the latest three months, decide where the economy sits in the cycle, assess policy impact, and then propose an asset allocation tilt. Its outputs follow a fixed report template with a data snapshot, cycle assessment, central-bank analysis, allocation table and risk warnings.

  • Growth indicators: GDP YoY, manufacturing PMI, industrial production, retail sales, fixed asset investment
  • Inflation indicators: CPI YoY, PPI YoY, core CPI, M2 YoY
  • Rates and FX: 1Y/5Y LPR, DR007, 10-year government bond yield, USD/CNY, US 10Y-2Y spread
  • Cycle model: recovery, overheat, stagflation, recession, based on a Merrill Lynch clock framework
  • Central-bank frameworks: FOMC statement, dot plot and minutes for the Fed; PBOC toolbox; ECB HICP and PMI

How do you install the macro-analysis skill?

Download the ZIP for macro-analysis from this page and unzip it. The skill is a folder that contains SKILL.md. You can install it in one of two places, depending on how you want to use it.

For a personal install that applies everywhere, unzip the folder into ~/.claude/skills/. For a project-only install, unzip it into the .claude/skills/ folder inside that project. In the Claude apps, you can instead upload the skill under Settings → Capabilities → Skills.

  • Personal: ~/.claude/skills/macro-analysis/
  • Project: .claude/skills/macro-analysis/ inside your project folder
  • Claude apps: Settings → Capabilities → Skills, then upload
~/.claude/skills/macro-analysis/SKILL.md

How do you trigger the skill with natural requests?

You do not need a special command. Describe what you want in plain language that touches on macro data, central banks or cycle positioning. The agent should recognise the request from the skill's description and apply its framework.

Be specific about the economies and the question. The skill covers China, the United States and Europe, and its output is most useful when you ask for a snapshot, a cycle stage, a policy read or an allocation view.

  • "Use the macro analysis skill to place the China economy in a cycle stage using the latest PMI, CPI and PPI."
  • "Interpret the latest FOMC statement and tell me whether the Fed sounds hawkish or dovish."
  • "Give me a macro briefing on the US, China and Europe with a data snapshot and asset allocation tilts."
  • "Read this PBOC statement and tell me what policy tools it implies."

What output should you expect?

The skill asks for a report with a fixed structure. It starts with a snapshot table of core indicators showing latest value, previous value and trend, followed by the cycle positioning, central-bank analysis, an allocation tilt table and risk warnings. Because the template is fixed, you can compare briefings from different months side by step.

The thresholds in the file are generic rules of thumb. For example, it treats China GDP above 5% as normal and below 4% as weak, and it treats a 10-year government bond yield below 2.5% as loose. Treat these as starting points for your own checks, not as validated signals.

What does the skill need to run?

The skill lists no requirements. It does not run scripts and it does not use the network. It provides no live data feed: the file only tells the agent which indicators to collect and where they are normally published, such as the National Bureau of Statistics, Caixin and the PBOC. You must supply the latest figures yourself, either by pasting them into the chat or by providing them in files the agent can read.

  • No listed requirements
  • Does not run scripts
  • Does not use the network
  • You provide the current data; the skill does not fetch it

What are the safety limits of this skill?

The skill outputs asset-allocation tilts such as overweight or underweight recommendations for China A-shares, US equities, bonds, commodities and cash. These are directional views, not trade instructions. The file itself notes that macro analysis gives directional judgment rather than exact levels or timing.

Do not rely on it for personal financial decisions without professional review. The file gives no data sources or backtests for its thresholds, so verify any conclusion independently before acting on it.

  • Thresholds are generic rules of thumb, not validated forecasts
  • The file gives no backtests
  • Not suitable as personal financial advice
  • Check any figure against the official release before using it

What tips help you get better results?

Give the agent the latest three months of data for each indicator you care about, since the framework relies on trends rather than single readings. Ask for the marginal change, because the file stresses that direction and speed of change matter more than absolute levels.

Remember that data is released with lags. PMI is the timeliest, arriving at the start of the month, while GDP is the most delayed, arriving around 15 days after quarter-end.

  • Supply three months of data per indicator
  • Ask about direction and speed of change
  • Check release timing: PMI early in the month, GDP about 15 days after quarter-end
  • Compare reports over time using the same template

What people use it for

  • Drafting a structured first-pass macro view for an investment committee discussion
  • Learning how PMI, CPI and PPI readings map onto economic cycle stages
  • Reviewing a Fed statement or PBOC announcement against a consistent checklist
  • Building a recurring macro briefing that uses the same report template each month

Frequently asked questions

How do I install the macro-analysis agent skill?

Download the ZIP from this page and unzip it into ~/.claude/skills/ for a personal install, or into .claude/skills/ inside a project. In the Claude apps you can instead upload it under Settings → Capabilities → Skills.

Does macro-analysis need any requirements or API keys?

The skill lists no requirements. It does not run scripts or use the network, so it does not fetch live data. You supply the current figures yourself.

Is the macro-analysis skill free?

The source material does not state pricing. It is listed under the MIT licence in the HKUDS/Vibe-Trading repository.

Does the skill give live economic data?

No. The file only describes which indicators to collect and where they are usually published. You need to provide the latest numbers.

How accurate are the cycle and allocation calls?

The file says the thresholds are generic rules of thumb, not validated forecasts, and it gives no backtests. It provides directional judgment, not exact levels or timing, so verify results independently.

What should I use instead if I want live macro data or backtested signals?

The skill does not provide live data or backtests, so you would need a separate data source and a validated research process for those. Choose such a tool if you need data fetching or tested forecasts.

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

Macro-analysis suits investment analysts and students who want a consistent, structured first pass at a macro view and a repeatable checklist for central-bank policy. It is not suitable for making trades or allocations without independent verification, for anyone expecting live data, or for personal financial advice. Pick a data-driven or backtested tool if you need validated forecasts or automatic data feeds.

Download the skill