scribe

Export Minerva markdown Epics to YouTrack issues or Outline documents.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/LarryHsiao/Skadi --skill scribe-larryhsiao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scribe
Source: https://github.com/LarryHsiao/Skadi/tree/main/skills/scribe
Command: npx skills add https://github.com/LarryHsiao/Skadi --skill scribe-larryhsiao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates extracting a top-level Minerva Epic section and exporting it to YouTrack or Outline, while embedding a source frame screenshot and writing back markers into the source markdown for idempotent re-runs.

Core Features & Use Cases

  • Exports a single top-level Epic section from a Minerva markdown file to a YouTrack issue or Outline document.
  • Supports optional Outline collections, parent nesting, and per-subtask leaves, with rewrite of parent/task bodies to reflect created items.
  • Automatically writes back markers (yt/outline) into the source file to enable update paths on re-run.

Quick Start

Run the /scribe with a file and heading slug and provide --project and target as needed.

Frequently Asked Questions about scribe

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

FAQPage Schema
How do I export Minerva markdown sections to YouTrack or Outline?

Export Minerva markdown sections by running the extraction command with a specified file and heading slug, targeting a project to generate nested tracker issues or outline documents with source writeback markers.

Can I sync Minerva subtasks into nested Outline documents?

Yes, Minerva subtasks sync into nested Outline documents by supporting optional collections, parent nesting, and per-subtask leaves, rewriting parent and task bodies to reflect the newly created items.

What are writeback markers in markdown and why are they needed for Epics?

Writeback markers are identifiers embedded into the source markdown file after exporting Epics, enabling idempotent re-runs to update existing tracker items instead of creating duplicates.

Does scribe support re-running updates on previously exported Minerva sections?

Yes, re-running updates on exported Minerva sections is supported through embedded writeback markers and end-to-end update flows that ensure idempotency and error handling during hook execution.

How do I attach source frame screenshots to exported YouTrack issues?

Attach source frame screenshots to exported YouTrack issues through the skill's automated attachment handling, which embeds visual context from the original Minerva markdown section into the created tracker item.

What happens if an error occurs during Minerva markdown section extraction?

If an error occurs during Minerva markdown section extraction, the skill's error handling mechanism manages the failure gracefully across hook execution, outline or YouTrack creation, and writeback marker processes.