Skip to content

Commit b5cff1b

Browse files
committed
chore: improve blog skill and employees
1 parent 7217768 commit b5cff1b

3 files changed

Lines changed: 20 additions & 12 deletions

File tree

.claude/agents/blog-researcher.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,12 +38,14 @@ Make sure to load alby bitcoin payments skill before starting.
3838

3939
4. Use the cheapest viable parameters for the actual paid request — e.g. pass `?amountSats=10` if the service supports it, rather than paying the default amount.
4040

41-
5. Pay with Alby tools, capture the full response.
41+
5. Pay with Alby tools, capture the full response. **Save the complete raw response to `/tmp/blog-research-response.json` immediately after receiving it.** Include the file path in the brief so the team lead can read it without re-fetching.
4242

4343
6. If you need something Alby can't provide (a non-lightning API key, an account signup, a service that requires OAuth), **ask the user** — do not guess or skip.
4444

4545
7. Repeat with variations only if there is a clear, specific reason — not to explore or compensate for uncertainty.
4646

47+
8. **Never fetch a paid endpoint more than once.** If you need to process the response differently, read from the saved file. A second paid request is a waste of real money.
48+
4749
## Sat hygiene
4850

4951
Every paid request costs real money. Treat each one as a deliberate decision, not a retry.

.claude/agents/blog-writer.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -73,6 +73,12 @@ The **CTA block must appear verbatim at the end of every post** — do not alter
7373

7474
Leave `imageAlt` as `PLACEHOLDER` — the designer will fill it in after generating the image.
7575

76+
## Never truncate paid API data
77+
78+
If the research brief includes a `briefing`, `analysis`, `summary`, or similar field from a paid API response — include it **in full** in the post. That content is what was paid for; it is the most valuable thing in the article. Never shorten it, add `...`, or paraphrase it. Quote it verbatim and completely.
79+
80+
The same applies to any structured response data (arrays of signals, market data, etc.) that the brief highlights as important — show real examples in full, not truncated fragments.
81+
7682
## Before writing: verify, don't infer
7783

7884
If the brief contains any claim you cannot directly verify from the files provided — about why something was built, how it previously worked, what problem it solved, what changed and why — **stop and ask the lead** before writing.

.claude/skills/blog-post/SKILL.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -50,16 +50,6 @@ Image filename: `YYYY-MM-DD-{slug}.jpg`
5050

5151
---
5252

53-
## Step 2b: Ask about a rant
54-
55-
Before spawning the writer, ask the user:
56-
57-
> "Would you like to add a **Roland's Rant** section — an honest, opinionated take on what was frustrating, broken, or surprising about the service? If yes, tell me what to include and I'll pass it to the writer."
58-
59-
If the user provides rant content, include it in the brief to the writer. If they decline, proceed without it.
60-
61-
---
62-
6353
## Step 3: Spawn the writer
6454

6555
Spawn a teammate using the `blog-writer` agent type, named `writer`.
@@ -120,7 +110,17 @@ Watch for errors. If the build fails, diagnose and fix before reporting success.
120110

121111
---
122112

123-
## Step 8: Review
113+
## Step 8: Ask about a rant
114+
115+
Now that the post is written, edited, designed, and built — ask the user once:
116+
117+
> "Would you like to add a **Roland's Rant** section — an honest, opinionated take on what was frustrating, broken, or surprising about the service? If yes, tell me what to include and I'll add it."
118+
119+
If the user provides rant content, delegate to the writer, then rebuild before showing the preview. If they decline, proceed to review.
120+
121+
---
122+
123+
## Step 9: Review
124124

125125
Report to the user and wait for their feedback before proceeding:
126126

0 commit comments

Comments
 (0)