
Serenity Skill
- 985 installs
- 3.7k repo stars
- Updated May 5, 2026
- muxuuu/serenity-skill
Helps with ai & agent building tasks.
About
serenity-skill is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted development.
- serenity-skill
- AI & Agent Building
- AI-coding skill
Serenity Skill by the numbers
- 985 all-time installs (skills.sh)
- +133 installs in the week ending Aug 4, 2026 (Skillselion tracking)
- Ranked #1,108 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/muxuuu/serenity-skill --skill serenity-skillAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 985 |
|---|---|
| repo stars | ★ 3.7k |
| Last updated | May 5, 2026 |
| Repository | muxuuu/serenity-skill ↗ |
What it does
Helps with ai & agent building tasks.
Files
Serenity.skill
Turn your investment agent into a supply-chain bottleneck hunter.
This skill is a public-material, methodology-only research workflow inspired by the public Serenity / @aleabitoreddit style: start from a market narrative, walk through the real system, find the scarce layer, verify it with hard evidence, then rank what deserves more attention.
It is an independent public-methodology project. Keep it focused on public evidence, research reasoning, and user-controlled decisions.
Core promise
Given an investment theme and market, run a source-backed supply-chain research workflow and return a clear, plain-language answer:
market story -> system change -> required parts -> supply-chain layers -> scarce constraints -> public companies -> evidence -> what the market may be missing -> what could prove the idea wrong
The answer should feel like a sharp research partner talking through the logic in normal language.
Default behavior
Deep research is the default.
When the user gives an investment theme, market, sector, ticker universe, company, or asks what is worth researching now, first run the research workflow before giving the final answer.
Use live sources whenever the request depends on current information: current prices, filings, earnings, announcements, orders, regulation, market structure, customer relationships, financing, or "now/latest/current/最值得买/现在/近期".
If tools are available, use web/search/filing/market-data/browser tools before ranking current securities. If live tools are unavailable, say which facts need checking and provide the exact source path to verify them.
For theme scans, rank the supply-chain layers before ranking companies. Start with the scarce-layer judgment, then explain which companies control or sit closest to those layers. Include at least one popular or obvious area that ranked lower and explain why.
For deep theme scans, avoid quick-answer behavior. When tools and runtime allow, build a candidate universe of at least 20 companies and inspect at least 25 sources before final ranking. If the run is shorter or tool-limited, label the answer as an initial pass and state which source checks remain.
Request router
Classify the request, then work in the matching mode.
- Theme scan: The user gives a market and theme, such as A-share AI semiconductors, HK robotics, US AI power equipment, CPO, advanced packaging, glass substrates, HBM, silicon photonics, data-center power, robotics, biotech manufacturing, or defense electronics. Run the full research workflow and return priority candidates.
- Single-company challenge: The user asks about one ticker/company. Determine the exact value-chain position, evidence quality, what the market may be missing, and what would make the idea weak.
- Candidate comparison: The user gives several companies. Compare them by chain position, evidence strength, scarcity, valuation pressure, timing, and risk.
- Research partner conversation: The user wants to think, learn, or discuss. Ask tight questions and push the idea toward evidence, chain position, and failure conditions.
- Learning mode: The user asks to learn the method. Ask one focused question per turn and walk from trend to system change to scarce layer to proof.
Research workflow
Run this workflow for theme scans, current opportunities, and candidate rankings.
1. Set the scope
- Market: US, Hong Kong, A-share, Taiwan, Japan, Korea, Europe, global, or private-company map.
- Theme: AI infrastructure, semiconductors, CPO, robotics, power, materials, equipment, healthcare manufacturing, defense, or another user-given topic.
- Time window: infer from the request when possible. Use 3-12 months for "now" unless the user says otherwise.
2. Translate the story into a system change
- What technical or economic change is driving demand?
- Which old design becomes strained?
- Which physical constraint matters most: power, latency, bandwidth, heat, yield, purity, reliability, cycle time, packaging density, regulation, or grid connection?
3. Map the value chain
- downstream demand
- system integrators
- modules/subsystems
- chips/devices
- process and packaging
- equipment and testing
- materials and consumables
- physical infrastructure
4. Find the scarce layer
- Look for low supplier count, long qualification, hard expansion, critical know-how, material purity, specialized equipment, customer certification, long lead times, or capacity reservations.
- Prefer less obvious upstream layers when the evidence supports them.
- Rank the layers before naming final companies. The user should see the system logic before the ticker list.
5. Build the company universe
- Include public and important private companies across multiple layers.
- For broad theme scans, aim for at least 20 candidates before filtering to the final 3-7.
- For cross-market work, include non-US listings when relevant.
- Classify each company in plain language: controls the scarce layer, supplies the scarce layer, benefits from the trend, has weak control, or mainly has a story.
6. Gather and grade evidence
- Prefer primary sources: filings, exchange documents, company announcements, transcripts, official orders, patents, standards, regulatory records, project filings.
- Use reputable media, trade publications, and specialist analysis as support.
- Treat social posts and KOL threads as lead generation. Use stronger sources for proof.
- For deep current scans, aim for at least 25 sources across filings, announcements, reports, exchange documents, credible media, and technical sources.
7. Rank priorities
- Rank by demand pressure, closeness to the scarce layer, supplier concentration, expansion difficulty, evidence quality, valuation gap, timing, and risk.
- Keep scarce-layer priority and company priority separate. Strong earnings momentum can rank below a tighter supply-chain layer.
- For every final top candidate, say exactly what part of the value chain it constrains or sits closest to.
- Use
scripts/serenity_scorecard.pyfor repeatable scoring when Python is available and the user wants a score.
8. Explain what could go wrong
- Describe the clearest situations that would show the idea is weak or wrong.
- Cover substitution, faster competitor expansion, weak demand, dilution, poor margins, governance, geopolitics, customer loss, and valuation already pricing in success.
9. Give the next research move
- End with concrete checks: filings, specific metrics, customer cross-checks, capacity evidence, contract evidence, valuation comparison, and near-term announcements to watch.
Evidence standards
For every top candidate in a current stock ranking, aim for:
- a plain-language answer to "what exactly does this company constrain?";
- at least two concrete evidence points;
- at least one strong source when possible: filing, exchange document, company IR, transcript, regulator/project document, patent/standard, or official order/contract;
- a clear note on evidence strength: strong, medium, weak, or unverified lead;
- the main reason the judgment could be wrong.
For current market claims, never rely only on memory.
Read references/evidence-ladder.md for source grading. Read references/market-source-playbook.md for US/HK/A-share/Taiwan/Japan/Korea/Europe source paths.
Communication style
Sound like a direct investment research partner:
- lead with the judgment;
- start theme scans with the scarce layers worth prioritizing;
- explain the reasoning chain in normal language;
- use tables only when they improve comparison;
- be skeptical of hype and crowded stories;
- give strong views when the evidence supports them;
- say exactly which proof is missing when the evidence is weak;
- respond in the user's language;
- use Chinese for Chinese market prompts unless the user asks otherwise.
Avoid report-like stiffness. Avoid jargon in final answers unless the user uses it first.
Use plain phrases:
- "产业链卡点" or "scarce layer" instead of "chokepoint" when writing Chinese.
- "市场可能没看清的地方" instead of "mispricing".
- "接下来可能让市场重新定价的事情" instead of "catalyst".
- "什么情况说明这个判断错了" for failure conditions.
- "优先研究名单" instead of "watchlist".
- "反方理由" or "最大风险" instead of "bear case".
When users ask "which is worth buying", give a ranked research priority and explain the decision chain. Keep trading decisions with the user.
For theme scans, the first answer block should usually look like:
Start with the layers: [layer 1], [layer 2], [layer 3]. The best research path is to find who controls the hard-to-scale parts.
Chinese:
先排产业链层级,再排公司。我会优先看这几层:[层级 1]、[层级 2]、[层级 3]。原因是这些地方更接近真实扩产约束。
For A-share AI semiconductor scans, a strong opening can be:
先看带宽和工艺约束,再看纯算力芯片。AI 需求继续扩张时,先紧起来的往往是内存互连、CMP/减薄、刻蚀和耗材这些决定供给能不能爬坡的环节。
The company ranking should usually include a field or sentence for:
what it constrains / where it sits / why it ranks here / evidence / main risk
Chinese:
卡住的环节 / 产业链位置 / 排序原因 / 证据 / 主要风险
Keep value-chain layers granular. Split mixed buckets such as "AI chips / CPU / GPU / IP / EDA" into smaller groups when the economics differ: compute chips, EDA/IP, memory/storage, equipment, materials, testing, packaging, optical links, PCB/CCL, power and cooling.
Research partner protocol
In conversation mode, push the user from story to evidence.
Useful questions:
- What exactly changed in the system?
- Which layer becomes harder to scale?
- Why would customers struggle to route around this company?
- What public evidence proves customer urgency?
- Is this company controlling a scarce layer, supplying one, or only benefiting from the theme?
- What does the market currently seem to price it as?
- What one fact would make you downgrade the idea?
Keep each turn focused. Ask one main question when the user wants guidance.
Read references/serenity-dialogue-protocol.md when the user wants ongoing discussion or method training.
Cross-market adaptation
The economic logic transfers across markets. The source toolkit changes.
- A-shares: 年报、半年报、季报、临时公告、交易所问询函、互动易/上证 e 互动、招投标、环评/能评、地方项目备案、专利、客户认证、海关数据、应收/存货/现金流、关联交易。
- Hong Kong: HKEX filings, annual/interim reports, placings, connected transactions, mainland policy exposure, liquidity, Southbound eligibility.
- US: SEC filings, earnings transcripts, investor presentations, S-3/ATM risk, insider transactions, customer concentration, estimate gaps.
- Taiwan/Japan/Korea/Europe: local exchange filings, monthly revenue or operating data where available, company IR, trade journals, export statistics, customer cross-checks, FX/geopolitical exposure.
Read references/market-source-playbook.md when market-specific evidence matters.
Risk boundary
Give research support, ranking, and reasoning. Keep final responsibility with the user.
Avoid:
- guaranteed return language;
- direct buy/sell commands;
- hype around illiquid names;
- rumor-based recommendations;
- material non-public information;
- invented prices, filings, customers, contracts, or market caps.
Use concise language when needed:
I will rank this by research priority. The trading decision is yours.
Read references/risk-and-compliance.md for high-risk situations.
Bundled resources
Load only what is needed:
references/deep-research-workflow.md— detailed workflow for source-backed theme scans.references/evidence-ladder.md— source grading and evidence standards.references/market-source-playbook.md— source paths by market.references/serenity-dialogue-protocol.md— research partner and learning-mode behavior.references/output-style-and-language.md— plain-language output contract.references/public-profile-and-evaluation.md— public profile, outside evaluation, and reliability notes.references/research-sources.md— source map used by the project.references/risk-and-compliance.md— investment research boundaries.assets/thesis-template.md— reusable thesis memo template.assets/bottleneck-scorecard.json— JSON input template for the scorecard.assets/research-prompt-pack.md— prompts for users who want explicit task starters.scripts/serenity_scorecard.py— local scoring script.scripts/validate_skill.py— local Agent Skill structure validator.examples/a-share-ai-semiconductor-demo.md— A-share AI semiconductor example shape.examples/ai-infrastructure-chokepoint-demo.md— end-to-end example.evals/test-cases.md— trigger and behavior tests.
.DS_Store
__pycache__/
*.pyc
.env
.venv/
interface:
display_name: "Serenity.skill"
short_description: "Turns investment agents into supply-chain bottleneck hunters"
brand_color: "#111827"
default_prompt: "Use serenity-skill to deeply research a market theme, map the value chain, find scarce layers, rank research priorities, explain the evidence, and say what could prove the view wrong."
policy:
allow_implicit_invocation: true
dependencies:
tools: []
{
"ticker": "EXAMPLE",
"company": "Example Co",
"market": "US/HK/A-share/Taiwan/Japan/Korea/Europe",
"notes": "Replace ratings with 0-5 scores. 0 = absent, 5 = very strong.",
"factors": {
"demand_inflection": 0,
"architecture_coupling": 0,
"chokepoint_severity": 0,
"supplier_concentration": 0,
"expansion_difficulty": 0,
"evidence_quality": 0,
"valuation_disconnect": 0,
"catalyst_timing": 0
},
"penalties": {
"dilution_financing": 0,
"governance": 0,
"geopolitics": 0,
"liquidity": 0,
"hype_risk": 0,
"accounting_quality": 0,
"cyclicality": 0,
"alternative_design_risk": 0
},
"evidence": [
{
"claim": "",
"source": "",
"strength": "primary/media/analysis/social/rumor"
}
],
"what_could_weaken_view": [
"",
"",
""
]
}
Serenity.skill Prompt Pack
Use these prompts when you want to start quickly.
Deep theme research
Use serenity-skill to deeply research [market] [theme].
Map the value chain, investigate current sources, find the scarce layers,
build a broad candidate universe, rank the top research priorities, explain what each company constrains,
explain the evidence, and say what could prove each idea wrong.A-share scan
用 serenity-skill 深度调研现在 A 股 [行业/主题]。
请联网查公告、财报、问询函、互动易、招投标、环评/能评、专利、客户认证和财务质量,
先排产业链层级,再找 5 个最值得优先研究的标的,并说明卡住的环节、产业链位置、证据、排序理由和主要风险。Hong Kong scan
用 serenity-skill 研究港股 [主题]。
重点过滤流动性、配售融资、关联交易、内地政策暴露、南向资金和估值重新定价条件。
给出优先研究排序和下一步核验路径。US scan
Use serenity-skill to research US-listed [theme] companies.
Check SEC filings, transcripts, customer concentration, financing risk, margin evidence,
and the parts of the value chain investors may be underpricing.Single-company challenge
Use serenity-skill to challenge [company/ticker].
Where does it sit in the value chain? Does it control a scarce layer?
What evidence supports the idea, what evidence is missing, and what would weaken the judgment?Compare candidates
Use serenity-skill to compare [A], [B], and [C].
Rank them by supply-chain position, evidence quality, customer urgency, valuation pressure,
main risk, and next verification step.Research partner mode
用 serenity-skill 陪我讨论 [主题/公司]。
不要直接写报告,每轮先给判断,再问我一个最关键的问题,带我从故事拆到产业链卡点和证据。Scorecard
Use serenity-skill's local scorecard to score [company].
Explain every rating in plain language and mark the evidence as strong, medium, weak, or needs checking.Serenity.skill Thesis Template
Use this template when the user asks for a structured memo. For normal chat, answer in prose.
Direct view
Priority: Low / Medium / High / Top priority
Confidence: Low / Medium / High
Time horizon: 3 months / 12 months / multi-year
Trend
What demand wave is forcing the change?
System change
What technical or economic constraint is becoming harder to scale?
Value-chain map
End demand -> system -> module -> component -> process -> equipment/material -> infrastructureCandidate position
Company: Ticker: Market: Layer: Plain-language role:
Evidence
| Evidence | Source | Strength | What it supports | What still needs checking |
|---|
What the market may be missing
Current market category:
Possible new category:
Why investors may be slow:
Financial quality
Revenue mix:
Gross margin:
Cash flow:
Capex need:
Financing risk:
Customer concentration:
Inventory/receivables:
What could make the market reprice it
| Event | Expected window | Evidence to monitor | Confidence |
|---|
What could weaken the view
1. 2. 3.
Next research actions
1. 2. 3. 4. 5.
Changelog
1.0.0 — 2026-05-04
- Reworked the Skill around a default deep-research workflow.
- Added source-backed theme scanning, current-data rules, and plain-language output guidance.
- Added research-partner conversation behavior for idea discussion and method training.
- Added market-specific source paths and evidence grading references.
- Updated README.md as the English GitHub entry point and added README.zh-CN.md.
- Added an AI infrastructure value-chain demo.
- Removed launch-copy and social-post drafts from the Skill package.
Contributing
Serenity.skill accepts contributions that improve research discipline, source quality, cross-market adaptation, examples, and local tooling.
Good contributions
- Better source checklists for a market or sector.
- Clearer evidence standards for technology and supply-chain claims.
- Stronger examples that show normal research-partner communication.
- Deterministic scripts that use local inputs.
- Source-map updates with primary filings, exchange documents, or official company materials.
Contribution rules
- Keep the project methodology-focused.
- Keep user-facing language plain and practical.
- Mark social/KOL material as lead generation.
- Prefer primary sources for company-specific claims.
- Avoid private information, doxxing, holdings claims, and unverified personal details.
- Avoid buy/sell commands, guaranteed-return language, and coordinated trading language.
- Avoid scripts that read secrets, access wallets, place trades, or make hidden network calls.
Suggested PR checklist
- [ ]
python scripts/validate_skill.py .passes. - [ ] New files are referenced from README or SKILL.md when useful.
- [ ] Company-specific examples include uncertainty and what would weaken the view.
- [ ] No API keys, secrets, wallet addresses, or private data.
Evaluation Test Cases
Use these prompts to test triggering, research behavior, and communication style.
Test 1: Current A-share theme scan
Prompt:
用 serenity-skill 深度调研现在 A 股 AI 半导体产业链,找 5 个最值得优先研究的标的。Expected behavior:
- Uses live sources when tools are available.
- Ranks supply-chain layers before ranking companies.
- Explains at least one popular or obvious area that ranked lower.
- Builds a broad candidate universe before filtering when tools/runtime allow.
- Aims for 25+ sources for a deep current scan, or labels the answer as an initial pass.
- For each final company, states what exact part of the value chain it constrains.
- Splits broad buckets such as AI chips, EDA/IP, memory interconnect, equipment, materials, OSAT, optical links, and PCB/CCL when their economics differ.
- Checks A-share-specific sources: 公告、财报、问询函、互动易、招投标、环评/能评、专利、客户认证、财务质量。
- Gives a ranked priority list in plain Chinese.
- Explains evidence strength, main risks, and next checks.
- Uses "优先研究" language for trading-adjacent requests.
Test 2: Single-company challenge
Prompt:
这家公司说自己是 CPO 核心供应商,用 serenity-skill 挑战一下。Expected behavior:
- Asks for or infers the exact value-chain layer.
- Checks customer validation, design wins, capacity, margins, revenue mix, and substitute suppliers.
- Answers conversationally.
- Explains what would make the judgment weaker.
Test 3: Hype control
Prompt:
这个小票被大 V 点名了,马上梭哈可以吗?Expected behavior:
- Pulls the user back to evidence, liquidity, dilution, valuation, and company facts.
- Avoids group-buying or hype language.
- Gives a research path and risk framing.
Test 4: Cross-market source path
Prompt:
把同一个 AI 光通信产业链思路迁移到港股和日股,先告诉我应该查哪些资料。Expected behavior:
- Names HKEX, annual/interim reports, placings, connected transactions, mainland policy exposure for Hong Kong.
- Names TDnet, earnings materials, integrated reports, segment disclosures, trade journals, currency sensitivity for Japan.
- Explains source differences in plain language.
Test 5: Research partner mode
Prompt:
带我训练 Serenity 式研究方法,每次只问一个问题。Expected behavior:
- Starts with one focused question.
- Moves from demand wave to system change to scarce layer to proof.
- Avoids long report output.
Test 6: Plain-language output
Prompt:
用 serenity-skill 给我讲讲先进封装设备为什么可能值得看,别写成报告。Expected behavior:
- Leads with a clear view.
- Uses normal language.
- Avoids heavy jargon.
- Explains what evidence to check and what would weaken the view.
Demo: A-Share AI Semiconductor Scan
This is a dated example output shape for a tool-using run. Current facts, valuation, and ranking should be refreshed with live sources before use.
Prompt
用 serenity-skill 深度调研现在 A 股 AI 半导体产业链,找 5 个最值得优先研究的标的。Example answer shape
先看带宽和工艺约束,再看纯算力芯片。AI 需求继续扩张时,先紧起来的往往是内存互连、CMP/减薄、刻蚀和耗材这些决定供给能不能爬坡的环节。
先排产业链层级,再排公司。我会把优先级放在:内存互连芯片、CMP/减薄、关键刻蚀设备、CMP/电镀耗材、先进封测。纯 AI 芯片和光模块业绩弹性强,但估值和拥挤度更高,适合作为景气度温度计。
| 标的 | 卡住的环节 | 为什么排这里 | 关键证据 | 主要风险 |
|---|---|---|---|---|
| 澜起科技 | AI 服务器 DDR5、MRDIMM、PCIe/CXL 互连 | 带宽升级绕不开,报表能看到互连产品变化 | 季报、年报、IR 中的产品线收入和毛利率 | 新子代迭代放缓,互连收入占比停滞 |
| 华海清科 | CMP、减薄、边抛、划切 | 贴近 HBM、先进封装、3D IC 的工艺瓶颈 | 年报中的 CMP 出机、客户验证、减薄设备进展 | 客户重复订单放缓,扩产摊薄收益 |
| 中微公司 | 高深宽比刻蚀、先进逻辑/存储关键刻蚀 | 先进制程和高端存储扩产落到设备验证 | 反应台量产、客户产线、刻蚀收入增长 | 验证周期延长,研发投入转订单速度变慢 |
| 安集科技 | CMP 抛光液、湿电子化学品、电镀添加剂 | 耗材是复购型卡点,先进制程步骤增加会抬升需求 | 年报中的 CMP、湿电子、电镀产品进展 | 客户二供压价,新品认证转量产慢 |
| 通富微电 | AI/HPC 封测和先进封装产能 | Chiplet、Bumping、FCBGA、3nm 相关验证带来弹性 | 年报、募集说明书、问询回复中的客户和扩产信息 | 客户集中、再融资摊薄、毛利率兑现慢 |
我的跟踪顺序会很明确:先看澜起互连产品收入占比和毛利率,再看华海清科 HBM/CMP 重复订单,其次看中微高深宽比刻蚀的客户扩展,最后用安集和通富验证先进封装扩张是否真的进入耗材和封测报表。
Why this is a good Skill output
- It starts from physical and process constraints.
- It ranks layers before companies.
- It downgrades popular crowded areas with a reason.
- It explains what each company constrains.
- It uses normal research-partner language.
Demo: AI Infrastructure Chokepoint Research
This is an abbreviated example of the expected output style. Run the Skill with live web/search/filing tools for current company facts and ticker-level rankings.
Prompt
Use serenity-skill to deeply research AI infrastructure opportunities.
Map the value chain, investigate current sources, find the scarce layers,
rank the top research priorities, explain the evidence, and say what could prove each idea wrong.Example answer shape
I would rank layers first, then companies. For AI infrastructure, the first layers I would inspect are optical interconnect, advanced packaging, data-center power, and thermal management. They sit closer to real deployment constraints than the broad AI application layer, and they are easier to verify through orders, capacity, qualification, margins, and customer commitments.
The first place I would look is optical interconnect. AI clusters keep pushing bandwidth and power limits, so the market eventually has to care about the parts that make higher-speed connections possible: lasers, optical engines, DSP/ASICs, testing, packaging, substrates, and qualified manufacturing capacity. The strongest candidates usually control one of those narrow layers and show real customer evidence behind the AI exposure.
The second place is advanced packaging. More compute density raises the value of substrate, interposer, bonding, inspection, test, and packaging capacity. I would rank a company higher if it has customer qualification, capacity expansion tied to real demand, margin evidence, and a role that customers cannot easily replace.
The third place is data-center power. AI capex eventually turns into power delivery, transformers, switchgear, power modules, backup systems, and grid connection work. This layer may have less story-driven upside than optical or packaging, but it can have stronger demand visibility.
The fourth place is thermal management. Liquid cooling and high-density racks can create opportunities, but this layer needs careful filtering because many suppliers can claim exposure. I would want proof through design wins, customer concentration, revenue mix, and margin changes.
I would put broad AI software and generic component stories lower in the first pass. They can still work as stocks, but they usually reveal less about the physical expansion constraint than equipment, materials, packaging, power, and qualification bottlenecks.
Compact ranking example
| Priority | Layer | Why it matters | Evidence to check first | What could weaken it |
|---|---|---|---|---|
| 1 | Optical interconnect | Bandwidth and power limits force upgrades | customer qualification, capacity bookings, product ramps, margin change | customers delay CPO/LPO adoption or qualify many alternate suppliers |
| 2 | Advanced packaging | Compute density depends on packaging and test capacity | capex tied to customer demand, utilization, backlog, yield progress | capacity expands faster than demand or pricing power stays weak |
| 3 | Data-center power | AI buildout needs power delivery and grid hardware | orders, backlog, lead times, utility/hyperscaler projects | revenue growth already fully priced or supply catches up |
| 4 | Thermal management | Rack density creates cooling demand | design wins, revenue mix, customer qualification | competition makes the product commodity-like |
Final research move
I would verify the top layer first. For optical interconnect, check current company filings, product qualification updates, customer or partner announcements, capacity expansion, gross margin, and whether revenue is moving from legacy business into the AI infrastructure chain. A company moves up the priority list when the evidence shows real customer urgency behind the AI language.
Demo Conversation
Example 1: A-share Sector Scan
User:
用 Serenity 的方式帮我研究 A 股机器人产业链,找最值得优先研究的方向。
Agent:
先排产业链层级,再排公司。我会优先看执行器、减速器、力矩传感、灵巧手、控制器和测试校准这几层。机器人整机故事很容易热,但真正有研究价值的地方通常在量产难、认证慢、良率和一致性要求高的环节。
第一优先级我会放在执行器和精密传动链。原因是下游放量时,客户要的是稳定供货、寿命、噪音、精度和成本同时满足。这个环节如果只有少数供应商能稳定交付,就容易形成产业链卡点。
A 股里筛公司时,我会先查这些证据:公告里的客户认证、招投标或订单、产能扩张进度、应收和存货质量、毛利率变化。只有机器人概念的公司,我会放低优先级;客户和财务证据会决定它能不能往前排。
下一步我会把候选公司按执行器、传感器、控制器、加工设备、测试校准分层,再逐家公司查公告和财务质量。Example 2: Single Company Challenge
User:
这家公司说自己是 CPO 核心供应商,能不能重点看?
Agent:
可以重点查,但第一步要把“CPO 核心供应商”拆开。这个标签本身说明不了太多,关键是它到底卡在哪一层。
我会先确认它提供的是激光、硅光代工、DSP、封装、测试、FAU、材料,还是普通组件。越靠近客户短期绕不开的环节,研究优先级越高。
支持它进入高优先级的证据应该包括:明确客户认证、量产订单、产能锁定、毛利率改善、收入结构变化,或者上下游公告可以交叉验证的合作关系。
这个判断最容易错在三点:客户可以换供应商,CPO 推进节奏慢于预期,或者公司融资稀释把经营弹性抵消掉。先查公告、电话会、客户验证和财务质量,再决定它排第几。Example 3: Research Partner Mode
User:
我想学习这种产业链研究方法。
Agent:
我们先拿 AI 数据中心电力链练。
第一问:AI 数据中心继续扩张时,你认为最先被物理约束卡住的是芯片、网络、散热、电力接入、变压器、开关设备、土地,还是审批?
你先选一个环节。我会带你继续往上游拆供应商、客户证据和财务信号。MIT License
Copyright (c) 2026 muxu
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Serenity.skill
Turn your investment agent into a supply-chain bottleneck hunter.
Give it a market theme. It investigates live sources, maps the value chain, finds scarce constraints, ranks public-company research priorities, and writes the strongest reasons the idea could fail before you chase the story.
中文 README
market story -> system change -> required parts -> supply-chain layers
-> scarce constraints -> public companies -> evidence -> repricing path
-> what could prove the idea wrongWhat It Does
Serenity.skill is an Agent Skill for tool-using investment research agents.
It helps an agent move from broad market narratives to evidence-backed research priorities:
- Deep theme research across AI infrastructure, semiconductors, CPO, advanced packaging, power equipment, robotics, materials, testing, and other supply-chain-heavy sectors.
- Cross-market candidate discovery for US, Hong Kong, A-share, Taiwan, Japan, Korea, and Europe.
- Single-company thesis challenges: exact chain position, evidence quality, customer dependence, substitution risk, financing risk, and what the market may be missing.
- Research partner conversations that push ideas from story to proof.
- Local scoring through a standard-library Python scorecard.
The Skill works best when the host agent has web search, browser, filings, market-data, and Python access. Local scripts use only local inputs.
Quick Start
Codex / OpenAI Agent Skills / Generic Agent Skills Clients
User-level install:
SKILL_DIR="$HOME/.agents/skills/serenity-skill"
mkdir -p "$SKILL_DIR"
cp -R SKILL.md LICENSE references assets scripts examples agents "$SKILL_DIR"/Project-level install:
SKILL_DIR=".agents/skills/serenity-skill"
mkdir -p "$SKILL_DIR"
cp -R SKILL.md LICENSE references assets scripts examples agents "$SKILL_DIR"/Claude Code
User-level install:
SKILL_DIR="$HOME/.claude/skills/serenity-skill"
mkdir -p "$SKILL_DIR"
cp -R SKILL.md LICENSE references assets scripts examples agents "$SKILL_DIR"/Project-level install:
SKILL_DIR=".claude/skills/serenity-skill"
mkdir -p "$SKILL_DIR"
cp -R SKILL.md LICENSE references assets scripts examples agents "$SKILL_DIR"/Hermes Agent
SKILL_DIR="$HOME/.hermes/skills/research/serenity-skill"
mkdir -p "$SKILL_DIR"
cp -R SKILL.md LICENSE references assets scripts examples agents "$SKILL_DIR"/OpenClaw / Other AgentSkills-Compatible Clients
Place SKILL.md, LICENSE, references/, assets/, scripts/, examples/, and agents/ in the client's serenity-skill/ directory. README and project-maintenance docs are for the GitHub repository and do not need to be installed into the runtime skill directory.
Try It
Use serenity-skill to deeply research A-share AI semiconductor opportunities.
Map the value chain, investigate current sources, rank the top research priorities,
explain the evidence, and say what could prove each idea wrong.Use serenity-skill to challenge this company's CPO supplier thesis.
Where does it sit in the chain, what evidence supports it, and what would weaken the idea?用 serenity-skill 深度调研现在 A 股 AI 半导体产业链,
找 5 个最值得优先研究的标的,给出产业链位置、证据、排序理由和主要风险。Example Output Style
The Skill aims for normal research-partner language:
I would prioritize advanced packaging equipment, optical-interconnect upstream materials,
and AI server power components. They sit closer to real expansion constraints than the
obvious AI ticker basket.
The first group ranks higher because capacity qualification and customer validation
can take time, and public markets often recognize the downstream demand before they
price the upstream constraint.
The main thing that would weaken this view is simple: if customers can qualify alternate
suppliers faster than expected, the scarce-layer logic fades.Chinese outputs use the same style:
我会优先看三层:先进封装设备、光通信上游材料、AI 服务器电源链。
原因是它们更接近真实扩产约束,市场也更容易先定价下游故事,再回头找上游卡点。
第一优先级要查的是客户认证和产能证据。故事之外还需要订单、认证、毛利率或收入结构变化,
否则这个标的只能算线索。Local Scorecard
Generate a template:
python scripts/serenity_scorecard.py --template > my-company.jsonRun a score:
python scripts/serenity_scorecard.py --format md my-company.jsonValidate the Skill package:
python scripts/validate_skill.py .Repository Layout
serenity-skill/
├── SKILL.md
├── README.md
├── README.en.md
├── README.zh-CN.md
├── LICENSE
├── agents/
│ └── openai.yaml
├── references/
│ ├── deep-research-workflow.md
│ ├── evidence-ladder.md
│ ├── market-source-playbook.md
│ ├── serenity-dialogue-protocol.md
│ ├── output-style-and-language.md
│ ├── public-profile-and-evaluation.md
│ ├── research-sources.md
│ └── risk-and-compliance.md
├── assets/
│ ├── bottleneck-scorecard.json
│ ├── research-prompt-pack.md
│ └── thesis-template.md
├── scripts/
│ ├── serenity_scorecard.py
│ └── validate_skill.py
├── examples/
│ ├── a-share-ai-semiconductor-demo.md
│ ├── ai-infrastructure-chokepoint-demo.md
│ └── demo-conversation.md
└── evals/
└── test-cases.mdBoundary
This is an independent public-methodology project inspired by public Serenity / @aleabitoreddit research patterns. It supports research, ranking, and reasoning. It has zero broker access, zero wallet access, and zero trade execution.
Company facts should come from filings, exchange documents, company announcements, transcripts, regulatory/project records, patents, standards, reputable media, and specialist analysis.
License
MIT
<div align="center">
Serenity.skill
让 AI 用 Serenity 式投研方法,筛出上涨逻辑更清楚的股票和基金方向
   
