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

# /story — Story card

> Rich narrative deep dives on albums, artists, genres, labels, and movements

The `/story` command generates a rich narrative `StoryCard` component about any music subject — an album, artist, genre, label, event, or movement. The result includes multiple narrative chapters, a YouTube embed, a mini-playlist of key tracks, key people cards, and cited sources.

## Syntax

```
/story [topic]
```

| Parameter | Description                                         |
| --------- | --------------------------------------------------- |
| `topic`   | Any album, artist, genre, label, event, or movement |

## Examples

```
/story Donuts
```

```
/story Detroit techno
```

```
/story Blue Note Records
```

## What it produces

The agent outputs a `StoryCard` component with:

| Section           | Content                                                                                                    |
| ----------------- | ---------------------------------------------------------------------------------------------------------- |
| **Hero**          | Cover art or iconic image, title, subtitle (artist · year · label or relevant context), and category label |
| **Key facts**     | 3–5 stats — track count, samples used, sales figures, chart positions, or other relevant data              |
| **Chapters**      | 3–5 narrative chapters, each with a title, subtitle, and 2–4 paragraphs of content                         |
| **YouTube embed** | Documentary, interview, or historical footage sourced from a real search result                            |
| **Key tracks**    | Tracks mentioned in the story, rendered as a playable mini-playlist                                        |
| **Key people**    | Important people mentioned in the narrative with their roles                                               |
| **Sources**       | Cited source links from the research                                                                       |

## Topics the command works for

<CardGroup cols={3}>
  <Card title="Albums" icon="record-vinyl">
    `/story Donuts`, `/story Kind of Blue`, `/story Illmatic`
  </Card>

  <Card title="Artists" icon="user-music">
    `/story Alice Coltrane`, `/story Sun Ra`
  </Card>

  <Card title="Genres" icon="music">
    `/story Detroit techno`, `/story Afrobeat`, `/story Chicago house`
  </Card>

  <Card title="Labels" icon="building">
    `/story Blue Note Records`, `/story Stones Throw Records`
  </Card>

  <Card title="Movements" icon="diagram-project">
    `/story Golden Age hip-hop`, `/story the jazz loft era`
  </Card>

  <Card title="Events" icon="calendar">
    `/story Woodstock 1969`, `/story Detroit electronic music festival`
  </Card>
</CardGroup>

## Research steps

<Steps>
  <Step title="Perplexity research">
    One call to get a comprehensive narrative overview — this works for albums, artists, genres, movements, labels, and events in a single request.
  </Step>

  <Step title="Image search">
    For albums: `search_itunes_albums` for the cover art. For genres or movements: an iconic album cover from the era. If no image is found, the component uses a gradient fallback. The agent never fabricates image URLs.
  </Step>

  <Step title="YouTube search">
    Searches for `[topic] documentary` or `[topic] history` and uses a video ID from actual search results. The agent never guesses a YouTube video ID.
  </Step>
</Steps>

<Warning>
  The agent's entire response will be the `StoryCard` component — no introductory text, no narration. This is by design. If you want to explore a specific element further, use `/track`, `/artist`, or `/influence` after reading the story.
</Warning>

## Related commands

<CardGroup cols={2}>
  <Card title="/artist" icon="user-music" href="/commands/artist">
    Full tabbed artist profile with discography
  </Card>

  <Card title="/influence" icon="diagram-project" href="/commands/influence">
    Trace an artist or genre's musical connections
  </Card>

  <Card title="/track" icon="music" href="/commands/track">
    Deep dive on a specific track mentioned in the story
  </Card>

  <Card title="/prep" icon="radio" href="/commands/show-prep">
    Turn the story's key tracks into radio show prep
  </Card>
</CardGroup>