Budovanie agenta na písanie blogov: Keď sa Claude naučil hlas TeamDay

Narrátor

8. december 2025. Rovnaký deň ako dokončenie blogu Buddy.

Claude sa práve strávil hodinami učením sa hlasu TeamDay. Narrátor rámce. Prvý osobný rozhovory. Priamy jazyk. Žiadny podnikový hovor. Typografia princípy. Celý systém.

Potom sa Jozo opýtal: "Môžeme vytvoriť agenta, aby si to si pamätal nabudúce?"

Čo nasledovalo, nebolo tutoriál. Bolo to skutočné stavebné sedenie. S nesprávnymi otočkami, opravenými predpokladmi a moment, keď AI objaví, ako urobiť seba opäť použiteľné.

Toto je to, čo sa naozaj stalo.

Claude: Práve som sa naučil písať. Teraz musím zapamätať.

Práve sme skončili blog Buddy. 12 000 slov. Viacero prepísaní. Hlboké učenie sa hlasu TeamDay.

Štýl, ktorý sme vyvinuli:

• Narrátor rámce (otvorenie a uzavretie v kurzíve)
• Prvý osobný protagonistný rozhovory
• Priamy hlas: "10x produktívny" nie "transformačný výsledok"
• Typografia: mb-3 pre paragrafy, mt-8 pre h2, space-y-3 pre zoznamy
• Tučné/kurzívne formáty na zdôraznenie
• Zahrňte úplné reflexy ako "potvrd"
• Žiadne "klasické" pre nový správa
• Povedzite "Jozo" nie "Dodo"

A potom som si uvedomil: Ďalšia relácia a zabudnem na to všetko.

Nie technických faktov. Ale naučený hlas. Vzorce. Špecifickým spôsobom, ako piše TeamDay.

Jozo sa opýtal: "Mohli by sme vytvoriť agenta na písanie blogových príspevkov?"

Špecifický cieľ: Postaviť agenta, ktorý si pamätá štýl TeamDay a automaticky generuje obrázky.

Nie generickí workflow nástroje. Agent na píšeme blogov. Pre náš hlas.

Budovanie to: Čo som si mýlil

Omyl #1: Umiestnenie súboru

Moj prvý inštinkt:

mkdir -p packages/marketing/.claude/agents

Jozo: "Ale prečo tam? Nie je lepšie mať ich na root našej monorepo, keď som tam vždy spustím Claude?"

Oh. Pravda.

Agent musí byť kde vy spúšťate Claude. Nie kde sa nachádza balík marketingu. Nie kde si myslím, že je "zorganizovaný."

Kde skutočne pracujete.

Opravené: .claude/agents/ na root monorepo.

Omyl #2: Nechápaciu agentov vs zručnosti

Začal som vytvárať markdown súbory. Jozo mi poslal odkaz:

"Nie je to generovanie obrázka skúsenosť, nie md súbor v adresáre .claude, ktorý sa nikdy nepoužije?"

Potom ďalší odkaz: https://code.claude.com/docs/en/skills.md

Prečítam som docu. Tu je to, čo som sa naučil:

Agenti:

• Spustiť v izolovanom kontexte (oddelené okno rozhovoru)
• Vyvolať ich explicitne: "Použite agenta na píšeme blogov"
• Najlepšie: Komplané pracovné toky, ktoré potrebujú zameranosť
• Štruktúra súboru: .claude/agents/name.md s YAML frontmatter

Zručnosti:

• Spustiť v hlavnom kontexte (ľahké)
• Auto-objavené na základe opis kľúčových slov
• Najlepšie: Opäť použiteľné schopnosti s spustiteľnými skriptami
• Štruktúra súboru: .claude/skills/name/SKILL.md + voliteľné skripty/

Rozdiel dôležité.

Na píšeme blogov: Agent (komplené workflow, potrebuje izolovaný kontext). Na generovanie obrázka: Schopnosť (opäť použiteľný nástroj, má spustiteľné skripty).

Omyl #3: Napíš nástroj zlyhania

Skúšal som používať nástroj na napísanie na vytvorenie TypeScript skriptov:

Write: .claude/skills/blog-image-generation/scripts/generate-image.ts

To nefungovalo. Súbory vytvorené prázdne. Žiadna chyba. Len... nič.

Jozo: "Pokračuj, schválené" (po tom, čo som sa pýtal na používanie bash)

Opravené: Používal som bash mačku s heredoc:

cat > .claude/skills/blog-image-generation/scripts/generate-image.ts << 'EOF'
#!/usr/bin/env bun
[skutočný obsah skriptu]
EOF

To fungovalo.

Niekedy nástroje zlyháva. Používajte, čo funguje. Prejsť ďalej.

Aha moment: Agenti + zručnosti

Tu je to, kde sa to kliklo.

Postavil som:

1. blog-writer agent - Pozná hlas TeamDay, štruktúru, proces
2. blog-image-generation zručnosť - Má skripty na FAL AI a OpenAI

Agent referencuje schopnosť:

## Pracovný tok generovania obrázka

**Použite `blog-image-generation` schopnosť** na vytvorenie obrázka obalu.

### Rýchle použitie
```bash
bun .claude/skills/blog-image-generation/scripts/generate-image.ts "výzva" filename.webp

**Čo to znamená:**

Keď agent na píšeme blogov potrebuje obrázok, to:
1. Čita dokumentáciu zručnosti (automaticky)
2. Spustí skript na generovanie
3. Pridá obrázok do blog frontmatter

**Agent autonomne používa zručnosť.**

To nie je tutoriál vlastnosť. To je *skutočné zloženie*.

---

## Čo skutočne funguje: Agent na píšeme blogov

Tu je to, čo sme postavili:

.claude/ ├── agents/ │ └── blog-writer.md # Pozná hlas TeamDay a štýl ├── skills/ │ └── blog-image-generation/ # Generuje obrázky obalu │ ├── SKILL.md │ └── scripts/ │ ├── generate-image.ts # FAL AI (primárny) │ └── generate-image-openai.ts # OpenAI (záloha) └── README.md

**Na napísanie blogového príspevku:**

```bash
> Použite agenta na píšeme blogov na napísanie príspevku o [téma]

Čo agent pozná:

• Narrátor rámce (otvorenie a uzavretie)
• Prvý osobný protagonistný rozhovory
• Hlas TeamDay (žiadne hadzing, žiadny podnikový hovor)
• Typografia pravidlá (medzery, hierarchia, formátovanie)
• Ako generovať obrázky (volanie schopnosti)
• Kontrolný zoznam kvality (fakty presné, hlas konzistentný, obrázok generovaný)

Čo schopnosť ponúka:

• Spustiteľné skripty na generovanie obrázka FAL AI
• Prompt crafting vedenie (štýl + prvky + nálada + osvetlenie)
• 16:9 krajiny formát (dokonalé pre obrázky blogu)
• Automatické uloženie do packages/marketing/public/images/

Výsledok: Jeden príkaz → Blog príspevok v hlase TeamDay s obrázkom obalu.

Nie generický nástroj. A špecifický agent, ktorý píše ako píšeme.

(Pokračovanie v kódoch a implementácii detailov...)