bashticle

name	bashticle
description	Create interactive bash articles (bashticles) from markdown blog posts with streaming text, command execution, and user interaction

Bashticle

Transform markdown blog posts into interactive bash scripts that users can read and execute directly from their terminal.

When to Use

Use this skill when a user asks to:

• "Create a bashticle from this markdown"
• "Turn this article into an interactive bash script"
• "Make a terminal-based interactive article"
• "Convert blog.md to a bash article"

Two-Phase Approach

Bashticle creation uses a two-phase approach:

Phase 1: Generator Script (Boring, Structural)

The bashticle-generator.sh script does the structural work:

# Run the generator
bashticle-generator.sh article.md
# Or with custom output:
bashticle-generator.sh article.md --output-file custom.sh

What it does:

• Parses markdown for structure (title, sections)
• Generates basic bashticle with STANDARD options only
• Creates section function stubs
• Builds main navigation flow

Standard options included:

• --step - Jump to specific section
• --run-command / -r - Execute commands vs echo
• --dry-run / -d - Echo only (default: ON)
• --stream / -s - Enable streaming (default: ON)
• --verbose / -v - Verbose output

Phase 2: AI (Smart, Context-Aware)

The AI (via this skill) enhances the bashticle:

1. : Original markdown + generated bashticle