Guide · Agent skill
How to use the Corporate Event Analysis agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The corporate-events skill is a set of written guidelines that teaches an AI agent how to read company announcements on China's A-share market and turn them into a structured event-driven analysis. It covers takeovers, major shareholder share increases and decreases, equity incentive plans, private placements and ST or delisting warnings. After reading this guide you will know how to install the skill, how to phrase a request so the agent uses it, what it needs to run, and where its limits are.
Quick start
- 1Download the ZIP. Download the corporate-events ZIP from the directory page. The skill is delivered as a single SKILL.md file inside the archive.
- 2Unzip the folder. Extract the ZIP so that you have a folder containing SKILL.md.
- 3Place the folder. Move the folder to ~/.claude/skills/ for all projects, or to .claude/skills/ inside one project.
- 4Install Python packages. Run pip install pandas numpy, the dependencies the file lists.
- 5Make a request. Ask about a takeover, shareholder share change, incentive plan, private placement or ST warning, and paste the announcement text.
- 6Check the output. Review the event summary, signal rating and strategy suggestion, and verify every figure against the original announcement.
What the skill makes the agent do
The skill's source file is written in Chinese and describes event-driven analysis of company announcements. Its core idea is that announcements contain new information, the market takes time to absorb it, and returns around the event can differ from normal. The file lists five areas: merger and restructuring arbitrage, the signals in major shareholder and executive share changes, the reading of equity incentive plans, the effect of private placements and rights issues, and the avoidance or speculation around ST and delisting risk.
The file provides reference tables, formulas and a report template. For example, it gives a formula for a merger arbitrage spread, a table of how it rates insider share-change signals, checklists for judging an incentive plan, and a scoring idea for how a private placement's use of funds might be viewed. It does not fetch live data. The agent works from the announcement text and figures you give it, applying the file's framework.
Install the corporate-events skill
The skill is distributed as a ZIP file from the directory page. Download the ZIP and unzip it. The skill folder contains a file named SKILL.md, which is the only file listed for this skill. Place the unzipped folder in one of two locations: a personal skills folder at ~/.claude/skills/, which makes it available across your projects, or a project folder at .claude/skills/ inside a specific project, which limits it to that project.
If you use the Claude apps instead of a local folder, you can upload the skill under Settings → Capabilities → Skills.
- Personal install: put the unzipped folder in ~/.claude/skills/
- Project install: put the unzipped folder in .claude/skills/ within your project
- Claude apps: upload the skill under Settings → Capabilities → Skills
Install the Python dependencies
The file's dependencies section lists two Python packages, pandas and numpy. Install them with the command below. The file's own code does not require any data API key.
The file also mentions the tushare data API as an optional source for insider-trade, incentive and placement data. The notes say it provides those interfaces, but the file does not require a key in its own code. Treat tushare as something you would set up yourself if you want that data; the skill does not depend on it to give guidance.
pip install pandas numpyTrigger the skill with a natural request
You do not need a special command. The skill's description tells the agent when it applies: company events such as takeovers, major shareholder share changes, equity incentives, private placements and ST or delisting warnings on A-shares. Ask about one of those events and name the company or stock code, and the agent can load the framework.
Give the agent the announcement text or key facts from it, because the skill does not look anything up. The more specific your request, the more useful the structured output will be. Ask for the signal strength, the spread, or a report in the file's format.
- Example request: Analyse this controlling shareholder share-increase plan for a listed A-share company, rate the signal strength, and give an event report. Then paste the announcement.
- Example request: Calculate the merger arbitrage spread for this tender offer at 25 yuan with the stock at 23.5 yuan, assuming about three months to completion.
- Example request: Check this company's ST risk using these figures and tell me which warning category applies under the file's rules.
- Example request: Review this equity incentive plan and list its exercise price discount, vesting conditions and share source.
Read the output the skill produces
For event-driven reports, the file provides a template with four parts: an event summary (security, event type, date and scale), a signal assessment (strength, historical reference, certainty), a strategy suggestion, and risk notes. The strategy part can include entry timing, position size, holding period, stop-loss and take-profit levels.
The file's example figures are illustrative. The file itself says some of its historical return figures are unsourced, so check any number the agent gives you against an original source before relying on it.
- Event summary: security, event type, date and size
- Signal assessment: strength, historical reference and certainty
- Strategy suggestion: entry, position size, holding period, stop-loss and take-profit
- Risk notes: market-wide falls, slow execution of the event and sector valuation
Safety notes before you use it
The skill runs no scripts and makes no network requests. It is text guidance and reference tables. The main risks come from how the content is used. The file presents its strategies and position sizes as trading advice, and it states that the historical return figures are unsourced. It also warns that announcement data from third-party platforms lags, that the official exchange sites publish first, and that trading just before an announcement can be insider trading. It says event-driven strategies should keep single-event positions under 10%.
- No scripts are run and no network access is used
- Returns and position sizes in the file are presented as trading advice and some returns are unsourced
- Third-party data lags, so an arbitrage window may already be closed
- Trading around announcements carries insider-trading risk and possible regulatory scrutiny
- The rules and thresholds are specific to A-shares
Tips for better results
Paste the full announcement text rather than a summary, so the agent can check the terms such as the price, share count, vesting conditions and timing. Ask the agent to state which parts of the framework it applied, so you can check its reasoning. Keep the source announcement open next to the output, because the skill cannot confirm a fact that is not in your input.
Note that the file is written in Chinese. You can ask in English, but check that terms such as the warning categories and the stock exchange rules are translated correctly.
- Paste the full announcement text
- Ask which framework rules the agent applied
- Check each figure against the original announcement
- Expect Chinese terms from the source file
What people use it for
- Rating how strong a controlling shareholder's share-increase or share-decrease plan is, using the file's signal tables
- Estimating a merger arbitrage spread and an annualised figure from a tender offer price and the current share price
- Reviewing an equity incentive plan's exercise price, vesting conditions and share source against the file's checklist
- Screening holdings for ST or delisting risk using the file's warning categories and thresholds
- Producing a consistent event-driven research report for a team using the file's report template
Frequently asked questions
How do I install the corporate-events agent skill?
Download the ZIP from the directory page and unzip it. Place the folder in ~/.claude/skills/ for personal use or in .claude/skills/ inside a project. In the Claude apps, you can upload it under Settings → Capabilities → Skills.
What are the requirements for the corporate-events skill?
The file's dependencies section lists Python with pandas and numpy, installed with pip install pandas numpy. The tushare data API is optional and mentioned in the notes, but the file does not require a key in its own code.
Is the corporate-events skill free?
The source gives an MIT licence for the repository. The skill is a set of text guidelines, and the source does not mention any price. Check the license file in the repository for the terms.
Does the skill fetch live market data?
No. The skill is guidelines and reference tables and does not fetch live data itself. The file also notes that data sources such as tushare lag by T+1 or more.
Does it work outside China's stock market?
Not directly. The rules, thresholds and terminology are specific to A-shares, so they will not apply to other markets without changes.
What are alternatives if I need live data or a non-China market?
The source does not name alternatives, so I can't recommend specific products from it. You would need a tool that supplies live announcement and market data for your market and a framework written for it.
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
This skill suits quantitative or event-driven traders, finance students and analysts who study A-share announcements and want a consistent framework and report template. It is a poor fit for people without finance training, for non-China markets, or for anyone who needs real-time data, because its figures are partly unsourced and its data lags.
Download the skill