Documentation

CLI commands, GitHub Actions, review types, and spec structure.

Storyline Skill

The skill teaches your coding assistant to create and maintain structured feature specs as you write code. It works with any agent that supports skills.

Install

npx skills add bjornno/skills --skill storyline

This installs the skill into .agents/skills/storyline/ in your workspace. It creates the specs/ folder structure and manages files automatically.

Or install via the CLI

If you run npx storyline-review create in a project without the skill installed, the CLI will offer to install it for you.

# This will detect missing skill and offer to install

npx storyline-review create

# Or install the skill directly

npx storyline-review install-skill

Compatible agents

Cursor

Reads .agents/skills/ automatically

Claude Code

Reads AGENTS.md or .agents/ folder

GitHub Copilot

Uses .github/copilot-instructions.md or skills folder

Codex

Works with AGENTS.md or custom instructions

Windsurf

Reads .agents/ folder

Any agent

That supports custom instructions or skills

What the skill does

Creates specs from code

Ask your assistant to "map the codebase with storyline" and it creates structured specs for every feature it finds.

Updates specs as you code

When you make code changes, the skill automatically updates the relevant spec files — acceptance criteria, design docs, changelogs.

Implements from specs

Write specs first, then ask your assistant to implement from them. The skill bridges intent and code.

Suggests reviews

After significant changes, the skill proactively suggests creating a review — so your team can weigh in before you move on.

Common prompts

"Run storyline on the whole codebase" Generate specs for every feature

"Map our auth feature using storyline" Create specs for a specific feature

"Start review" or "Create a review" Create a hosted review session

"Apply review" Read exported review results and update specs/code

"Refresh overview" Update specs/OVERVIEW.md

"Sync feature" Update specs to match current code

Source code: The skill is free and open source. View on GitHub