narrative-identity

Narrative Skills Marketplace

An agent skills marketplace from Narrative I/O.

Interactive, AI-powered workflows that walk you through the recurring work of a modern data company — mapping schemas, writing NQL, qualifying leads, shipping code, building decks — one approval at a time.

Versioning. The marketplace as a whole ships under CalVer (YYYY.MM.PATCH) — see the latest release for what's stable today. Individual plugins and skills carry their own SemVer in their manifests and may iterate between marketplace releases. Pin a release tag (e.g. git checkout v2026.05.0) — not main — if you depend on a specific shape; main moves between tagged releases.

What is this?

A marketplace of agent skills. Each plugin bundles one or more skills — interactive slash commands like /write-nql or /generate-rosetta-stone-mappings that turn a recurring task into a guided, AI-augmented workflow.

Install the marketplace, type a slash command in your agent, and the skill takes it from there: it asks the right questions, does the research, drafts the artifact, and waits for your approval before acting on anything outside your repo.

Skills follow the Agent Skills spec and run in any spec-compliant harness. The bundled bash setup installer has two modes: a Claude Code path (uses the claude CLI to register the marketplace) and a --portable path that builds a dist/ tree any agentskills.io-compliant harness can consume — see Install on other harnesses.

Every rendered SKILL.md is committed; CI fails if any rendered file is stale relative to its .tmpl. Other harnesses can clone this repo (or read from raw.githubusercontent.com) without running Bun.

Want the design philosophy? See AGENTS.md — "interactive, not reference," "drafts, not actions," "evidence over assumptions," etc.

Install on Claude Code

git clone https://github.com/narrative-io/narrative-skills-marketplace
cd narrative-skills-marketplace
bash setup

setup registers the marketplace, installs every plugin listed below, and regenerates the catalog in this README.

Requirements

• Claude Code CLI on PATH
• Bun ≥ 1.1 (used for template rendering + scripts)

Install on other harnesses

The skills are spec-portable. Each plugins/<plugin>/skills/<skill>/ directory is a self-contained Agent Skill (rendered SKILL.md plus any references/ / scripts/ / assets/). The discovery index lives at skills.json; MCP server configs live under mcp/.

To build a flat, plugin-namespace-free distribution at dist/:

bash setup --portable      # or: bun run build:portable

This emits dist/skills/<skill>/ (one folder per skill, no plugin nesting), dist/mcp/*.mcp.json, and dist/skills.json. Then: