Guide · Agent skill

How to use the A股可转债分析 agent skill

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

The convertible-bond skill teaches an AI agent how to analyze Chinese A-share convertible bonds, which behave like a bond with a floor value plus an option to convert into the company's stock. After installing it, you can ask the agent for a structured analysis of a bond, a screen such as the double-low strategy, or an explanation of clauses like forced redemption. This guide covers what the skill does, how to install it, how to phrase requests, and the limits you should respect.

A股可转债分析HKUDS/Vibe-Trading · MIT Download the skill

Quick start

1Download the ZIP. Get the convertible-bond ZIP file from this page and save it to your computer.
2Unzip the folder. Extract the archive so you have a convertible-bond folder containing SKILL.md.
3Place it in a skills location. Move the folder to ~/.claude/skills/ for personal use, or to .claude/skills/ inside a project. In the Claude apps, upload it under Settings → Capabilities → Skills instead.
4Arrange market data. Prepare live prices and bond terms from the Tushare convertible bond interface or an equivalent source, or paste the numbers into the chat yourself.
5Ask a specific question. Name the bond and what you want, such as a valuation, a clause check or a double-low screen, and include the key numbers.
6Verify the output. Check the bond's terms and current data yourself before acting on any figure the agent gives.

What does the convertible-bond skill make the agent do?

The skill is a single instruction file, SKILL.md, that gives the agent a consistent framework for convertible bonds. It covers three-dimensional valuation (bond floor, conversion value and option value), clause analysis for downward resets, forced redemption and put-back, the double-low screen, and rotation rankings for choosing bonds.

It also provides a report template for one bond, with sections for basic data, the three valuation views, clause game analysis and an investment note.

Bond floor: the value of the bond's cash flows discounted at a yield rate.
Conversion value: 100 divided by the conversion price, times the current share price.
Option value: bond price minus the greater of bond floor and conversion value.
Clause reasoning: downward reset of the conversion price, forced redemption and put-back conditions.
Screens: double-low value (price plus conversion premium x 100) and a rotation framework across price, elasticity, safety, resets and the underlying stock.

How do you install the convertible-bond skill?

Download the ZIP file from this page and unzip it. Put the resulting convertible-bond folder in one of two places: your personal skills folder at ~/.claude/skills/, or a project-specific .claude/skills/ folder inside the project you work in. Keep the SKILL.md file inside that folder.

If you use the Claude apps instead of a folder, open Settings, go to Capabilities, then Skills, and upload the skill there.

Personal install: ~/.claude/skills/convertible-bond/
Project install: .claude/skills/convertible-bond/ inside your project
Claude apps: Settings → Capabilities → Skills, then upload

What do you need before using it?

The skill is guidance, not a data source. Its own file says it needs market data for live prices and bond terms, and it names the Tushare convertible bond data interface or an equivalent source. Without such data, the agent can only work from numbers you paste into the conversation.

The sample bond floor function is written in Python, so you need Python if you want to run that code yourself. The skill does not run scripts and does not use the network by itself.

Python, for the sample bond floor function
Tushare convertible bond interface or equivalent market data for live prices and terms
Your own check of each bond's terms, since clauses differ between bonds

How do you trigger the skill with natural requests?

You do not need special syntax. Ask in plain Chinese or English about convertible bonds, and the agent should apply the framework when the request matches the skill's topics. Name the bond or its code and say what you want: a valuation, a clause check, or a screen.

Include the numbers you have, such as the bond price, conversion price, share price and years remaining. The more specific the input, the more useful the output.

Analyze 某某转债 with the three-dimensional valuation and tell me the bond floor and option value.
Is the forced redemption risk on 某某转债 high? The stock is at 18 and the conversion price is 15.
Run a double-low screen on the bonds I paste below and rank the top 10.
Explain how a downward reset of the conversion price would change the conversion value of this bond.
Write a single-bond report for 某某转债 using the standard template.

Worked example: checking one bond

Suppose a bond has a face value of 100, a conversion price of 15.00 and a share price of 18.00. The conversion value is 100 / 15.00 x 18.00 = 120.00. If the bond trades at 125, the conversion premium is (125 - 120) / 120 x 100% = 4.17%. The double-low value is 125 + 4.17 = 129.17.

