Agent skill

Serenity Alpha

by haskaomni in haskaomni/serenity-skill

Translate market-moving news into investable alpha hypotheses by mapping observed demand changes to revenue lines, supply chains, small-cap financial elasticity, market misclassification, validation…

MITAuto-check passedBusiness, Finance & HR

Install Serenity Alpha

skills CLI
$ npx skills add haskaomni/serenity-skill --skill serenity-alpha -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install haskaomni/serenity-skill serenity-alpha --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/haskaomni/serenity-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/serenity-alpha .claude/skills/serenity-alpha && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
serenity-alpha
GitHub stars
633
Token cost
~2.6k tokens
SKILL.md length
1,155 words
Files
3 (incl. references)
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

Translate market-moving news into investable alpha hypotheses by mapping observed demand changes to revenue lines, supply chains, small-cap financial elasticity, market misclassification, validation…

  • Works in 7 steps: Separate Talk From Demand → Translate Phenomenon Into Financial Lines → Prefer Small, Pure, Misclassified Picks → …
  • The user shares news
  • SKILL.md covers Core Principle, Optional SEC Data Assist, Answer Shape and Workflow, plus 3 more sections
  • Calls pip and uv

What it does

Serenity Alpha is an agent skill from haskaomni/serenity-skill. Translate market-moving news into investable alpha hypotheses by mapping observed demand changes to revenue lines, supply chains, small-cap financial elasticity, market misclassification, validation metrics, downside risks, and position-sizing conditions. Use when the user shares news, product launches, technology breakthroughs, procurement signals, supply-chain changes, earnings-call clues, or asks for Serenity-style alpha analysis, small-cap beneficiaries, or "news to financial statement" translation.

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml` and `references/original-framework.md`).

It sits in Business, Finance & HR, covering Supply chain security, Financial analysis and Translation. The licence is MIT.

When your agent uses it

  • The user shares news
  • Product launches
  • Technology breakthroughs
  • Procurement signals

Example prompts

  • “news to financial statement”
  • “/serenity-alpha”

Requirements

  • Python 3

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Separate Talk From Demand
  2. Translate Phenomenon Into Financial Lines
  3. Prefer Small, Pure, Misclassified Picks
  4. Test Market Misclassification
  5. Build a Verification Chain
  6. Score Alpha Strength
  7. Size By Evidence

What it can do on your machine

Read from SKILL.md and the folder at commit dedcf8f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pip
    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip and uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Serenity Alpha loads about 2.6k tokens when it runs, and up to ~2.8k if it reads all its reference files. Until then it costs about 131 tokens; SKILL.md has 1,155 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~131
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from haskaomni/serenity-skill at commit dedcf8f, republished under its MIT licence (© haskaomni). 1,155 words, ~2,568 tokens.

Download SKILL.mdSave it as .claude/skills/serenity-alpha/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
serenity-alpha
description
Translate market-moving news into investable alpha hypotheses by mapping observed demand changes to revenue lines, supply chains, small-cap financial elasticity, market misclassification, validation metrics, downside risks, and position-sizing conditions. Use when the user shares news, product launches, technology breakthroughs, procurement signals, supply-chain changes, earnings-call clues, or asks for Serenity-style alpha analysis, small-cap beneficiaries, or "news to financial statement" translation.

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:

text
news -> observed demand change -> revenue/profit transmission -> small-cap elasticity -> validation path

Treat 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:

python
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:

text
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:

text
alpha elasticity ~= incremental demand impact / current company scale
4. 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.

Show full SKILL.md (464 more words)Show less
6. Score Alpha Strength

Score each candidate qualitatively or on a 1-5 scale:

DimensionQuestion
Demand certaintyIs this already occurring, or only imagined?
Transmission clarityCan the demand clearly flow to named companies?
Business purityIs the company directly exposed?
Market-cap elasticityIs the company small enough for the impact to matter?
Market neglectIs the market missing or mislabeling it?
Verification speedCan filings or calls verify this in 1-4 quarters?
Downside riskWhat 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 statePosture
Demand seems real, transmission unclearobserve / very small exploratory size
Demand real, transmission clear, no financial proof yetsmall test position if risk fits
Financials begin validating and market still underpricesconsider adding
Thesis becomes consensus and valuation stretcheslower return expectations / trade only
Key assumptions are falsifiedexit or remove from watchlist

Mermaid Visualizations

For a full report, include 2-4 Mermaid diagrams when they materially improve comprehension. A short answer or data-limited analysis may use fewer. Do not create a diagram merely to meet a quota.

Prioritize these views:

  1. A flowchart from news to observed demand, financial-statement lines, beneficiaries, and the decisive validation condition.
  2. A candidate map comparing evidence strength with financial elasticity when at least three candidates have comparable inputs; use quadrantChart only with a nearby comparison table.
  3. A 1-4 quarter verification path showing confirm, weaken, and falsify branches.

Apply these rules to every diagram:

  • Use fenced mermaid blocks, match the report language, keep node IDs in simple ASCII, and keep labels short.
  • Prefer broadly supported flowchart, pie, and stateDiagram syntax. Use xychart-beta, quadrantChart, or timeline only as progressive enhancement and retain the adjacent Markdown table as the fallback.
  • Use only evidence and values already stated in the report. Keep names, numbers, units, and probability totals consistent with the surrounding tables; never fill missing data for visual completeness.
  • Place each diagram beside the analysis it explains and follow it with a one-sentence takeaway. Keep citations, URLs, dates, and detailed caveats outside the diagram.
  • Keep a diagram focused: normally no more than 12 nodes or 8 plotted values. Diagrams supplement rather than replace the written transmission logic, risks, and source trail.

Output Template

When analyzing a news item, use this structure:

markdown
## 结论先行:优先验证的公司
点名最值得优先验证的一家公司 / ticker,并用一句话说明为什么它是本次新闻里最有弹性的候选。

## A. 表层新闻
简述新闻表面信息。

## B. 已发生的需求变化
说明已经可观察的需求、采购、使用、价格、排产或供应链变化;如果没有,明确说只是谈资。

## C. 财务翻译
把需求映射到收入项、成本项、利润项、现金流或资产负债表项目。

在这里或下一节加入需求传导 Mermaid flowchart,展示新闻如何进入财务报表并最终影响候选公司。

## 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.

When references/original-framework.md is consulted, preserve its analytical intent but follow this SKILL.md's current output and visualization rules when the formats differ.

© haskaomni, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/serenity-alpha of haskaomni/serenity-skill.

  • SKILL.md
  • agents/openai.yaml
  • references/original-framework.md

Open the folder on GitHubat commit dedcf8f

Compare with similar skills

Serenity Alpha next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Serenity Alpha compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Serenity Alpha this skillhaskaomni/serenity-skill633—~2.6kAutomated safety check: PassMIT
Security Commsbriiirussell/cybersecurity-skills413—~3.8kAutomated safety check: PassMIT
Operationstravisjneuman/.claude100—~3.4kAutomated safety check: PassMIT
Longbridge Earningshelsome/folio2711 repos~2.5kAutomated safety check: PassNone
Financial Analyzinghuangjia2019/claude-code-engineering1.1k—~474Automated safety check: PassNone
Earnings AnalysisWind-Alice/AliceMarket1343 repos~2.2kAutomated safety check: PassNone

Similar skills

  • Security Comms

    briiirussell/cybersecurity-skills

    Translate technical security work into the language of non-security audiences — board, executives, engineering, customer success, customers, legal, procurement, sales.

    413 GitHub stars~3.8k tokensUpdated 4 mo ago
    Business, Finance & HRAuto-check passed
  • Operations

    travisjneuman/.claude

    Operations excellence expertise for supply chain optimization, process improvement (Lean, Six Sigma), capacity planning, vendor management, quality assurance, and operational efficiency.

    100 GitHub stars~3.4k tokensUpdated today
    SecurityAuto-check passed
  • Longbridge Earnings

    helsome/folio

    Earnings analysis — pre- and post-earnings. An agent skill from helsome/folio.

    271 GitHub starsUsed in 1 repo~2.5k tokens
    Business, Finance & HRAuto-check passed
  • Financial Analyzing

    huangjia2019/claude-code-engineering

    Analyze financial data, calculate financial ratios, and generate analysis reports.

    1.1k GitHub stars~474 tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Earnings Analysis

    Wind-Alice/AliceMarket

    Create professional equity research earnings update reports (8-12 pages, 3,000-5,000 words) analyzing quarterly results for companies already under coverage.

    134 GitHub starsUsed in 3 repos~2.2k tokens
    Business, Finance & HRAuto-check passed
  • Serenity Chokepoint Investing

    W-Y-P/Serenity-aleabitoreddit-skill

    A skill your agent uses when analyzing stocks through @aleabitoreddit/Serenity-style supply-chain chokepoint thinking: AI/semi photonics, scarce physical bottlenecks, small-cap monopoly or duopoly…

    119 GitHub stars~2.8k tokensUpdated 4 mo ago
    Business, Finance & HRAuto-check passed

More from haskaomni/serenity-skill

  • Bayesian Intrinsic Growth Valuation

    haskaomni/serenity-skill

    Use a Bayesian intrinsic-growth valuation model to evaluate whether a company's market value sufficiently, excessively, or insufficiently prices its real 3-5 year growth.

    633 GitHub stars~3.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Buy Side Equity Research Memo

    haskaomni/serenity-skill

    Generate source-backed buy-side equity research memos from a ticker, starting with investment view, target-price scenarios, SEC and IR-backed financial statement analysis, industry chain…

    633 GitHub stars~3.8k tokensUpdated 2 mo ago
    Auto-check passed
  • Gf Dma Health Index

    haskaomni/serenity-skill

    Score a stock's current valuation/trend health using the GF-DMA Health Index, combining fundamental growth speed, 20/50/100/200DMA trend speed, price-to-DMA divergence, ATR divergence, escape ratio…

    633 GitHub stars~3k tokensUpdated 2 mo ago
    Auto-check passed
  • Juglar Cycle Stock Stage

    haskaomni/serenity-skill

    Classify a listed company and its core industry into Juglar fixed-asset investment cycle stages with probabilities, evidence, counter-evidence, migration signals, and investment implications.

    633 GitHub stars~2.3k tokensUpdated 2 mo ago
    Auto-check passed
  • Tam Adj Peg

    haskaomni/serenity-skill

    Evaluate a stock's valuation using TAM-Adj-PEG, adjusting traditional PEG by growth runway and quality.

    633 GitHub stars~2.7k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Serenity Alpha

What does Serenity Alpha do?

Translate market-moving news into investable alpha hypotheses by mapping observed demand changes to revenue lines, supply chains, small-cap financial elasticity, market misclassification, validation…. Serenity Alpha is an agent skill from haskaomni/serenity-skill. Translate market-moving news into investable alpha hypotheses by mapping observed demand changes to revenue lines, supply chains, small-cap financial elasticity, market misclassification, validation metrics, downside risks, and position-sizing conditions.

When should I use Serenity Alpha?

Serenity Alpha fits situations like: the user shares news; product launches; technology breakthroughs; procurement signals.

How do I install Serenity Alpha in Claude Code?

Run `npx skills add haskaomni/serenity-skill --skill serenity-alpha -a claude-code`. Or copy the skill folder (skills/serenity-alpha in haskaomni/serenity-skill) into .claude/skills/serenity-alpha in your project. Claude Code loads it when a task matches its description.

How do I install Serenity Alpha in Codex?

Run `npx skills add haskaomni/serenity-skill --skill serenity-alpha -a codex`. Or copy the skill folder (skills/serenity-alpha in haskaomni/serenity-skill) into .agents/skills/serenity-alpha in your project. Codex loads it when a task matches its description.

Can I use Serenity Alpha in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add haskaomni/serenity-skill --skill serenity-alpha -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/serenity-alpha, .gemini/skills/serenity-alpha, .github/skills/serenity-alpha and .opencode/skills/serenity-alpha in your project.

What does Serenity Alpha need to run?

Going by SKILL.md and its folder, Serenity Alpha needs the command-line tools its instructions call (pip and uv). Our summary lists: Python 3.

Does Serenity Alpha access the network?

SKILL.md contains no URLs. Its commands use pip and uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Serenity Alpha safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Serenity Alpha use?

Serenity Alpha is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Serenity Alpha use?

About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 231 tokens, read only when the agent opens those files.

What are the alternatives to Serenity Alpha?

Skills that share tags, products or a category with Serenity Alpha: Security Comms (briiirussell/cybersecurity-skills, 413 stars), Operations (travisjneuman/.claude, 100 stars), Longbridge Earnings (helsome/folio, 271 stars) and Financial Analyzing (huangjia2019/claude-code-engineering, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Serenity Alpha?

haskaomni (a GitHub user) maintains it in haskaomni/serenity-skill, which has 633 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on July 15, 2026.

Source: haskaomni/serenity-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.