# kgmkm/muse-grok-x-search architecture

> Architecture diagram of the GitHub repository kgmkm/muse-grok-x-search, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kgmkm/muse-grok-x-search
- Repository: https://github.com/kgmkm/muse-grok-x-search

## Overview

This repository is a Muse skill, not a standalone search service: Muse uses its instructions to invoke Grok Build, which uses its built-in X search capability and returns summarized public-post results. The README documents this workflow and the research-only constraint. No source excerpts were provided, so implementation details beyond those documented are omitted.

Main entry points: [`SKILL.md`](https://github.com/kgmkm/muse-grok-x-search/blob/main/SKILL.md) (X Search Skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_muse(("Muse"))
node_skill["X Search Skill<br/>[SKILL.md]"]
node_grok["Grok Build CLI"]
node_xsearch["x_search Tool"]
node_xposts[("Public X Posts")]
node_results["Search Summaries"]

node_muse -->|"uses"| node_skill
node_skill -->|"invokes"| node_grok
node_grok -->|"uses"| node_xsearch
node_xsearch -->|"searches"| node_xposts
node_grok -->|"summarizes"| node_results
node_results -.->|"returns to"| node_muse

click node_skill "https://github.com/kgmkm/muse-grok-x-search/blob/main/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_muse,node_grok,node_xsearch,node_results toneIndigo
class node_skill toneTeal
class node_xposts toneAmber
```

## Components

### Other components

- **Muse**
- [X Search Skill](https://github.com/kgmkm/muse-grok-x-search/blob/main/SKILL.md): `SKILL.md`
- **Grok Build CLI**
- **x_search Tool**
- **Public X Posts**
- **Search Summaries**

## Connections

- Muse → X Search Skill: uses (evidence: `README.md`)
- X Search Skill → Grok Build CLI: invokes (evidence: `README.md`)
- Grok Build CLI → x_search Tool: uses (evidence: `README.md`)
- x_search Tool → Public X Posts: searches (evidence: `README.md`)
- Grok Build CLI → Search Summaries: summarizes (evidence: `README.md`)
- Search Summaries → Muse: returns to