Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.narrative.io/llms.txt

Use this file to discover all available pages before exploring further.

Skills are pre-built workflows that orchestrate Narrative’s MCP server to complete specific tasks — drafting NQL queries, generating Rosetta Stone mappings, building identity graphs, and more. Skills are harness-agnostic, but Narrative distributes them as Claude Code plugins; this guide walks through installing them in Claude Code.

​
Prerequisites

  • Claude Code installed and updated to a version that supports the /plugin command.
  • The Narrative MCP server connected to Claude Code. See Connecting to the Narrative MCP Server if you haven’t set this up yet.
  • A Narrative account with access to the active company you want the skills to operate against.
Skills run inside Claude Code and call the MCP server on your behalf. Without an active MCP connection, the skills can’t reach your Narrative data.

​
Install a plugin

Narrative publishes its skills as Claude Code plugins from the public narrative-io/narrative-skills-marketplace repository. You add the marketplace once, then install whichever plugins you want.
1

Add the Narrative skills marketplace

In a Claude Code session, run:
/plugin marketplace add narrative-io/narrative-skills-marketplace
Claude Code fetches the marketplace manifest and lists the available plugins. You only need to do this once.
2

Install the plugin

Install the plugin that contains the skill you want. For general-purpose authoring, querying, and Rosetta Stone work:
/plugin install narrative-common@narrative-skills-marketplace
For identity resolution work:
/plugin install narrative-identity@narrative-skills-marketplace
Installing a plugin makes every skill it contains available in the current Claude Code session.
3

Verify the skill is loaded

In a Claude Code chat, ask Claude to describe its available skills. You should see entries for each skill in the plugin you installed (for example, Find Attribute, Write NQL, Design Analysis).

​
Use a skill

Once a plugin is installed, you invoke its skills with natural-language prompts. Claude routes the request to the matching skill and follows its instructions. For example, with the narrative-common plugin installed: 
Find the Rosetta Stone attribute for a SHA-256 hashed email.
Claude calls the Find Attribute skill, which uses the narrative_attributes_search and narrative_attributes_describe MCP tools to resolve the description to a canonical attribute ID (sha256_hashed_email). Each skill’s detail page in the Skills catalog lists example prompts and the use cases each one addresses.
Skills that produce artifacts — NQL queries, workflow specifications, mapping definitions — always show you the draft and wait for explicit approval before submitting it. You can edit the draft or ask Claude to revise it before saying “go.”

​
Where skills run

Skills run on your machine inside Claude Code. They reach Narrative through the MCP server using the OAuth credential you established when you connected Claude Code to the server. Skills never bypass MCP — every action they take is a tool call you can inspect in the Claude Code transcript. This also means skills inherit MCP’s company scoping: they operate against whichever company is active in your MCP session. Use the narrative_context_set_company tool (or ask Claude to switch companies) before invoking a skill if you need to target a different account.

​
Update or remove a plugin

To remove a plugin you no longer need: 
/plugin uninstall narrative-common@narrative-skills-marketplace
To pull the latest version of a plugin after Narrative publishes an update: 
/plugin update narrative-common@narrative-skills-marketplace
The skill version shown on each catalog detail page matches the semver in the skill’s SKILL.md frontmatter. Reinstall the plugin to pick up newer versions.

​
Next steps

Skills concepts

How skills relate to the MCP server, plugins, and runtimes.

MCP tool reference

The underlying tools that skills call.

Connect to the MCP server

Set up the OAuth connection skills depend on.

Browse the Skills catalog

Every published skill with example prompts and install commands.