linear-walkthrough

Plan and execute linear code walkthroughs with runnable Showboat blocks.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/doolin/dave-skills --skill linear-walkthrough
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-walkthrough
Source: https://github.com/doolin/dave-skills/tree/main/skills/linear-walkthrough
Command: npx skills add https://github.com/doolin/dave-skills --skill linear-walkthrough

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plans and builds a linear, verifiable code walkthrough by pairing explanations with executable code blocks.

Core Features & Use Cases

  • Structured, linear narrative walkthroughs of codebases or pipelines.
  • Automated inclusion of real command outputs via showboat exec blocks.
  • Guided commentary with explanations of design decisions and pitfalls.

Quick Start

Initialize the walkthrough with uvx showboat init <file>.md "<Title>" and then add commentary with uvx showboat note and verified code blocks with uvx showboat exec.

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 verifiable code walkthrough with executable blocks?

You create a verifiable code walkthrough by pairing explanatory commentary with runnable code blocks, using showboat exec commands to capture and verify real outputs for reproducibility.

What is the best way to document a codebase onboarding flow?

Documenting a codebase onboarding flow is best done using a linear walkthrough structure that combines guided commentary on design decisions with verified, executable code blocks.

How do I initialize and add content to a showboat walkthrough file?

You initialize the walkthrough file with uvx showboat init, then add explanatory text using uvx showboat note and verified code outputs using uvx showboat exec.

Can I use this linear walkthrough approach for architecture documentation?

Yes, this linear walkthrough approach supports architecture documentation by providing structured narratives that explain design decisions and pitfalls alongside reproducible code execution.

Why does my code walkthrough documentation lose reproducibility over time?

Code walkthrough documentation loses reproducibility when outputs are pasted manually rather than captured directly, which is solved by enforcing showboat exec blocks to verify real outputs.