# Company Research

> Run company research using Primr. Use when the user asks to research, analyze, or investigate a company, or provides a company URL.

- Skill: `majiayu000/company-research-3` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/company-research-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/company-research-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/company-research-3

---


# Company Research

## Workflow

1. **Check prior research**: `get_hypotheses(company)` -- present any existing findings to user
2. **Estimate cost**: `estimate_run(company, url, mode)` -- always before starting
3. **Get user approval**: show estimated cost and duration
4. **Start research**: `research_company(company, url, mode)` -- returns job_id immediately
5. **Monitor**: poll `check_jobs()` every 2 minutes until complete
6. **Present results**: show report path and any new hypotheses

## Research Modes

See `references/modes.md` for mode details (cost, duration, use cases).

## Hypothesis Management

When user confirms or rejects a claim during research:

```
save_hypothesis(company, hypothesis_id, "validated", evidence)
save_hypothesis(company, hypothesis_id, "invalidated", evidence)
```

## Error Handling

| Error | Resolution |
|-------|------------|
| `budget_exceeded` | Hook blocked operation; request budget increase |
| `ssrf_blocked` | URL failed security check; use deep mode instead |
| `qa_below_threshold` | Report quality low; suggest refinement |
| `job_already_running` | Wait for current job; use `check_jobs` |

## Example Workflow

```
User: "Research Acme Corp at https://acme.com"

1. get_hypotheses("Acme Corp")
   -> Found 2 prior hypotheses from last session

2. Present to user:
   "I found prior research on Acme Corp:
    - [VALIDATED] Uses microservices architecture
    - [UNTESTED] Revenue growth exceeds 20% YoY
    Shall I continue with new research?"

3. estimate_run("Acme Corp", "https://acme.com", "full")
   -> Cost: $3.50, Time: ~30 minutes

4. Request approval:
   "Full research will cost ~$3.50 and take ~30 minutes.
    Reply 'approve' to proceed."

5. research_company("Acme Corp", "https://acme.com", "full")
   -> Job started: job_abc123

6. Poll check_jobs() until complete

7. Present results and new hypotheses
```

## Constraints

- **Single Job**: Only one research job at a time
- **Cost Awareness**: Always estimate before running
- **Memory Persistence**: Hypotheses survive across sessions
- **QA Gate**: Reports below score 70 trigger warnings