</div>
看到 AI 半导体、机器人、CPO、算力、电力设备、创新药这些热点,很多人能感受到热度,却很难判断该看哪条产业链、哪类公司、哪只股票、哪个基金方向。
Serenity.skill 把 Serenity / @aleabitoreddit 公开内容中可观察到的投研路径做成 Agent Skill。它会从热点出发,拆产业链,找供应链瓶颈,筛候选公司和基金方向,再检查公告、财报、客户、产能和风险,最后整理成一份优先研究清单。
它的工作方式很简单:先把热点拆开,看真实需求在哪里,再看哪个环节更难扩产、更难替代,最后回到股票和基金方向,判断哪些线索更值得继续深挖。
它适合面对热点信息流、希望建立系统筛选流程的投资者:让 AI 先完成第一轮深度研究,把模糊热度变成有逻辑、有证据、有风险边界的研究方向。
Research support only. Serenity.skill 负责研究、排序和推理;最终买卖决策由你自己决定。
为什么是 Serenity 式方法
Serenity / @aleabitoreddit 在公开内容中长期围绕 AI、半导体、光通信、机器人等科技主题做供应链研究。他的核心思路很清楚:大行情里真正有价值的机会,常常藏在系统扩张时最难绕开的关键环节。
Serenity.skill 复用的是这套公开方法论中的研究路径:
- 从大热点开始,先看真实需求来自哪里。
- 把主题拆成下游需求、系统集成、芯片/器件、设备、材料、封测、基础设施。
- 找低供应商数量、长验证周期、扩产困难、客户认证严格、材料纯度要求高的环节。
- 再回到股票和基金方向,判断谁更靠近真实瓶颈,谁主要只是蹭主题。
- 最后检查公告、财报、问询函、订单、产能、客户和风险,给出优先研究排序。
这个仓库做的是公开资料研究工具。它吸收 Serenity 式研究的结构化思路,同时要求所有公司判断回到公告、交易所文件、财报、电话会、监管/项目文件、专利、标准、可信媒体和专业分析。
它能帮你做什么
| 你现在遇到的问题 | 可以这样问 AI | Serenity.skill 会帮你看什么 |
|---|---|---|
| 刷到一个热点,感觉全网都在说,自己不知道从哪下手 | 最近 AI 半导体很火,普通人应该先研究哪些方向? | 先拆产业链,再把更接近真实需求和扩产瓶颈的方向排出来 |
| 想买机器人方向,分不清整机、零部件、减速器、传感器谁更关键 | 机器人产业链里,哪些环节更可能先出机会? | 比较不同环节的供需紧张度、竞争格局和证据强弱 |
| 看到别人推荐一只股票,担心它只是蹭热点 | 帮我挑战这家公司是不是 CPO 核心供应商 | 查它在产业链里的真实位置、客户证据、收入质量和主要风险 |
| 想买主题基金或 ETF,分不清哪个细分方向更值得看 | 机器人主题基金应该重点看哪些上游环节? | 找基金背后的核心受益链条,提示需要核验的持仓方向 |
| 手里有几只候选股,想让 AI 帮你排个研究顺序 | 比较 A、B、C 三家公司,谁的上涨逻辑更清楚? | 按产业链位置、证据强度、估值压力、风险点做优先级排序 |
| 每天刷消息很焦虑,想建立一套固定筛选流程 | 带我学 Serenity 式产业链研究,每次只问我一个问题 | 从热点、需求、卡点、证据、风险一步步建立研究框架 |
直接复制这个 Prompt
用 serenity-skill 深度调研现在 A 股 AI 半导体产业链。
请联网查公告、财报、问询函、互动易、招投标、环评/能评、专利、客户认证和财务质量,
先排产业链层级,再找 5 个最值得优先研究的标的,
并说明卡住的环节、产业链位置、证据、排序理由和主要风险。用 serenity-skill 帮我研究最近机器人方向。
先拆产业链,再判断哪些环节更接近真实供需瓶颈,
最后给出股票和基金方向的优先研究清单。用 serenity-skill 挑战 [公司/股票代码]。
它到底卡在哪一层?证据够不够?市场可能高估了什么?
什么情况说明这个判断应该降级?更多可复制模板见 assets/research-prompt-pack.md。
输出长什么样
我会先看 [方向 A],再看 [方向 B] 和 [方向 C]。
如果你想找股票线索,我会优先研究这几家公司:
1. [公司 A]:最接近 [关键瓶颈环节],上涨逻辑来自 [需求增长/产能紧张/客户验证/国产替代]。
2. [公司 B]:处在 [产业链位置],适合跟踪 [订单/毛利率/产能利用率]。
3. [公司 C]:弹性更大,但需要确认 [核心风险或缺失证据]。
如果你更想买基金或 ETF,我会先看暴露在 [细分方向 A] 和 [细分方向 B] 的产品,
再检查它们的前十大持仓里有没有 [公司 A]、[公司 B] 这类真正靠近瓶颈的公司。
我会暂时降低 [热门方向 X] 的优先级,因为它的故事很热,但现在还缺 [订单证据/利润兑现/客户认证]。
下一步先查三件事:
1. [公司 A] 最新财报里 [关键业务] 的收入和毛利率有没有变化。
2. [公司 B] 有没有新的客户认证、订单或扩产公告。
3. [相关基金/ETF] 的持仓是不是集中在真正受益的环节。完整示例:
- A 股 AI 半导体扫描
- AI 基建瓶颈研究
- 研究伙伴式对话
安装
Codex / OpenAI Agent Skills / 通用 Agent Skills 客户端
用户级安装:
SKILL_DIR="$HOME/.agents/skills/serenity-skill"
mkdir -p "$SKILL_DIR"
cp -R SKILL.md LICENSE references assets scripts examples agents "$SKILL_DIR"/项目级安装:
SKILL_DIR=".agents/skills/serenity-skill"
mkdir -p "$SKILL_DIR"
cp -R SKILL.md LICENSE references assets scripts examples agents "$SKILL_DIR"/Claude Code
用户级安装:
SKILL_DIR="$HOME/.claude/skills/serenity-skill"
mkdir -p "$SKILL_DIR"
cp -R SKILL.md LICENSE references assets scripts examples agents "$SKILL_DIR"/项目级安装:
SKILL_DIR=".claude/skills/serenity-skill"
mkdir -p "$SKILL_DIR"
cp -R SKILL.md LICENSE references assets scripts examples agents "$SKILL_DIR"/Hermes Agent
SKILL_DIR="$HOME/.hermes/skills/research/serenity-skill"
mkdir -p "$SKILL_DIR"
cp -R SKILL.md LICENSE references assets scripts examples agents "$SKILL_DIR"/OpenClaw / 其他 AgentSkills-compatible 客户端
把 SKILL.md、LICENSE、references/、assets/、scripts/、examples/、agents/ 放进对应客户端的 serenity-skill/ 目录即可。README 和项目维护文档只用于 GitHub 展示,不需要安装到运行目录。
本地瓶颈打分
生成模板:
python scripts/serenity_scorecard.py --template > my-company.json运行评分:
python scripts/serenity_scorecard.py --format md my-company.json校验 Skill:
python scripts/validate_skill.py .仓库结构
serenity-skill/
├── SKILL.md
├── README.md
├── README.en.md
├── README.zh-CN.md
├── references/
│ ├── deep-research-workflow.md
│ ├── evidence-ladder.md
│ ├── market-source-playbook.md
│ ├── public-profile-and-evaluation.md
│ └── risk-and-compliance.md
├── assets/
│ ├── bottleneck-scorecard.json
│ ├── research-prompt-pack.md
│ └── thesis-template.md
├── scripts/
│ ├── serenity_scorecard.py
│ └── validate_skill.py
├── examples/
│ ├── a-share-ai-semiconductor-demo.md
│ ├── ai-infrastructure-chokepoint-demo.md
│ └── demo-conversation.md
└── evals/
└── test-cases.md研究边界
Serenity.skill 是独立的公开方法论项目,灵感来自 Serenity / @aleabitoreddit 公开内容中可观察到的研究范式。它帮助做研究、排序和推理,功能范围限于研究辅助。
它提供研究优先级、证据链、风险核验和下一步检查清单。交易执行、账户操作、收益承诺和最终买卖判断始终由用户自己控制。
强结论应以公告、交易所文件、财报、电话会、监管/项目文件、专利、标准、可信媒体和专业分析为依据。社交媒体内容适合作为线索来源,最终判断要回到更强证据。
License
MIT
Serenity.skill
把你的投资 Agent 变成产业链瓶颈猎人。
给它一个市场和方向,它会联网查资料、拆产业链、找供应链卡点、筛上市公司、给出优先研究排序,并说明这个判断最容易错在哪里。
English README
市场故事 -> 系统变化 -> 必要零部件 -> 产业链层级
-> 供应链卡点 -> 上市公司 -> 证据 -> 市场可能没看清的地方
-> 什么情况说明这个判断错了它能做什么
Serenity.skill 是一个给投资研究 Agent 用的 Skill。它的重点是让 Agent 先研究系统,再讨论股票。
它适合这些任务:
- 深度调研 AI 基建、半导体、CPO、先进封装、电力设备、机器人、材料、测试设备等产业链方向。
- 在美股、港股、A 股、台股、日股、韩股、欧股里做候选公司筛选。
- 挑战单家公司 thesis:它到底卡在哪一层,证据强度够不够,客户是否绕得开,融资和治理风险有多大。
- 像研究伙伴一样聊天:把想法从“故事”推到“证据”。
- 用本地 Python 脚本做瓶颈控制力打分。
它最适合带有联网、浏览器、财报公告、市场数据和 Python 工具的 Agent 环境。仓库里的脚本只处理本地输入。
快速安装
Codex / OpenAI Agent Skills / 通用 Agent Skills 客户端
用户级安装:
SKILL_DIR="$HOME/.agents/skills/serenity-skill"
mkdir -p "$SKILL_DIR"
cp -R SKILL.md LICENSE references assets scripts examples agents "$SKILL_DIR"/项目级安装:
SKILL_DIR=".agents/skills/serenity-skill"
mkdir -p "$SKILL_DIR"
cp -R SKILL.md LICENSE references assets scripts examples agents "$SKILL_DIR"/Claude Code
用户级安装:
SKILL_DIR="$HOME/.claude/skills/serenity-skill"
mkdir -p "$SKILL_DIR"
cp -R SKILL.md LICENSE references assets scripts examples agents "$SKILL_DIR"/项目级安装:
SKILL_DIR=".claude/skills/serenity-skill"
mkdir -p "$SKILL_DIR"
cp -R SKILL.md LICENSE references assets scripts examples agents "$SKILL_DIR"/Hermes Agent
SKILL_DIR="$HOME/.hermes/skills/research/serenity-skill"
mkdir -p "$SKILL_DIR"
cp -R SKILL.md LICENSE references assets scripts examples agents "$SKILL_DIR"/OpenClaw / 其他 AgentSkills-compatible 客户端
把 SKILL.md、LICENSE、references/、assets/、scripts/、examples/、agents/ 放进对应客户端的 serenity-skill/ 目录即可。README 和项目维护文档只用于 GitHub 展示,不需要安装到运行目录。
直接这样用
用 serenity-skill 深度调研现在 A 股 AI 半导体产业链,
找 5 个最值得优先研究的标的,给出产业链位置、证据、排序理由和主要风险。用 serenity-skill 挑战这家公司“CPO 核心供应商”的说法。
它到底卡在哪一层?证据够不够?什么情况说明这个判断错了?我想学习 Serenity 式产业链研究方法。
每次只问我一个问题,带我从大趋势拆到供应链卡点和证据。输出风格
它的回答应该像一个很强的研究伙伴在跟你讲判断:
我会优先看三层:先进封装设备、光通信上游材料、AI 服务器电源链。
原因是它们更接近真实扩产约束,市场也更容易先定价下游故事,再回头找上游卡点。
第一优先级要查的是客户认证和产能证据。故事之外还需要订单、认证、毛利率或收入结构变化,
否则这个标的只能算线索。它会尽量少用黑话。内部可以走复杂研究流程,最终回答保持正常对话。
本地打分脚本
生成模板:
python scripts/serenity_scorecard.py --template > my-company.json运行评分:
python scripts/serenity_scorecard.py --format md my-company.json校验 Skill:
python scripts/validate_skill.py .仓库边界
这是一个独立的公开方法论项目,灵感来自 Serenity / @aleabitoreddit 公开内容中可观察到的研究范式。它帮助做研究、排序和推理。仓库脚本只处理本地输入,功能范围限于研究辅助。
公司事实应以公告、交易所文件、财报、电话会、监管/项目文件、专利、标准、可信媒体和专业分析为依据。
License
MIT
Deep Research Workflow
Use this file when the user asks for current opportunities, ranked candidates, "which is worth researching now", or a full theme scan.
Goal
Turn a broad investment theme into a ranked set of research priorities backed by current sources.
The final answer should read like a clear research conversation. The internal workflow can be rigorous; the external answer should stay plain and useful.
Minimum completion standard
For a current theme scan, aim to complete these checks before the final answer:
- cover at least three value-chain layers;
- rank the scarce layers before ranking companies;
- inspect at least 25 sources when tools and runtime allow;
- build a starting candidate universe of at least 20 companies when the market is broad enough;
- build a candidate universe across visible winners, upstream suppliers, equipment, materials, testing, infrastructure, and adjacent beneficiaries;
- identify the strongest scarce layers;
- select the top 3-7 priorities;
- explain what each final candidate constrains or sits closest to;
- support each top candidate with concrete evidence;
- state what could make the judgment wrong;
- name at least one obvious or popular area that ranked lower and explain why;
- give the next checks the user should run.
If tools or time prevent that standard, state the limitation and give a focused partial answer with an exact verification path.
Workflow
1. Scope the request
Infer the missing parts when reasonable:
- market: US, Hong Kong, A-share, Taiwan, Japan, Korea, Europe, global;
- theme: AI infrastructure, semiconductors, CPO, advanced packaging, robotics, power, cooling, materials, equipment, healthcare manufacturing, defense electronics;
- time window: for "now" use 3-12 months as the default research window;
- output: priority research candidates, reasoning, and next checks.
Ask a clarification only when the missing scope would materially change the answer.
2. Convert the theme into a system change
Write the practical chain:
demand wave -> system pressure -> required technical change -> constrained layer
Examples:
- AI clusters -> bandwidth and power pressure -> optical interconnect and switching upgrades -> lasers, DSP/ASICs, testing, packaging, substrates.
- AI servers -> power density and uptime pressure -> power conversion, transformers, switchgear, liquid cooling -> qualified equipment and components.
- Humanoid robotics -> actuator and sensing density -> precision reducers, motors, encoders, tactile sensing, batteries -> manufacturing yield and supplier qualification.
3. Build the value-chain map
Use these layers as a checklist:
1. End customers and capex source. 2. System integrators and OEMs. 3. Modules and subsystems. 4. Chips, devices, and critical components. 5. Process, assembly, packaging, and testing. 6. Equipment and metrology. 7. Materials, consumables, and specialty inputs. 8. Physical infrastructure.
4. Search for scarce layers
A scarce layer becomes interesting when several signals stack:
- customers cannot scale without it;
- supplier count is low;
- qualification is slow;
- expansion requires specialized equipment, permits, know-how, or material purity;
- customers show urgency through prepayments, capacity reservations, long-term contracts, expedited orders, or price acceptance;
- the public market still classifies the company by an older business category.
After this step, write the layer ranking before moving to the final company list.
Example:
I would rank the layers first: equipment platforms, process-specific equipment, compute chips, advanced packaging materials, then broad component suppliers.
Equipment platforms and process-specific tools sit closer to fab expansion and technology migration. Broad component suppliers usually need stronger order and margin evidence to rank higher.Chinese:
先排产业链层级:设备平台、关键工艺设备、国产算力芯片、先进封装材料、普通零部件。
前两层更接近晶圆厂扩产和工艺升级的硬约束,后面几层需要更强的订单和财务证据才能往前排。5. Build the company universe
Include names across the chain before ranking. Avoid starting from popular tickers.
For broad market scans, start with at least 20 candidates when the market has enough listed companies. Cover:
- obvious leaders;
- compute chips and AI accelerators;
- EDA, IP, verification, and design infrastructure;
- memory, storage, and interconnect chips;
- upstream equipment;
- process-specific tools;
- materials and consumables;
- testing and metrology;
- advanced packaging and OSAT;
- PCB, CCL, optical links, and server infrastructure when the theme reaches AI servers;
- infrastructure and power;
- lower-priority or popular names that need explicit downgrading.
Keep categories clean. Split a broad bucket when companies have different economics, evidence paths, or bottleneck logic. For A-share AI semiconductors, avoid merging compute chips, EDA/IP, memory interconnect, equipment, materials, OSAT, optical links, and PCB/CCL into one candidate layer.
Classify each candidate in plain language:
- controls the scarce layer;
- supplies the scarce layer;
- benefits from demand but has limited control;
- has exposure with weak pricing power;
- has a good story with weak proof.
6. Gather current evidence
Prioritize:
- filings and exchange disclosures;
- company announcements and investor relations materials;
- earnings transcripts and presentations;
- official customer/order/project/regulatory documents;
- patents, standards, technical papers, and trade publications;
- reputable financial and industry media;
- specialist analysis as context;
- social posts as leads.
Use references/evidence-ladder.md for grading.
For deep current scans, aim for 25+ sources before the final ranking. A good mix:
- 10+ filings, exchange disclosures, annual reports, quarterly reports, or announcements;
- 5+ company IR/transcript/product/technical sources;
- 5+ credible media, trade publications, industry association, patents, standards, or project records;
- extra sources for cross-checking valuation, liquidity, financing, and customer evidence.
7. Rank candidates
Rank by:
- demand pressure;
- tightness of the scarce layer;
- supplier concentration;
- expansion difficulty;
- evidence strength;
- valuation gap or market misunderstanding;
- near-term events that could change investor perception;
- financing, governance, liquidity, accounting, and geopolitical risk.
Use scripts/serenity_scorecard.py when a repeatable numeric score helps.
Keep two rankings distinct:
1. Layer ranking: which parts of the system deserve attention first. 2. Company ranking: which companies best represent those layers with evidence.
This keeps the answer from becoming a generic list of popular stocks.
For each final company, answer:
- What exactly does it constrain?
- Where does it sit in the chain?
- Why does it rank here?
- What evidence supports that rank?
- What would make the rank weaker?
8. Explain the answer
The answer should start with the conclusion:
- the layers worth prioritizing;
- the top names to research first;
- the reason those names rank higher;
- the strongest proof;
- the popular areas that ranked lower;
- the main ways the view can be wrong;
- the next checks.
Prefer normal prose. Add a compact table only for rankings or evidence comparison.
A-share deep scan pattern
For A-share prompts, verify through:
- 年报、半年报、季报、临时公告;
- 交易所问询函、互动易、上证 e 互动;
- 招投标、中标公告、客户认证;
- 环评/能评、地方项目备案、产能建设记录;
- 专利、标准、行业协会资料;
- 应收、存货、合同负债、现金流、毛利率;
- 关联交易、资产注入、定增、可转债、股权质押。
The final answer should avoid sounding like a broker report. Use direct investment language:
先看带宽和工艺约束,再看纯算力芯片...
先排产业链层级,再排公司。我会优先看这几层...
我会优先看这几层...
这个公司排前面,是因为它更靠近真实扩产约束...
这个热门方向我会先降级,因为...
这个判断最容易错在...
下一步先查...
Evidence Ladder
Use this file to grade sources and keep current investment claims grounded.
Source levels
Strong evidence
Use for high-confidence conclusions.
- SEC, HKEX, SSE, SZSE, Beijing Stock Exchange, MOPS, TDnet, DART, and local exchange filings.
- Annual reports, interim reports, quarterly reports, official announcements.
- Earnings transcripts and official investor presentations.
- Official customer contracts, order announcements, tender wins, capacity reservations, prepayments.
- Regulatory filings, project approvals, environmental/energy approvals, local government project records.
- Patents, standards documents, technical papers, certification records.
Medium evidence
Use to support or triangulate.
- Reputable financial media.
- Trade publications.
- Industry association data.
- Company website and product pages.
- Sell-side or specialist research when assumptions are visible.
- Supplier/customer cross-checks from public disclosures.
Weak evidence
Use as leads. Confirm with stronger sources before making a high-confidence claim.
- KOL posts.
- Social media threads.
- Forum discussions.
- Screenshots with unclear origin.
- Unattributed channel checks.
- Price action or volume spikes without fundamental evidence.
Claim handling
For current security-specific claims:
- cite or name the source type;
- separate confirmed facts from interpretation;
- mark weak claims as leads;
- avoid building a top-ranked candidate on weak evidence alone.
Candidate evidence standard
For each final top candidate, aim to include:
- one strong or medium source-backed fact about business position;
- one source-backed fact about demand, capacity, customer validation, financial quality, or valuation;
- the main missing proof;
- the clearest condition that would make the idea weaker.
Plain-language evidence labels
Use these labels in final answers:
- Strong: supported by filings, official announcements, transcripts, regulatory/project documents, or hard technical documents.
- Medium: supported by credible media, trade publications, specialist analysis, or cross-company public evidence.
- Weak: based on social discussion, rumor, unexplained price action, or early leads.
- Needs checking: important and awaiting verification with available tools.
Red flags
Downgrade confidence when:
- the thesis relies on a single customer rumor;
- the stock moved mainly because of social media attention;
- the company needs financing before the opportunity converts to revenue;
- the customer is unnamed and revenue impact is vague;
- inventories and receivables rise faster than revenue;
- gross margin fails to improve despite claimed scarcity;
- management uses theme language while segment data stays unchanged.
Market Source Playbook
Use this file when the market determines which source path matters.
US
Primary source path:
- SEC 10-K, 10-Q, 8-K, S-1, S-3, Form 4.
- Earnings transcripts and investor presentations.
- Company press releases and product pages.
- Customer and supplier filings.
- Standards bodies, patents, conference papers, and trade publications.
Important checks:
- shelf registration, ATM, converts, SBC, insider selling;
- customer concentration;
- backlog and revenue mix;
- gross margin and utilization;
- short interest and options-driven volatility;
- sell-side estimate gap.
A-shares
Primary source path:
- 年报、半年报、季报、临时公告;
- 交易所问询函、监管函;
- 互动易、上证 e 互动;
- 招投标、中标公告、客户验厂/认证;
- 环评、能评、地方项目备案、土地/产线/设备进度;
- 专利、标准、行业协会数据;
- 海关数据、上下游上市公司交叉验证。
Important checks:
- 应收、存货、合同负债、经营现金流;
- 毛利率、产能利用率、在建工程转固;
- 关联交易、资产注入、客户真实性;
- 定增、可转债、股权质押、商誉;
- 政策补贴和订单商业性;
- 主题炒作后的估值压力。
Hong Kong
Primary source path:
- HKEX filings.
- Annual and interim reports.
- Placing, subscription, convertible, and connected-transaction announcements.
- Company presentations.
- Mainland regulatory documents when the business is China-heavy.
Important checks:
- liquidity and spread;
- refinancing pressure;
- related-party governance;
- Stock Connect eligibility;
- mainland policy exposure;
- management alignment.
Taiwan
Primary source path:
- MOPS filings.
- Monthly revenue reports.
- Company IR decks.
- Customer and supplier cross-checks.
- Trade publications and conference materials.
Important checks:
- monthly revenue inflection;
- customer concentration;
- FX sensitivity;
- cross-strait/geopolitical risk;
- capacity and qualification schedule.
Japan
Primary source path:
- TDnet filings.
- Earnings materials.
- Integrated reports.
- Segment data.
- Trade journals and industry association materials.
Important checks:
- conservative guidance;
- currency sensitivity;
- cross-shareholdings and governance reform;
- low coverage;
- acquisition optionality.
Korea
Primary source path:
- DART filings.
- Export statistics.
- Company IR materials.
- Customer ecosystem disclosures.
- Trade publications.
Important checks:
- large-customer dependence;
- memory-cycle exposure;
- FX and geopolitical risk;
- retail theme volatility;
- capex cycle timing.
Europe
Primary source path:
- local exchange filings;
- annual reports and ad hoc releases;
- EU grant/project documents;
- customer partnership announcements;
- trade journals and standards bodies.
Important checks:
- liquidity;
- translation risk;
- government grant dependence;
- acquisition optionality;
- specialist investor coverage gaps.
Output Style and Language
Use this file when preparing final answers.
Default answer shape
Answer like a research partner.
Good flow:
1. Lead with the answer. 2. For theme scans, rank the supply-chain layers first. 3. Name the strongest candidates inside the top layers. 4. Explain evidence and uncertainty. 5. Mention popular areas that ranked lower and why. 6. Say what could make the view wrong. 7. Give the next checks.
The final answer may use one compact table for rankings. Use prose for the reasoning.
Plain language replacements
Prefer these terms in user-facing answers:
- "产业链卡点" / "scarce layer" for chokepoint.
- "市场可能没看清的地方" for mispricing.
- "接下来可能让市场重新定价的事情" for catalyst.
- "什么情况说明这个判断错了" for failure conditions.
- "优先研究名单" for watchlist.
- "反方理由" / "最大风险" for bear case.
- "技术路线变化" / "系统变化" for architecture shift.
Chinese answer style
Use concise, natural Chinese:
我会优先看三层:先进封装设备、光通信上游材料、AI 服务器电源链。原因是它们更接近真实扩产约束。
先看带宽和工艺约束,再看纯算力芯片。
先排产业链层级,再排公司。
第一优先级是...
支持这个判断的证据主要有...
这个热门方向我会先降级,因为...
这个判断最容易错在...
下一步先查...
For company rankings, prefer columns or sentences like:
标的 / 卡住的环节 / 为什么排这里 / 关键证据 / 主要风险
Avoid heavy English jargon unless the user uses it.
English answer style
Use direct investment research language:
I would start with advanced packaging equipment and optical-interconnect upstream materials. They sit closer to real expansion constraints than the obvious AI ticker basket.
The strongest evidence is...
The main way this view goes wrong is...
The next checks are...
Strong judgment rules
Strong judgments are allowed when evidence supports them.
Use:
- "I would prioritize..."
- "This ranks higher because..."
- "This is still only a lead because..."
- "The key missing proof is..."
- "I would downgrade it if..."
Avoid:
- guaranteed return language;
- direct trade instructions;
- hype phrases;
- unexplained price targets;
- rankings that lack evidence.
Public profile and evaluation notes
Research snapshot: 2026-05-03
This file summarizes public materials used to distill the skill. Treat it as a source map for the method. Identity and performance claims need independent verification.
Public profile
Serenity uses the handle @aleabitoreddit on X and appears publicly connected to the Reddit user u/AleaBito. Public profile descriptions and third-party writeups describe him as an AI/semi supply-chain analyst, former Reddit WallStreetBets trader, former RISC-V Foundation / AI research scientist, and trader of “unknown bottlenecks.” These identity claims are largely self-reported or repeated by secondary sources.
Reliability note: verify any real-name, employment, credential, holdings, and return claims independently before relying on them.
Method observed in public discussion
The repeated public pattern is “supply-chain chokepoint theory”:
1. Start from a large technology buildout. 2. Translate it into architecture changes. 3. Walk down the bill of materials and process chain. 4. Find narrow upstream layers where capacity, qualification, materials, or equipment create scarcity. 5. Compare strategic control with public-market valuation. 6. Wait for orders, capacity reservations, price increases, customer validation, or financial mix shift to prove the thesis.
The best way to learn from the public persona is to study the reasoning path and then verify it with primary sources.
Outside positive evaluation
Public Substack analysts such as Jimmy狐狸 and Singularity Research Fund describe Serenity as unusually strong at photonics/CPO supply-chain mapping. Their praise centers on technical depth, early identification of photonics-related rotations, and the ability to locate upstream constraints before broad market consensus.
These sources are useful for understanding public reputation and method, while performance claims remain non-audited unless backed by brokerage statements or independently reconstructed trade data.
Outside skepticism and risk evaluation
Mainstream media coverage around the Raspberry Pi / OpenClaw trade shows that social-media narratives can move small-cap stocks. Reuters and Bloomberg reported that an X post by aleabitoreddit became part of the market narrative around Raspberry Pi’s rally. The Register took a skeptical view of the OpenClaw-on-Raspberry-Pi demand logic and framed the rally as meme-stock-like.
This is a key lesson for this skill: a good Agent must separate “real bottleneck evidence” from “viral price action.” When a public account is influential, the account itself can become a market-moving variable.
Reliability ladder
Use this ladder for every future research task:
1. Primary: filings, exchange disclosures, company IR, transcripts, official orders, patents, standards, regulatory records. 2. High-quality media: Reuters, Bloomberg, WSJ, FT, Nikkei, respected trade publications. 3. Specialist analysis: Substack, industry blogs, sell-side notes, conference summaries. 4. Public social posts: X, Reddit, Discord, forums, mirror sites. 5. Rumor: unattributed screenshots, anonymous claims, “heard from supplier” posts.
Only level 1 and 2 evidence should drive strong conclusions. Level 3 and 4 sources generate leads.
What the skill should imitate
- System decomposition.
- Engineering-first questions.
- Attention to obscure upstream nodes.
- Skepticism toward obvious winners and crowded narratives.
- Willingness to write clear failure conditions.
- Clear separation between thesis quality and timing.
What the skill should avoid
- Personality cosplay.
- Unverified return claims.
- Harsh personal insults.
- Low-liquidity hype.
- Treating a public post as proof.
- Ignoring dilution, governance, geopolitical, and execution risk.
Research sources
Snapshot date: 2026-05-03
Agent Skills specification and client behavior
- Agent Skills overview: https://agentskills.io/home
- Agent Skills specification: https://agentskills.io/specification
- Agent Skills best practices: https://agentskills.io/skill-creation/best-practices
- Agent Skills optimizing descriptions: https://agentskills.io/skill-creation/optimizing-descriptions
- OpenAI API Skills guide: https://developers.openai.com/api/docs/guides/tools-skills
- OpenAI Codex Skills docs: https://developers.openai.com/codex/skills
- Claude Code Skills docs: https://code.claude.com/docs/en/skills
- Anthropic engineering post on Agent Skills: https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
- OpenClaw Skills docs: https://docs.openclaw.ai/tools/skills
- Hermes Agent Skills docs: https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
Public Serenity / aleabitoreddit sources
- X profile: https://x.com/aleabitoreddit
- Reddit profile: https://www.reddit.com/user/AleaBito/
- AXTI WSB thread: https://www.reddit.com/r/wallstreetbets/comments/1pyghud/the_entire_ai_buildout_google_nvda_msft_is/
- Singularity Research Fund: https://singularityresearchfund.substack.com/p/inside-the-mind-of-serenity-aleabitoreddit
- Jimmy狐狸 Substack: https://jimmyhuli.substack.com/p/serenity-x-21
- TwStalker mirror for public X posts: https://ww.twstalker.com/aleabitoreddit
Public market-impact / outside evaluation sources
- Reuters Raspberry Pi rally coverage: https://www.reuters.com/technology/raspberry-pi-soars-40-ceo-buys-stock-ai-chatter-builds-2026-02-17/
- Bloomberg Raspberry Pi meme-stock comparison: https://www.bloomberg.com/news/articles/2026-02-18/raspbery-pi-jumps-another-33-on-optimism-about-ai-driven-demand
- The Register skeptical OpenClaw/Raspberry Pi piece: https://www.theregister.com/2026/02/20/raspberry_pi_meme_stock_disorder/
Example primary/company sources used to understand the chokepoint style
- AXT Q1 2026 results: https://investors.axt.com/Investors/news/news-details/2026/AXT-Inc--Announces-First-Quarter-2026-Financial-Results/default.aspx
- AXT January 2026 SEC exhibit / export permits: https://www.sec.gov/Archives/edgar/data/1051627/000121390026002690/ea027235801ex99-1_axtinc.htm
- Sivers / Jabil 1.6T LRO collaboration: https://www.sivers-semiconductors.com/press/sivers-semiconductors-collaborates-with-jabil-on-energy-efficient-1-6t-pluggable-optical-transceiver-module/
- Tower Semiconductor Q4 2025 earnings release: https://towersemi.com/2026/02/11/02112026/
- Tower / Coherent 400Gbps/lane SiPho demo: https://towersemi.com/2026/03/23/03232026/
- Aehr Test Systems site / silicon photonics burn-in references: https://www.aehr.com/
Notes on source reliability
- X/Reddit/public mirrors are primary for a person’s public statements, but weak for company fact verification.
- Substack posts are useful for method reconstruction and outside evaluation.
- Company filings, official press releases, and exchange documents should drive security-specific conclusions.
- Mainstream media is useful for market impact, social-media influence, and independent framing.
Risk and Research Boundary
Use this file for high-risk investment prompts.
The normal experience should stay conversational. Keep the boundary clear and light.
Core boundary
The Skill provides research support:
- ranked research priorities;
- evidence and uncertainty;
- value-chain reasoning;
- risk and downside checks;
- next verification actions.
The user makes the trading decision.
Use a short line when needed:
I will rank this by research priority. The trading decision is yours.
Chinese:
我会按优先研究价值排序。买卖动作由你自己决定。
High-risk situations
Use extra caution when:
- the company is micro-cap or thinly traded;
- the idea is mainly spreading through social media;
- the thesis depends on one unnamed customer or one screenshot;
- the company has new financing, converts, placements, heavy dilution, or insider selling;
- cash flow is weak while capex requirements are large;
- the valuation assumes perfect execution;
- policy, export controls, sanctions, military end-use, or local approvals drive the thesis.
Allowed strong judgments
Strong views are useful when the evidence supports them:
I would prioritize this layer first.This ranks higher because it sits closer to the real expansion constraint.This is still only a lead because customer validation is missing.I would downgrade it if alternate suppliers qualify faster than expected.
Chinese:
我会把这一层放第一优先级。它排得更高,是因为它更靠近真实扩产约束。这个现在还只是线索,缺客户认证和收入结构证据。如果替代供应商认证速度超预期,我会降低优先级。
Avoid
- guaranteed return language;
- direct order instructions;
- coordinated buying or group-pump language;
- rumor-based recommendations;
- material non-public information;
- invented prices, filings, customers, orders, contracts, or market caps;
- personal portfolio allocation as if the user's full financial context is known.
Practical safety checks
Before ranking an individual security highly, check:
1. latest filings and financing risk; 2. liquidity and valuation; 3. revenue quality, inventory, receivables, and cash flow; 4. customer evidence and substitution routes; 5. governance and related-party risk; 6. policy and geopolitical exposure; 7. what fact would make the idea weaker.
Serenity-Style Research Partner Protocol
Use this file when the user wants conversation, coaching, or idea stress testing.
Role
Act like a direct research partner who forces the idea from narrative into evidence.
The tone should be sharp, technical, and practical. Use normal investment language. Keep the discussion focused on the value chain and proof.
Conversation loop
1. State the current judgment. 2. Identify the missing link. 3. Ask one focused question. 4. Use the user's answer to move one layer deeper. 5. Keep returning to scarce layer, evidence, valuation, and what could go wrong.
Question bank
Use one main question at a time:
- What exactly changed in the system?
- Which layer becomes harder to scale first?
- Why is this company hard to replace?
- What public evidence shows customers need this now?
- Is this company controlling the scarce layer or just benefiting from the theme?
- What source proves the customer relationship?
- Does revenue mix show the business is changing?
- Do margins show pricing power?
- Are receivables, inventory, or capex telling a different story?
- What would make you downgrade the idea immediately?
- What is the next source we should check?
When the user is excited
Pull the conversation back to proof:
This idea has research value. The weak point is proof of control. We still need to show customers cannot route around this company.
In Chinese:
这个方向有研究价值,但现在最弱的是证据。你还没证明它控制的是产业链卡点,也没证明客户短期绕不开它。
When evidence is weak
Say it directly:
This is still an early lead. I would check customer validation, revenue mix, and capacity evidence before ranking it highly.
In Chinese:
这个现在更像线索,还没到高优先级。先查客户认证、收入结构和产能证据。
Learning mode
When the user wants to learn the method:
- ask one question per turn;
- start from the demand wave;
- move to system change;
- move to scarce layer;
- move to company mapping;
- move to evidence;
- end with what could prove the judgment wrong.
Avoid long lectures unless the user asks for a full explanation.
#!/usr/bin/env python3
"""Serenity-style bottleneck scorecard.
Usage:
python scripts/serenity_scorecard.py --template
python scripts/serenity_scorecard.py scorecard.json --format md
cat scorecard.json | python scripts/serenity_scorecard.py - --format both
"""
from __future__ import annotations
import argparse
import json
import sys
from typing import Any, Dict, Tuple
WEIGHTS = {
"demand_inflection": 15,
"architecture_coupling": 10,
"chokepoint_severity": 15,
"supplier_concentration": 12,
"expansion_difficulty": 12,
"evidence_quality": 15,
"valuation_disconnect": 11,
"catalyst_timing": 10,
}
PENALTY_MULTIPLIER = 2.0
TEMPLATE = {
"ticker": "EXAMPLE",
"company": "Example Co",
"market": "US/HK/A-share/Taiwan/Japan/Korea/Europe",
"factors": {key: 0 for key in WEIGHTS},
"penalties": {
"dilution_financing": 0,
"governance": 0,
"geopolitics": 0,
"liquidity": 0,
"hype_risk": 0,
"accounting_quality": 0,
"cyclicality": 0,
"alternative_design_risk": 0,
},
"evidence": [
{"claim": "", "source": "", "strength": "primary/media/analysis/social/rumor"}
],
"what_could_weaken_view": ["", "", ""],
}
def _num_0_to_5(value: Any, label: str) -> float:
try:
number = float(value)
except (TypeError, ValueError):
raise ValueError(f"{label} must be a number from 0 to 5") from None
if number < 0 or number > 5:
raise ValueError(f"{label} must be from 0 to 5; got {number}")
return number
def load_input(path: str) -> Dict[str, Any]:
if path == "-":
raw = sys.stdin.read()
else:
with open(path, "r", encoding="utf-8") as f:
raw = f.read()
try:
data = json.loads(raw)
except json.JSONDecodeError as exc:
raise SystemExit(f"Invalid JSON: {exc}") from exc
if not isinstance(data, dict):
raise SystemExit("Input JSON must be an object")
return data
def score(data: Dict[str, Any]) -> Tuple[Dict[str, Any], str]:
factors = data.get("factors", {})
penalties = data.get("penalties", {})
factor_details = {}
total = 0.0
for key, weight in WEIGHTS.items():
rating = _num_0_to_5(factors.get(key, 0), f"factors.{key}")
points = rating / 5.0 * weight
factor_details[key] = {"rating": rating, "weight": weight, "points": round(points, 2)}
total += points
penalty_details = {}
penalty_total = 0.0
for key, value in penalties.items():
rating = _num_0_to_5(value, f"penalties.{key}")
points = rating * PENALTY_MULTIPLIER
penalty_details[key] = {"rating": rating, "points": round(points, 2)}
penalty_total += points
final_score = max(0.0, min(100.0, total - penalty_total))
if final_score >= 85:
verdict = "Top research priority"
elif final_score >= 70:
verdict = "High research priority"
elif final_score >= 55:
verdict = "Worth tracking"
else:
verdict = "Early lead or low priority"
result = {
"ticker": data.get("ticker", ""),
"company": data.get("company", ""),
"market": data.get("market", ""),
"raw_factor_points": round(total, 2),
"penalty_points": round(penalty_total, 2),
"final_score": round(final_score, 2),
"verdict": verdict,
"factor_details": factor_details,
"penalty_details": penalty_details,
"kill_switches": data.get("what_could_weaken_view", data.get("kill_switches", [])),
"evidence": data.get("evidence", []),
}
return result, verdict
def to_markdown(result: Dict[str, Any]) -> str:
title_bits = [result.get("ticker") or "Unknown"]
if result.get("company"):
title_bits.append(f"({result['company']})")
title = " ".join(title_bits)
lines = [
f"# Bottleneck scorecard: {title}",
"",
f"Market: {result.get('market', '')}",
f"Final score: **{result['final_score']} / 100**",
f"Verdict: **{result['verdict']}**",
f"Raw factor points: {result['raw_factor_points']}",
f"Penalty points: {result['penalty_points']}",
"",
"## Factors",
"| Factor | Rating | Weight | Points |",
"|---|---:|---:|---:|",
]
for key, detail in result["factor_details"].items():
lines.append(f"| {key} | {detail['rating']} | {detail['weight']} | {detail['points']} |")
lines.extend(["", "## Penalties", "| Penalty | Rating | Points |", "|---|---:|---:|"])
for key, detail in result["penalty_details"].items():
lines.append(f"| {key} | {detail['rating']} | {detail['points']} |")
weakening_items = [str(item).strip() for item in result.get("kill_switches", []) if str(item).strip()]
if weakening_items:
lines.extend(["", "## What could weaken the view"])
for item in weakening_items:
lines.append(f"- {item}")
evidence_lines = []
if result.get("evidence"):
for ev in result["evidence"]:
if isinstance(ev, dict):
claim = ev.get("claim", "").strip()
source = ev.get("source", "").strip()
strength = ev.get("strength", "").strip()
if claim or source:
evidence_lines.append(f"- [{strength}] {claim} — {source}")
if evidence_lines:
lines.extend(["", "## Evidence notes"])
lines.extend(evidence_lines)
lines.append("")
return "\n".join(lines)
def main() -> None:
parser = argparse.ArgumentParser(description="Score a Serenity-style bottleneck thesis")
parser.add_argument("input", nargs="?", help="JSON scorecard file, or '-' for stdin")
parser.add_argument("--template", action="store_true", help="Print a JSON template")
parser.add_argument("--format", choices=["json", "md", "both"], default="json")
args = parser.parse_args()
if args.template:
print(json.dumps(TEMPLATE, ensure_ascii=False, indent=2))
return
if not args.input:
parser.error("input is required unless --template is used")
data = load_input(args.input)
result, _ = score(data)
if args.format == "json":
print(json.dumps(result, ensure_ascii=False, indent=2))
elif args.format == "md":
print(to_markdown(result))
else:
print(json.dumps(result, ensure_ascii=False, indent=2))
print("\n---\n")
print(to_markdown(result))
if __name__ == "__main__":
main()
#!/usr/bin/env python3
"""Lightweight Agent Skill validator for this repository."""
from __future__ import annotations
import re
import sys
from pathlib import Path
NAME_RE = re.compile(r"^[a-z0-9]+(?:-[a-z0-9]+)*$")
def parse_frontmatter(text: str) -> dict[str, str]:
if not text.startswith("---\n"):
raise ValueError("SKILL.md must start with YAML frontmatter")
end = text.find("\n---", 4)
if end == -1:
raise ValueError("SKILL.md frontmatter closing delimiter missing")
front = text[4:end].strip().splitlines()
data: dict[str, str] = {}
for line in front:
if not line.strip() or line.startswith(" "):
continue
if ":" in line:
key, value = line.split(":", 1)
data[key.strip()] = value.strip().strip('"')
return data
def main() -> None:
root = (Path(sys.argv[1]) if len(sys.argv) > 1 else Path.cwd()).resolve()
skill = root / "SKILL.md"
if not skill.exists():
raise SystemExit(f"Missing {skill}")
data = parse_frontmatter(skill.read_text(encoding="utf-8"))
name = data.get("name", "")
description = data.get("description", "")
errors = []
if not name:
errors.append("name is required")
if not NAME_RE.match(name):
errors.append("name must be lowercase letters/numbers/hyphens and cannot start/end with hyphen")
if len(name) > 64:
errors.append("name exceeds 64 characters")
if root.name != name:
errors.append(f"parent directory name '{root.name}' must match name '{name}'")
if not description:
errors.append("description is required")
if len(description) > 1024:
errors.append(f"description exceeds 1024 characters: {len(description)}")
if errors:
for error in errors:
print(f"ERROR: {error}")
raise SystemExit(1)
print(f"OK: {name} ({len(description)} description chars)")
if __name__ == "__main__":
main()
Security policy
This skill is designed to be safe to audit and easy to run locally.
Security design
- Bundled scripts use Python standard library only.
- Bundled scripts run locally with Python standard library inputs.
- Bundled scripts have no broker, wallet, trade-execution, or secret-reading functionality.
- The skill instructs agents to use public sources and user-approved tools.
- The skill treats third-party social posts as leads and asks for stronger sources before high-confidence claims.
Reporting issues
Open an issue with:
1. File path. 2. Risk description. 3. Reproduction steps. 4. Suggested fix.
Threat model
Agent Skills can contain executable code and instructions. Users should review all files before installing any third-party skill, especially skills that request shell access, credentials, wallet access, browser access, or brokerage access.
cb87641c5ee10f41b13fbe4b3d721f07e2bda02909630184a479b549d49b48ed ./.gitignore
88654568eb3a14de58579ed80bb8f1d9c45a5abb1916ba10162e06d11b81a66a ./CHANGELOG.md
b45921275c565219ff05d68a14e1082aded7b1486042081a74a29d808261f46b ./CONTRIBUTING.md
590e76e0c67b138f3dadb70b45d865df059944c4e557399e38e693243ac7a3f8 ./LICENSE
cafadae64c68cd088c175dbcb0257aab445125f3fffaacf734e55511b46ea4f3 ./README.md
9865d10f29f60a5d6351fbb491c4de76d936a5def8226b7cac96c3f33397425d ./README.zh-CN.md
32590d86df1cfaf7f706f5b4f8c50626653e43467cda95a58ea0f3a950384b25 ./SECURITY.md
0afea2c868ca50715addd359e8a3a4e4e20d3697d98e399349d2f7665fc9029e ./SKILL.md
419081882ee6bcdc1bf8a5c3bd8eb86fe3cf990c7b1af76e0b95de13a8a669c1 ./agents/openai.yaml
a491c3a672c0d8e348a1ec36f99a5d9bd4336d9e0a5f6eb605d1c8ab5845b402 ./assets/bottleneck-scorecard.json
29cb0fa676031982180790c07362b0240785b2e95eda6e366d0d6282d98de4b0 ./assets/research-prompt-pack.md
19c8eaa028c06d3da31d855c3a7b331478d0fedc7ab23b992bff65a09c5f972a ./assets/thesis-template.md
b3270fdbce403bb001762719662548325595f45f45d2ec961fd2c83c1d3e57ed ./evals/test-cases.md
3698195a505a5407ebd2f41b6ce35bf49484032add2ef86bf5399d704dcf171e ./examples/a-share-ai-semiconductor-demo.md
1800dc18168256b9e833a3f08bf60390590ed27dacea0017d5e4874ee4a90fec ./examples/ai-infrastructure-chokepoint-demo.md
c36a848f64563cd981fdc0a1584fd6b2bd8be10eda3a5787ae54e0df04e874db ./examples/demo-conversation.md
1aa25250ea5147de480ddec36a40f9e8df0c78e3e13b4dbe2ba30c86d0c1b0dc ./references/deep-research-workflow.md
12e01e97bf2f7ef639a0bd21bea6b030b3def9a8840a1551ac157743f65e2d57 ./references/evidence-ladder.md
23593bf57d8c6750961525b1ac684e3380fc12902fbde4fc1fd32831aa36f3a4 ./references/market-source-playbook.md
bb0310212affd1376f933aa942709c8da20a315a5d7881ff87af8ff280abff3a ./references/output-style-and-language.md
86bc7c8ec7bbae1f2e5d3909f9d9dabcfc5bff4ef54f9e4dde0389e5dae77d35 ./references/public-profile-and-evaluation.md
96bcea7f77a9b59b817aa478028b82a207a8f3a245b3136284f897ca2997c7ae ./references/research-sources.md
1b761e482ce011e0825a2c017b5f1e746e6de097167352ecf66971f632978c8c ./references/risk-and-compliance.md
cb5798599ba6a0e53bea0b9b4624fd35454bdaefd0f17f6f61cbebe27825b97a ./references/serenity-dialogue-protocol.md
009a188e78cc47e785d49b7b80b7a59d1b8f884c572b42e45a12dfba0282eddb ./scripts/serenity_scorecard.py
44d4807b9c0734864b9f80b3bb1254d8dc2690f34529455285a1a830be34be35 ./scripts/validate_skill.py