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

# Skills Overview

> Workflow-pattern skills for GDELT Cloud analytical tasks

## What Are Skills?

Skills are MCP resources that provide workflow-pattern guidance. Each skill defines how to approach a class of analytical task: what tools to call, how to sequence them, how to interpret signals, how to structure outputs, and how to cite sources.

Skills are served from the MCP server's `skills/tasks` directory and loaded at runtime as resources.

<Info>
  Skills complement the [research system prompt](/mcp/prompts/system-prompt). The system prompt establishes analyst voice, the four-surface mental model, and citation discipline. A skill provides the deeper workflow for a particular question shape.
</Info>

<Tip>
  Brief production skills are served separately under `skills/briefs`. The hosted Brief agent preloads the shared tradecraft skill plus one Brief-type skill, then applies the matching `briefs.v1` structured output schema from shared contracts.
</Tip>

## Available Skills

Task skills are oriented around **workflow patterns**, not vertical topics. Load them on demand based on the question shape.

<CardGroup cols={2}>
  <Card title="GDELT Discover-and-Drill" icon="layer-group" href="/mcp/skills/gdelt-discover-and-drill">
    The canonical GDELT Cloud workflow: summarize → search → drill, over-filter recovery, graph traversal recipes for Events, Stories, and Entities.
  </Card>

  <Card title="Macro Finance" icon="chart-line" href="/mcp/skills/macro-finance">
    Symbol resolution and the \~120-tool macro-finance category — analytics, fundamentals, options chains, sentiment, US macro, FX, crypto, commodities, technical indicators.
  </Card>

  <Card title="Prediction Markets" icon="square-poll-vertical" href="/mcp/skills/prediction-markets">
    SEARCH\_RELEVANT\_MARKETS-first patterns, the proxy-contract pattern for legally-sensitive scenarios, contract-quirk caveats, reading rules\_primary and liquidity fields.
  </Card>

  <Card title="Multi-Surface Synthesis" icon="diagram-project" href="/mcp/skills/multi-surface-synthesis">
    Combining GDELT Cloud + macro-finance + prediction markets to find the divergence; five canonical divergence shapes; weighting rules for conflicting signals.
  </Card>

  <Card title="Brief Output" icon="file-lines" href="/mcp/skills/brief-output">
    BLUF / inverted-pyramid analyst brief format with per-evidence-type citation templates and `gdelt-event` fenced blocks.
  </Card>

  <Card title="Brief Skills" icon="file-text" href="/mcp/skills/briefs">
    Daily Risk, Crisis SITREP, I\&W Watch, and Exposure Monitor skills for the hosted Brief agent.
  </Card>
</CardGroup>

## Skill Selection Logic

| User Request                                                         | Skills                                                                                         |
| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Geopolitical brief on a topic                                        | `gdelt-discover-and-drill` + `brief-output`                                                    |
| "What's the market saying / pricing in?"                             | `gdelt-discover-and-drill` + `macro-finance` + `multi-surface-synthesis` + `brief-output`      |
| Scenario probability with narrative context                          | `gdelt-discover-and-drill` + `prediction-markets` + `multi-surface-synthesis` + `brief-output` |
| Actor exposure / portfolio risk from an event                        | `gdelt-discover-and-drill` + `macro-finance` + `multi-surface-synthesis` + `brief-output`      |
| Three-surface synthesis (high-leverage default)                      | All five                                                                                       |
| Lookup, comparison, or procedural task                               | None — answer directly                                                                         |
| Generate a Daily Risk / SITREP / I\&W Watch / Exposure Monitor Brief | `brief-tradecraft` + the selected Brief skill                                                  |

When loading multiple skills, treat `gdelt-discover-and-drill` as the **anchor**. It produces the dates, actors, locations, and entities the other skills consume.

## How Skills Are Loaded

Skills are served as MCP resources with URIs in the format `skill://{name}/SKILL.md`.

```python theme={null}
# Example: load a skill resource via FastMCP client
from fastmcp import Client
from fastmcp.client.auth import BearerAuth

async with Client(
    "https://gdelt-cloud-mcp.fastmcp.app/mcp",
    auth=BearerAuth(token=api_key)
) as client:
    # List available skills
    resources = await client.list_resources()
    skill_resources = [r for r in resources if str(r.uri).startswith("skill://")]

    # Load a specific skill
    skill = await client.read_resource("skill://gdelt-discover-and-drill/SKILL.md")
    print(skill[0].text)
```

LangGraph or LangChain integrations can preload these resources when initializing the GDELT Cloud MCP server. Hosted GDELT Cloud agents load skills on demand from the same MCP resource set.