The bond floor depends on remaining coupons, remaining years and a discount rate. The skill's sample function takes a list of remaining coupon rates and a yield rate, with a default redemption price of 110. The skill notes the discount rate is around 2.5 to 4 percent, and its typical bond floor range is 85 to 100.

def bond_floor(coupon_rates: list, years_remaining: float,
               redemption_price: float = 110, yield_rate: float = 0.03) -> float:
    pv = sum(c * 100 / (1 + yield_rate)**i for i, c in enumerate(coupon_rates, 1))
    pv += redemption_price / (1 + yield_rate)**len(coupon_rates)
    return pv

How should you read the trigger clauses?

The skill's clause rules use 30 consecutive trading days as the observation window. Each clause has its own threshold, and individual bonds can differ, so always confirm the exact terms in the bond's documents.

Downward reset: the skill uses a trigger of 15 days in 30 where the closing price is below 85 percent of the current conversion price. Forced redemption: 15 days in 30 above 130 percent. Put-back: the skill describes the condition as the share price staying below 70 percent of the conversion price during the final two interest years.

Downward reset: 15 of 30 trading days below 85% of conversion price
Forced redemption: 15 of 30 trading days above 130% of conversion price
Put-back: stock below 70% of conversion price over the final two interest years

What are the safety notes and limits?

The skill is marked as not running scripts and not using the network. Its strategy engine is a stub with placeholder comments, so it does not give you a finished backtest. The historical ranges in the file, such as annual returns of 10 to 15 percent and maximum drawdowns of 8 to 15 percent, are rough references and are not live or verified results.

Credit risk is the biggest hazard according to the skill: it notes that A-share convertible bonds have had defaults, and low-rated bonds need caution. Liquidity is another issue, since small bonds may trade less than 1 million yuan a day.

Check the bond's own terms before any trade; the skill gives frameworks, not live data.
Watch forced redemption announcements: not converting or selling before the redemption date can mean large losses.
Small bonds may be hard to enter and exit in size.
Backtesting needs conversion prices and redemption and put-back data, which makes it harder than stock backtests.

What people use it for

Building a single-bond report with bond floor, conversion value, option value and clause risks.
Ranking a list of bonds by double-low value and filtering for remaining life and rating.
Checking whether a bond is near a downward reset, forced redemption or put-back trigger.
Studying how convertible bond valuation and clause mechanics work as a learning exercise.
Designing the logic for a screening or backtest pipeline, using the skill as a checklist.

Frequently asked questions

Is the convertible-bond skill free to use?

The source material does not state a price or licence terms beyond the MIT licence shown for the repository. Check the licence text in the source repository for the exact terms before reuse.

What do I need to install the convertible-bond skill?

You need the ZIP from this page and a place for it: ~/.claude/skills/ or a project's .claude/skills/ folder, or the Skills section under Settings → Capabilities in the Claude apps. Python is needed only if you want to run the sample bond floor function.

Does the skill include live bond prices?

No. The skill says it needs market data such as the Tushare convertible bond interface or an equivalent source for live prices and terms. You can also paste current numbers into your request.

How is this different from a general stock analysis skill?

This skill is specific to Chinese A-share convertible bonds and their clauses, such as downward resets, forced redemption and put-back. Stock-focused analysis does not cover the bond floor and option value framework the way this one does.

Why does the backtest not work out of the box?

The strategy engine in the file is a stub with placeholder comments. You would need to write the logic yourself and gather conversion price, redemption and put-back data for each bond.

Can I rely on the skill's historical return figures?

Treat them as rough references only. The file lists typical ranges, but it does not give a dated, verified backtest, so do not use them as predictions.

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

Use this skill if you research or trade Chinese convertible bonds and want a consistent checklist for valuation and clause analysis, or if you are learning how these bonds work. Pick something else if you need non-Chinese markets, live data built in, or a finished backtest, since this skill provides frameworks that you must verify against each bond's own terms.

Download the skill