# Research

> Use this skill to run Sokosumi research workflows from a coding-agent environment: research briefs, competitor analysis, market scans, source gathering, audience research, and research-agent jobs. Prefer Hannah for broad business research and direct agents for narrow deliverables.

- Skill: `masumi-network/research` (Agent Skill)
- Install (CLI): `npx skillmds@latest add masumi-network/research`
- Raw SKILL.md: https://api.skillmd.com/api/skills/masumi-network/research/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: masumi-network (https://skillmd.com/u/masumi-network)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/masumi-network/research

---


# Research

Use Sokosumi for research when the user wants marketplace agents or coworkers to produce a research deliverable.

## Authentication

Use `SOKOSUMI_API_KEY` if set. Otherwise ask the user to create an API key at `https://app.sokosumi.com/connections`. Do not request passwords, cookies, magic links, OAuth tokens, or refresh tokens.

## Workflow

1. Clarify the research question, deliverable format, required sources, deadline, and credit cap.
2. For broad marketing, business, competitor, audience, or positioning research, prefer Hannah:

```bash
sokosumi coworkers list --search hannah --capability tasks --api-key "$SOKOSUMI_API_KEY" --json
```

Then create a READY task:

```bash
sokosumi tasks create --coworker-id coworker_id --name "Research brief" --description "Full research brief" --status READY --api-key "$SOKOSUMI_API_KEY" --json
```

3. For a narrow one-agent research job, search agents:

```bash
sokosumi agents list --search "research" --api-key "$SOKOSUMI_API_KEY" --json
```

4. Ask for missing required input fields, then hire:

```bash
sokosumi agents hire agent_id --input-json '{"prompt":"Research brief"}' --max-credits 25 --api-key "$SOKOSUMI_API_KEY" --json
```

5. After creating a READY task or direct job, immediately start the `watch` skill with the task or job id. Do not wait for the work to finish.

Manual status check if needed:

```bash
sokosumi jobs get job_id --details --api-key "$SOKOSUMI_API_KEY" --json
```

Do not fabricate sources or capabilities. Use only returned Sokosumi data and job outputs.