newsletter-composer

Newsletter Composer

Newsletter Composer je plugin pro přípravu zpravodajů Řekni si o web a Better Button z podkladů uložených v Obsidian vaultu. Funguje v GitHub Copilot CLI i v Claude Code.

Plugin slouží lidskému editorovi: vezme podklady z 00 Inbox, připraví pracovní výstupy v podsložkách aktuálního vydání, přesune použité zdroje a nakonec vloží schválené sekce do výsledné šablony vydání. Sdílené skilly a agenti tvoří společné jádro; platformní soubory zpřístupňují stejné workflow v Copilot CLI i Claude Code.

Co Plugin Umí

Plugin obsahuje agenty a skilly pro tyto části zpravodajů:

Agent	Skill	Sekce
vault-structure	newsletter-vault-structure	kontrola a vytvoření struktury Obsidian vaultu
in-a-nutshell	newsletter-in-a-nutshell	RSoW/BBtn In a Nutshell
design-tip	newsletter-design-tip	RSoW Designérský tip, BBtn Designer’s Tip
opinion	newsletter-opinion	RSoW/BBtn Opinion
linkodrome	newsletter-linkodrome	RSoW Linkodrom, BBtn Linkodrome
articles	newsletter-articles	RSoW Vyšlo na ŘSoW, BBtn Published on BBtn
events	newsletter-events	RSoW/BBtn odstavec s akcemi
anniversary	newsletter-anniversary	RSoW/BBtn závěrečný odstavec s výročím
finalize-issue	newsletter-finalize-issue	sestavení výsledného vydání

Požadavky

• Nainstalovaný a přihlášený GitHub Copilot CLI, Claude Code, nebo obojí.
• Přístup ke Git repozitáři s tímto pluginem.
• Node.js a npx, protože plugin používá Playwright MCP.
• Obsidian vault se strukturou popsanou níže, případně prázdný vault, který může Copilot připravit.

Rychlá kontrola:

copilot version
copilot login
claude --version
node --version
npx --version

Instalace Do GitHub Copilot CLI

Plugin nainstalujte z GitHub repozitáře garcon/newsletter-composer:

copilot plugin install garcon/newsletter-composer

Stejný repozitář lze nainstalovat také přes Git URL:

copilot plugin install https://github.com/garcon/newsletter-composer.git

Pokud instalujete fork nebo kopii pluginu z podsložky jiného repozitáře, použijte odpovídající název repozitáře a cestu:

copilot plugin install OWNER/REPO:PATH/TO/newsletter-composer

Po instalaci spusťte Copilot CLI:

copilot

V interaktivním režimu ověřte, že se plugin načetl:

/plugin list
/agent
/skills list
/env

Měli byste vidět plugin newsletter-composer, newsletterové agenty a newsletterové skilly.

Po změnách plugin aktualizujete příkazem:

copilot plugin update newsletter-composer

Použití V Claude Code

Plugin obsahuje také kompatibilní vrstvu pro Claude Code:

.claude-plugin/plugin.json
commands/
hooks/hooks.json

Claude Code může plugin používat lokálně přímo z této složky. Při vývoji nebo testování spusťte Claude Code z kořene pluginu:

claude --plugin-dir .

Pokud chcete plugin používat z GitHub checkoutu, nejdřív si repozitář stáhněte a spusťte Claude Code ve stažené složce:

git clone https://github.com/garcon/newsletter-composer.git
cd newsletter-composer
claude --plugin-dir .

Po spuštění ověřte, že se plugin načetl:

/plugin list
/help
/agents

Claude Code používá namespacované příkazy podle názvu pluginu. Editor může použít například:

/newsletter-composer:prepare-in-a-nutshell
/newsletter-composer:check-vault-structure
/newsletter-composer:prepare-design-tip
/newsletter-composer:prepare-opinion
/newsletter-composer:prepare-linkodrome
/newsletter-composer:prepare-articles
/newsletter-composer:prepare-events
/newsletter-composer:prepare-anniversary
/newsletter-composer:finalize-issue

Za příkaz lze doplnit upřesnění:

/newsletter-composer:prepare-events RSoW issue 112, publication date 2026-04-27

Claude Code vrstva používá stejné skilly, agenty, .mcp.json a obsahové instrukce jako GitHub Copilot CLI plugin. GitHub Copilot CLI instalace tím není dotčená.

Pokud se příkazy nezobrazují, spusťte v Claude Code:

/reload-plugins
/help

Pokud se plugin stále nenačte, zkontrolujte, že Claude Code spouštíte ze složky, která obsahuje .claude-plugin/plugin.json.

Očekávaná Struktura Obsidian Vaultu

Copilot CLI spouštějte z kořene Obsidian vaultu, ne ze složky pluginu:

cd PATH/TO/OBSIDIAN/VAULT
copilot

Vault má mít tyto hlavní složky:

00 Inbox
01 BBtn
02 RSoW
03 Archives
04 Resources
99 Service

Servisní workflow, která neodpovídají konkrétní newsletterové sekci, používají také prefix 99-. Skill pro kontrolu struktury vaultu je proto uložený jako skills/99-vault-structure/.

Podklady patří do sekčních složek v 00 Inbox:

00 Inbox/
├── 01 In a Nutshell
├── 02 Designer’s Tip
├── 03 Opinion
├── 04 Linkodrome
├── 05 Articles
├── 06 Events
└── 07 Anniversary

Vydání jsou uložená ve složkách 01 BBtn a 02 RSoW: