
Serenity Alpha
- 82 installs
- 620 repo stars
- Updated July 15, 2026
- haskaomni/serenity-skill
Translates market-moving news into investable alpha hypotheses by mapping demand changes to revenue lines, supply chains, and small-cap elasticity.
About
Converts news and demand signals into a testable alpha hypothesis tracing observed demand to a small company's financial statements and validation path. An analyst uses it to find small-cap beneficiaries and do news-to-financial-statement translation.
- Maps news to revenue transmission and small-cap elasticity
- Optional SEC filing data via edgartools for validation
Serenity Alpha by the numbers
- 82 all-time installs (skills.sh)
- +2 installs in the week ending Aug 2, 2026 (Skillselion tracking)
- Ranked #546 of 1,106 Finance & Trading skills by installs in the Skillselion catalog
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/haskaomni/serenity-skill --skill serenity-alphaAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 82 |
|---|---|
| repo stars | ★ 620 |
| Last updated | July 15, 2026 |
| Repository | haskaomni/serenity-skill ↗ |
What it does
Translates market-moving news into investable alpha hypotheses by mapping demand changes to revenue lines, supply chains, and small-cap elasticity.
Files
Serenity Alpha
Core Principle
Do not ask only whether the news is impressive. Ask whether an already-observable demand change can rewrite a smaller company's financial statements.
Use this skill to convert news into a testable alpha hypothesis:
news -> observed demand change -> revenue/profit transmission -> small-cap elasticity -> validation pathTreat outputs as research hypotheses, not investment advice. Verify current prices, market caps, filings, earnings calls, and news from reliable sources before naming securities or making time-sensitive claims.
Optional SEC Data Assist
For U.S.-listed companies, use SEC filings as the factual base for reported fundamentals and management disclosure when available. edgartools is a good optional helper for this step because it can retrieve company filings, XBRL financial statements, filing text, insider transactions, ownership forms, and recent 8-K disclosures.
If the environment does not already have it, install with pip install edgartools or uv pip install edgartools. The import package is edgar, not edgartools. SEC access requires an identity; set EDGAR_IDENTITY="Name email@example.com" in the environment or call from edgar import set_identity; set_identity("name@example.com") before requests.
Minimal usage pattern:
from edgar import Company
company = Company("AAPL")
filings = company.get_filings(form="10-Q")
financials = company.get_financials()
income = financials.income_statement()Use it to support the analysis, not to replace the framework:
- Pull the latest 10-K, 10-Q, and relevant 8-K filings before judging whether a demand change has reached reported numbers.
- Use XBRL financials for historical revenue, gross profit, margin, cash flow, balance sheet, share count, and segment clues.
- Search filing text and MD&A for demand-driver terms, customer concentration, backlog/order commentary, capacity, pricing, supply constraints, and risk-factor changes.
- Check Form 4, 13D/G, or 13F data only as supporting context; do not treat ownership activity as proof of the alpha thesis.
- Keep non-SEC data separate: current price, market cap, valuation multiples, sell-side estimates, TAM, channel checks, and industry pricing usually require other current sources.
When using SEC data, cite the filing form and filing date in the reasoning, and state when the data is stale relative to the news item.
Answer Shape
Start and end with the company that best fits the alpha hypothesis.
- Open with a direct one-sentence call:
最值得优先验证的是:Company / ticker,原因是... - If several names appear, choose a primary candidate and label others as alternatives or supply-chain comparables.
- If no company is investable yet, say so at the top:
暂时没有足够明确的公司,先观察... - Close by repeating the same primary company and the single validation condition that would confirm or kill the thesis.
Workflow
1. Separate Talk From Demand
Identify whether the item is merely narrative or a demand inflection. Prioritize evidence that has already happened:
- users are adopting or paying
- enterprises are buying or expanding deployments
- suppliers are shipping, backlogged, or raising prices
- production schedules are tightening
- earnings calls or filings mention the demand
- a niche ecosystem is becoming crowded
If demand is not observable, classify the idea as watchlist-only.
2. Translate Phenomenon Into Financial Lines
Use this sentence structure:
Because X is happening, demand for Y is increasing.
That demand can flow to A/B/C companies through revenue line Z.
Company N may matter because its market cap, revenue base, or business purity is small enough for the demand shock to change reported results.For each candidate, map the mechanism to income-statement or balance-sheet items:
- revenue: units, ASP, customer count, usage, take rate, backlog conversion
- gross margin: mix shift, pricing power, utilization, input costs
- operating leverage: fixed-cost absorption, sales efficiency, R&D leverage
- cash flow: working capital, capex needs, inventory turns, prepayments
3. Prefer Small, Pure, Misclassified Picks
Look for "small shovels," not only obvious mega-cap winners. Rank candidates higher when they have:
- small market cap or low revenue base versus the size of the demand shock
- high business purity to the specific demand vector
- key supply-chain position or scarcity value
- low current investor attention
- stale market label that misses the new role
- financial verification likely within 1-4 quarters
Use this rough screen:
alpha elasticity ~= incremental demand impact / current company scale4. Test Market Misclassification
Ask:
- What does the market currently think this company is?
- What could it actually be becoming if the demand change persists?
- Is the new label large enough, durable enough, and close enough to reported numbers to matter?
Misclassification creates alpha only when the relabeling can be validated by numbers, not just story.
5. Build a Verification Chain
Convert the thesis into observable checkpoints. Use the most relevant indicators:
- revenue growth or guidance revisions
- gross-margin improvement or mix disclosure
- backlog, book-to-bill, lead times, or order commentary
- inventory drawdown or channel checks
- utilization, capacity expansion, or capex plans
- ASP changes or pricing commentary
- customer concentration changes
- management mentioning the demand driver unprompted
- competitor/supplier/customer corroboration
Define what would confirm, weaken, or falsify the thesis.
6. Score Alpha Strength
Score each candidate qualitatively or on a 1-5 scale:
| Dimension | Question |
|---|---|
| Demand certainty | Is this already occurring, or only imagined? |
| Transmission clarity | Can the demand clearly flow to named companies? |
| Business purity | Is the company directly exposed? |
| Market-cap elasticity | Is the company small enough for the impact to matter? |
| Market neglect | Is the market missing or mislabeling it? |
| Verification speed | Can filings or calls verify this in 1-4 quarters? |
| Downside risk | What happens if the thesis is wrong? |
Prioritize ideas with high certainty, clear transmission, high purity, high elasticity, and near-term verification.
7. Size By Evidence
Frame position posture as conditional research guidance, not a personalized recommendation:
| Thesis state | Posture |
|---|---|
| Demand seems real, transmission unclear | observe / very small exploratory size |
| Demand real, transmission clear, no financial proof yet | small test position if risk fits |
| Financials begin validating and market still underprices | consider adding |
| Thesis becomes consensus and valuation stretches | lower return expectations / trade only |
| Key assumptions are falsified | exit or remove from watchlist |
Output Template
When analyzing a news item, use this structure:
## 结论先行:优先验证的公司
点名最值得优先验证的一家公司 / ticker,并用一句话说明为什么它是本次新闻里最有弹性的候选。
## A. 表层新闻
简述新闻表面信息。
## B. 已发生的需求变化
说明已经可观察的需求、采购、使用、价格、排产或供应链变化;如果没有,明确说只是谈资。
## C. 财务翻译
把需求映射到收入项、成本项、利润项、现金流或资产负债表项目。
## D. 受益链条
列出一阶、二阶、三阶受益者,并说明传导距离。
## E. 小市值高弹性标的
列出可能的小盘/高纯度/低关注候选;标注需要核实的市值、收入基数和业务占比。
## F. 市场误分类
说明市场现在把公司当什么,它可能正在变成什么。
## G. 验证指标
列出未来 1-4 个季度要看的财报、电话会、供应链和价格指标。
## H. 下行风险
列出需求、传导、竞争、估值、时点和流动性风险。
## I. 仓位建议
给出观察、小仓、加仓、放弃的条件;避免承诺收益或给出个性化投资指令。
## 最后一句
再次点名这家公司,并给出最关键的财报验证条件;如果条件不成立,明确说应放弃或降级为观察。Quality Bar
- Anchor the analysis in observable demand, not vibes.
- Prefer named revenue mechanisms over broad themes.
- Distinguish first-order beneficiaries from distant second- or third-order stories.
- Use current sourced data for market caps, financials, prices, and recent filings.
- State uncertainty and falsification conditions clearly.
interface:
display_name: "Serenity Alpha"
short_description: "Translate news into alpha hypotheses"
default_prompt: "Use $serenity-alpha to analyze this news for demand changes, financial transmission, small-cap elasticity, validation signals, and position sizing."
Original Serenity Alpha Framework
This reference preserves the source framework from a.md in compact form.
Essence
Do not ask whether a news item is big. Ask:
- Is there an already-observed demand change behind it?
- Can that demand enter a company's financial statements?
- Which company is small enough for the demand to change its fate?
- Is the market misclassifying the company?
- Can the thesis be verified through earnings within 1-4 quarters?
Filters
Avoid news with:
- emotion but no demand
- real demand but only mega-cap beneficiaries
- fully priced-in winners
- overly long transmission chains
- no financial verification point
Alpha Formula
potential alpha strength =
demand certainty
x financial transmission clarity
x business purity
x market-cap elasticity
x market neglectUse small initial sizing for verifiable non-consensus ideas, then update with evidence.