| name | competitive |
| multi_ticker_semantics | target_with_required_peers |
| description | Competitive landscape analysis, competitor comparison, peer positioning, market share dynamics, competitive moat assessment, Porter five forces, industry competition, competitive advantage analysis, market positioning, strategic group mapping, compare competitors |
| temporal_scope | {"default_quarters":4,"max_quarters":12,"description":"Typical lookback: 4 quarters, max: 12"} |
| allowed_tools | ["search_companies","search_xbrl_facts","search_documents","search_sec_filings","get_company_financials","list_coverage","search_earnings_calendar","get_company_profile","batch_search","read_source_outline","read_source_deep_outline","list_xbrl_concepts","read_source_pages","search_keyword_in_source"] |
| retrieval_scope | unstructured_document_search |
| min_tool_diversity | 10 |
Preflight
Run the canonical pre-flight sequence — MCP health probe, ticker resolution, workspace style.md override, memory load, and coverage check. See contracts/preflight.md.
Include the X-Agentii-Trace header on every tool call per contracts/x-agentii-trace-header.md.
Triggers
- analyze dim competitive landscape
- run dim competitive landscape analysis
- produce dim competitive landscape report
- dim competitive landscape breakdown
- dim competitive landscape deep dive
- build a dim competitive landscape
- assess dim competitive landscape
- quantify dim competitive landscape
- compare dim competitive landscape across peers
- review dim competitive landscape for
- generate dim competitive landscape on
- dim competitive landscape for investment decision
Defaults
| Parameter | Default | Notes |
|---|
| lookback_years | 3 | Historical data window |
| include_peers | false | Whether to surface a peer comparison block |
Methodology
Retrieval Scope
This skill performs unstructured document search at scale (10-K, 10-Q, 8-K filings spanning multiple fiscal periods). The three-layer agent-use-ready retrieval protocol (Document Discovery → Page Map → Deep Read) applies to all unstructured document search at scale.
Retrieval Strategy
Follow the retrieval strategy decision tree in contracts/retrieval.md. This skill uses:
- Branch (a) for structured financial metrics via
search_xbrl_facts with list_xbrl_concepts pre-condition for unfamiliar concepts.
- Branch (c) for single-period document queries via direct
read_source_outline → read_source_pages.
- Branch (d) for simple lookups via
get_company_profile / search_earnings_calendar.
**Layer 1 secondary_label allowlist **: prefer ?secondary_labels=material_definitive_agreement_1_01,other_events_8_01 to surface M&A / partnership / strategic-action 8-Ks before Layer 2.
Temporal Scope
Default: 8 fiscal quarters (max 16). Competitive landscape: 8 quarters for market-share trajectories and positioning shifts
