linear-walkthrough

Generate linear narrative walkthroughs of codebases, diagrams, and documents.

16|4|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/rianvdm/product-ai-public --skill linear-walkthrough-rianvdm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-walkthrough
Source: https://github.com/rianvdm/product-ai-public/tree/main/.opencode/skills/linear-walkthrough
Command: npx skills add https://github.com/rianvdm/product-ai-public --skill linear-walkthrough-rianvdm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill generates linear, narrative walkthroughs of source material — code, documents, architecture diagrams, meeting notes, Jira tickets, or any combination. It produces a step-by-step guide that explains logic, purpose, and connections between components in a readable sequence. Use when the user wants to understand how something works, wants to explain a system to others, asks to "walk through" or "explain" code or docs, or needs to document a system's logic for learning or onboarding. Also trigger when the user provides files or code and asks "how does this work?" or "take me through this."

Core Features & Use Cases

  • Generative walkthroughs that map from inputs to explained outcomes, with logical progression and clear sectioning.
  • Audience-aware narration for PM-level readers or engineering audiences, including optional "Under the Hood" detail.
  • Structured output with orient/explain/connect flow and an Obsidian-friendly note format.

Quick Start

Provide materials to explain and specify audience and depth, then request a linear walkthrough.

Frequently Asked Questions about linear-walkthrough

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a narrative walkthrough to explain a codebase to new engineers?

A narrative walkthrough explains a codebase by generating a linear, step-by-step guide that details logic, purpose, and connections between components in a readable sequence. It structures output with oriented sections and connect-the-dots flow to educate readers.

What is the best way to document system architecture from meeting notes and Jira tickets?

Documenting system architecture from meeting notes and Jira tickets is best done by generating a linear walkthrough that maps inputs to explained outcomes. This produces a structured note format with logical progression, clear sectioning, and an Uncertainties & Assumptions section.

Can I generate onboarding documentation tailored for both PM and engineering audiences?

Yes, you can generate onboarding documentation tailored for both PM and engineering audiences. The walkthrough produces audience-aware narration, offering high-level logic for PMs while including optional "Under the Hood" technical callouts for engineering readers.

How do I format code explanation notes for Obsidian?

To format code explanation notes for Obsidian, generate a linear walkthrough that produces a Markdown note format suitable for the application. This output includes structured sections, narrative connections, and an Uncertainties & Assumptions block for comprehensive documentation.

Does this walkthrough approach work with architecture diagrams and source code combined?

Yes, the walkthrough approach works with architecture diagrams and source code combined. It accepts codebases, documents, diagrams, meeting notes, or Jira tickets in any combination to educate readers and onboard teammates across different levels.

When should I use a linear walkthrough instead of standard code documentation?

Use a linear walkthrough instead of standard documentation when you need to explain how a system works as a readable sequence. It is ideal for onboarding teammates, providing learning materials, or mapping logical progression when someone asks how a system functions.