Agent skill

Long Short Construction

by agentii-ai in agentii-ai/agentii-investment-intelligence

Long short portfolio construction, market neutral positioning, factor-balanced book, gross and net exposure management, pair selection, beta hedging, portfolio construction methodology

Apache-2.0Auto-check passedMarketing & SEO

Install Long Short Construction

skills CLI
$ npx skills add agentii-ai/agentii-investment-intelligence --skill long-short-construction -a claude-code

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

GitHub CLI
$ gh skill install agentii-ai/agentii-investment-intelligence long-short-construction --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/agentii-ai/agentii-investment-intelligence.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/vertical-plugins/portfolio-strategy/skills/agentii/long-short-construction .claude/skills/long-short-construction && 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
long-short-construction
GitHub stars
207
Token cost
~2.2k tokens
SKILL.md length
950 words
Files
4 (incl. references)
Skills in repo
79
Repo updated
First seen
Licence
Apache-2.0

At a glance

Long short portfolio construction, market neutral positioning, factor-balanced book, gross and net exposure management, pair selection, beta hedging, portfolio construction methodology

  • Works in 4 steps: Construction methodology —… → Strategy frameworks —… → Historical analogues —… → …
  • Marketing & SEO work in your project
  • SKILL.md covers Defaults, Preflight, Data Source Priority and Methodology, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Long Short Construction is an agent skill from agentii-ai/agentii-investment-intelligence. Long short portfolio construction, market neutral positioning, factor-balanced book, gross and net exposure management, pair selection, beta hedging, portfolio construction methodology

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/construction-methodology.md`, `references/modes.md` and `references/wsp-methodology.md`).

It sits in Marketing & SEO. The repository describes itself as: Claude-type skills for institutional equity research — 25 AI agent skills with SEC filings, XBRL financials, earnings calendars, DCF/comps/LBO models, and PPT generation. Powered… The licence is Apache-2.0.

When your agent uses it

  • Marketing & SEO work in your project

Example prompts

  • “/long-short-construction”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Construction methodology — references/construction-methodology.md (bundled exposure framework)
  2. Strategy frameworks — search_investment_strategies(domain=fundamental, kind=position_sizing)
  3. Historical analogues — search_by_analogue(market_regime=...) for regime-specific exposure precedent
  4. Market data — ~~market_data placeholder for beta estimation and borrow/short-interest inputs

What it can do on your machine

Read from SKILL.md and the folder at commit 86980e1. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Long Short Construction loads about 2.2k tokens when it runs, and up to ~7.1k if it reads all its reference files. Until then it costs about 52 tokens; SKILL.md has 950 words of instructions outside code blocks.

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

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 agentii-ai/agentii-investment-intelligence at commit 86980e1, republished under its Apache-2.0 licence (© agentii-ai). 950 words, ~2,156 tokens.

Download SKILL.mdSave it as .claude/skills/long-short-construction/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
long-short-construction
description
Long short portfolio construction, market neutral positioning, factor-balanced book, gross and net exposure management, pair selection, beta hedging, portfolio construction methodology
multi_ticker_semantics
single_target
temporal_scope.default_quarters
4
temporal_scope.max_quarters
12
temporal_scope.description
4 quarters default for long-short-construction analysis; up to 12 for regime context.
retrieval_scope
structured_only
layer_tags
L3
min_tool_diversity
3
parameter_free
false

Methodology fused from institutional portfolio-construction and buy-side long/short frameworks; all text is an original paraphrase.

Defaults

ParameterDefault ValueRationale
lookback_quarters4Standard window for beta and correlation estimation
gross_exposure_target150%Mid-range of the 130-200% institutional band
net_exposure_band-20% to +60%Defines strategy identity; outside this is style drift
beta_net_deviation_max15ppGap between raw and beta-adjusted net above which the hedge is mis-specified
max_long_position5%Standard conviction sizing
max_short_position3%Halved for unbounded loss and adverse position drift
max_days_to_cover5Squeeze avoidance on any single short

Preflight

Run canonical pre-flight per contracts/preflight.md. Include the X-Agentii-Trace header on every tool call per contracts/x-agentii-trace-header.md — carry the _run_id from your first tool result and name yourself (and your parent, if you were spawned).

Data Source Priority

  1. Construction methodology — references/construction-methodology.md (bundled exposure framework)
  2. Strategy frameworks — search_investment_strategies(domain=fundamental, kind=position_sizing)
  3. Historical analogues — search_by_analogue(market_regime=...) for regime-specific exposure precedent
  4. Market data — ~~market_data placeholder for beta estimation and borrow/short-interest inputs

Methodology

Retrieval Scope

structured_only

Retrieval Strategy

Ownership & insider signals: search_institutional_holdings (top-10 holders + whale portfolios, direction=accumulating|reducing|new|exited) and search_insider_trades (Form-4 transactions with SEC URLs) are available as signal inputs.

Branch (a) Structured Data Query from contracts/retrieval.md. Retrieve construction frameworks via search_investment_strategies; retrieve regime precedent via search_by_analogue. Detailed methodology in references/construction-methodology.md.

Temporal Scope

See frontmatter temporal_scope block.

Tool Allowlist

See frontmatter allowed_tools.

Protocol

Gross and net exposure are two independent dials. Gross sets how much stock-specific opportunity the book harvests; net sets how much of the return is simply the market. Raising gross while holding net constant is the defining move of long/short construction — it is what separates the strategy from levered long-only. Full derivations, attribution worked examples, and book-level limit tables are in references/construction-methodology.md.

Foundational principle: return tracks net exposure, not gross. Adding equal-beta shorts to a long book halves the return without improving selection. A short book that exists only to damp beta is a pure drag — shorts must earn their own alpha, or index-level hedging is the cheaper and more honest instrument.

Steps
  1. Exposure Inventory: Compute long %, short %, gross (L+S), and raw net (L−S) against NAV. Record the starting point before any proposed change.

  2. Beta-Adjusted Net (the decision-grade measure): Compute (Long% x weighted long beta) - (Short% x weighted short beta). Raw net silently assumes both sides share market sensitivity. High-beta growth longs hedged with defensive low-beta shorts can carry more directional risk than raw net implies. If raw and beta-adjusted net diverge by more than beta_net_deviation_max, the hedge is mis-specified — re-select or re-size the short side rather than reporting raw net.

  3. Risk Decomposition: Confirm the book's residual is idiosyncratic. Market components offset across paired exposure, leaving long-side plus short-side company/industry risk. Note the failure mode explicitly: with beta removed there is no tailwind to carry weak selection.

  4. Short-Side Classification: Separate alpha shorts (held to earn a return on their own thesis) from index shorts (held to damp beta). These are not interchangeable — using alpha shorts as a beta hedge pays the analytical cost of the former for the return profile of the latter. Screen every alpha short against the seven structural constraints (market long bias, unbounded loss, timing, borrow availability, short interest and days-to-cover, volatility asymmetry, sizing).

  5. Position Drift Check: Short weights move adversely by construction — a losing short grows into the book while a losing long shrinks out of it. Schedule re-sizing rather than relying on stops alone. Flag any short exceeding max_short_position or max_days_to_cover.

  6. Pair Integrity (when expressing an explicit pair): same primary risk factor on both legs; beta-match rather than dollar-match; each leg must clear the research bar independently; name the divergence catalyst and its date range; size for the decoupled case, since correlated legs decouple precisely under the stress the pair was built to survive.

  7. Sensitivity Grid: Publish fund return across a −20% to +20% market range. The slope of the row is net exposure; the intercept is alpha. Diagnose both separately — a book can post a good return while its intercept is zero and its slope is merely large.

  8. Limit Reconciliation: Check gross, net band, sector net, and per-position sizes against Defaults. Recompute all three exposure measures after every position change; the two dials stay independent only if measured continuously, otherwise a series of individually reasonable trades silently converts a hedged book into a levered directional one.

  9. Output: Report both exposure measures, the attribution split (beta contribution vs alpha contribution per side), the sensitivity grid, and every limit breach.

Show full SKILL.md (213 more words)Show less

Output File

{ticker}/{YYYY-MM-DD_HHMM}_long-short-construction_{affix}.md

Output Structure

  1. Executive Summary — current gross/net/beta-adjusted net and whether the book sits within its mandate band
  2. Exposure Table — long %, short %, gross, raw net, beta-adjusted net, with weighted betas per side
  3. Attribution Split — beta contribution vs alpha contribution for the long and short books separately
  4. Short-Side Review — alpha vs index classification, seven-constraint screen, days-to-cover and borrow status
  5. Pair Detail — per-pair legs, beta match, divergence catalyst and expected window
  6. Sensitivity Grid — fund return across −20% to +20% market range, with slope (net) and intercept (alpha) called out
  7. Limit Reconciliation — every Defaults threshold with pass/breach status
  8. Historical Analogues — regime-matched exposure precedent with /v/ citations
  9. Coverage Gaps — missing betas, unavailable borrow data, degraded-mode flags

Error Handling

ErrorFallback
No beta data for a holdingUse sector-median beta; flag the substitution and widen the reported beta-adjusted net as a range
Borrow / short-interest data unavailableReport the short as unverified for squeeze risk; do not clear it against max_days_to_cover
search_investment_strategies unreachableProceed with references/construction-methodology.md; annotate coverage_gap
search_by_analogue returns emptyContinue without regime precedent; flag reduced confidence on the exposure band

Memory Load

See contracts/memory-load.md.

Snapshot

See contracts/snapshot-synthesis.md.

Final Summary (TUI)

Include ### Key Citations block with 0-10 clickable /v/ URLs.

References

  • references/construction-methodology.md
  • contracts/citation-and-memory.md
  • contracts/retrieval.md
  • contracts/output-frontmatter-schema.md
  • contracts/memory-load.md
  • contracts/snapshot-synthesis.md
  • contracts/preflight.md

© agentii-ai, Apache-2.0. 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 3 other files (references) in plugins/vertical-plugins/portfolio-strategy/skills/agentii/long-short-construction of agentii-ai/agentii-investment-intelligence.

  • SKILL.md
  • references/construction-methodology.md
  • references/modes.md
  • references/wsp-methodology.md

Open the folder on GitHubat commit 86980e1

Compare with similar skills

Long Short Construction 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.

Long Short Construction compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Long Short Construction this skillagentii-ai/agentii-investment-intelligence207—~2.2kAutomated safety check: PassApache-2.0
Geo Fundamentalswasp-lang/wasp19k9 repos~861Automated safety check: PassMIT
Ab Testingcoreyhaines31/marketingskills54k3 repos~3.1kAutomated safety check: PassMIT
Hreflang and International SEOAgriciDaniel/claude-seo19k5 repos~3.4kAutomated safety check: PassMIT
Referralscoreyhaines31/marketingskills54k2 repos~2.6kAutomated safety check: PassMIT
SEO GeoReScienceLab/opc-skills1.8k4 repos~2.1kAutomated safety check: PassApache-2.0

Similar skills

  • Geo Fundamentals

    wasp-lang/wasp

    Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity).

    19k GitHub starsUsed in 9 repos~861 tokens
    Marketing & SEOAuto-check passed
  • Ab Testing

    coreyhaines31/marketingskills

    When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program.

    54k GitHub starsUsed in 3 repos~3.1k tokens
    Marketing & SEOAuto-check passed
  • Hreflang and International SEO

    AgriciDaniel/claude-seo

    Audits, validates and generates hreflang tags for multi-language and multi-region sites in HTML, HTTP headers or XML sitemaps, flagging common code and return-tag mistakes.

    19k GitHub starsUsed in 5 repos~3.4k tokens
    Marketing & SEOAuto-check passed
  • Referrals

    coreyhaines31/marketingskills

    When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy.

    54k GitHub starsUsed in 2 repos~2.6k tokens
    Marketing & SEOAuto-check passed
  • SEO Geo

    ReScienceLab/opc-skills

    SEO & GEO (Generative Engine Optimization) for websites. An agent skill from ReScienceLab/opc-skills.

    1.8k GitHub starsUsed in 4 repos~2.1k tokens
    Marketing & SEOAuto-check passed
  • Ad Creative

    LeoYeAI/openclaw-marketing-skills

    When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform.

    1k GitHub starsUsed in 8 repos~3.4k tokens
    Marketing & SEOAuto-check passed

More from agentii-ai/agentii-investment-intelligence

All 79 skills in this repo
  • Challenge

    agentii-ai/agentii-investment-intelligence

    Adversarial verification of research theses — cross-run/cross-thesis contradiction via the entity index, pre-mortem (Klarman/Kahneman: assume the loss already happened, reverse the path), inversion…

    207 GitHub stars~735 tokensUpdated 11 days ago
    Auto-check passed
  • Chart Patterns

    agentii-ai/agentii-investment-intelligence

    Chart pattern recognition, price action patterns, candlestick signal bars, pullback bar counting H1/H2/H3/H4, trend channels, micro channels, trading ranges, breakouts, major trend reversals 5-step…

    207 GitHub stars~2k tokensUpdated 11 days ago
    Auto-check passed
  • Clarify

    agentii-ai/agentii-investment-intelligence

    The research-domain clarification skill — find underspecified items in a thesis spec.md (prose wrongif, universe rows without rationale, missing budget/expiry/pins, ambiguous pillars), ask the human…

    207 GitHub stars~839 tokensUpdated 11 days ago
    Auto-check passed
  • Constitution

    agentii-ai/agentii-investment-intelligence

    Scaffold and amend the L1 Investment Constitution — [ALLCAPS] placeholder bootstrap, SemVer bump rules, Sync Impact Report, MINOR/MAJOR re-examination dispatch after the gate-5 budget confirm.

    207 GitHub stars~596 tokensUpdated 11 days ago
    Auto-check passed
  • Converge

    agentii-ai/agentii-investment-intelligence

    Append-only gap closure and the cadence engine for research theses.

    207 GitHub stars~789 tokensUpdated 11 days ago
    Auto-check passed
  • Implement

    agentii-ai/agentii-investment-intelligence

    Execute research tasks — checklist soft gate, phase dispatch with explicit thesisdir, budget enforcement (halt + approval card on overrun), skillpin recording (versionhash content-hashed per skill…

    207 GitHub stars~583 tokensUpdated 11 days ago
    Auto-check passed

Categories

Questions about Long Short Construction

What does Long Short Construction do?

Long short portfolio construction, market neutral positioning, factor-balanced book, gross and net exposure management, pair selection, beta hedging, portfolio construction methodology. Long Short Construction is an agent skill from agentii-ai/agentii-investment-intelligence.

When should I use Long Short Construction?

Long Short Construction fits situations like: marketing & SEO work in your project.

How do I install Long Short Construction in Claude Code?

Run `npx skills add agentii-ai/agentii-investment-intelligence --skill long-short-construction -a claude-code`. Or copy the skill folder (plugins/vertical-plugins/portfolio-strategy/skills/agentii/long-short-construction in agentii-ai/agentii-investment-intelligence) into .claude/skills/long-short-construction in your project. Claude Code loads it when a task matches its description.

How do I install Long Short Construction in Codex?

Run `npx skills add agentii-ai/agentii-investment-intelligence --skill long-short-construction -a codex`. Or copy the skill folder (plugins/vertical-plugins/portfolio-strategy/skills/agentii/long-short-construction in agentii-ai/agentii-investment-intelligence) into .agents/skills/long-short-construction in your project. Codex loads it when a task matches its description.

Can I use Long Short Construction 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 agentii-ai/agentii-investment-intelligence --skill long-short-construction -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/long-short-construction, .gemini/skills/long-short-construction, .github/skills/long-short-construction and .opencode/skills/long-short-construction in your project.

What does Long Short Construction need to run?

SKILL.md names no scripts, command-line tools or credentials: Long Short Construction is instructions for the agent only.

Does Long Short Construction access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Long Short Construction 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 Long Short Construction use?

Long Short Construction is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Long Short Construction use?

About 2.2k tokens (SKILL.md is roughly 8.6k 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 5k tokens, read only when the agent opens those files.

What are the alternatives to Long Short Construction?

Skills that share tags, products or a category with Long Short Construction: Geo Fundamentals (wasp-lang/wasp, 19k stars), Ab Testing (coreyhaines31/marketingskills, 54k stars), Hreflang and International SEO (AgriciDaniel/claude-seo, 19k stars) and Referrals (coreyhaines31/marketingskills, 54k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Long Short Construction?

agentii-ai (a GitHub user) maintains it in agentii-ai/agentii-investment-intelligence, which has 207 GitHub stars. The repository holds 79 skills in this directory. The repository was last updated on September 29, 2026.

Source: agentii-ai/agentii-investment-intelligence on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.