> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Skill

> Teach an agent to choose endpoints, control cost, and complete SocQ research workflows.

# Agent Skill

Install the `socq-social-research` Skill to teach a coding agent how to choose SocQ endpoints, shape inputs, control cost, and complete asynchronous collections.

```bash theme={"system"}
npx skills add socq-ai/socq-devtools
```

## Skill versus MCP

| Component   | Role                                                                               |
| ----------- | ---------------------------------------------------------------------------------- |
| MCP         | Gives the agent live SocQ tools that can submit and read data tasks                |
| Agent Skill | Teaches the agent which tool to choose and how to run a reliable research workflow |

Use them together when possible. MCP provides execution; the Skill provides endpoint selection, billing awareness, polling, pagination, and cross-platform workflow guidance.

## What you can ask

```text theme={"system"}
Collect the latest comments from this Instagram Reel, wait for the task,
then summarize recurring positive and negative themes.
```

```text theme={"system"}
Compare the latest posts from these three X profiles. Use the same result
limit for each profile and return a normalized engagement table.
```

```text theme={"system"}
Find recent YouTube videos about AI coding agents, collect their comments,
and explain which topics produce the strongest audience response.
```

The Skill guides the agent through:

* mapping user intent to a Capability Registry endpoint;
* choosing URL, username, hashtag, or query inputs;
* checking schemas and estimating credits before large jobs;
* submitting with an idempotency key when retries are possible;
* polling asynchronous tasks instead of resubmitting;
* following cursor pagination and retrieving raw files;
* recovering from authentication, validation, rate, credit, and provider errors;
* coordinating comparable cross-platform research.

## Execution preference

The Skill prefers:

1. remote MCP;
2. the SocQ stdio MCP bridge;
3. CLI or REST when MCP is unavailable.

Endpoint references are generated from the same Capability Registry as MCP and OpenAPI, so endpoint IDs and input fields remain consistent across integrations.