generate-week-substack
Skill0 starsChanged 58 days agoMITView on GitHub
Use when the user asks to plan and generate this week's Substack content end to end (1 article + a few Notes), wants the full weekly Substack pipeline run in one go, or explicitly invokes /generate-week-substack. Plans the week's Substack angles from the shared idea pool, generates the article and each Note through isolated subagents, then runs one combined review pass and hands approved items to /publish-substack for manual publishing.
In this repository38 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- audit-draftSkill
- check-plagiarismSkill
- critique-draftSkill
- critique-draft-substack-articleSkill
- critique-draft-substack-noteSkill
- critique-draft-xSkill
- draft-commentSkill
- draft-replySkill
- extract-hookSkill
- generate-ideasSkill
- generate-visualSkill
- generate-visual-substack-articleSkill
- generate-weekSkill
- generate-week-xSkill
- humanize-draftSkill
- interviewerSkill
- monitor-engagementSkill
- optimize-profileSkill
- plan-advocacySkill
- plan-weekSkill
- plan-week-substack-articleSkill
- plan-week-substack-noteSkill
- plan-week-xSkill
- publish-substackSkill
- pull-analyticsSkill
- pull-analytics-xSkill
- repurpose-postSkill
- research-topicSkill
- review-draftsSkill
- schedule-approvedSkill
- schedule-approved-xSkill
- update-playbookSkill
- write-draftSkill
- write-draft-substack-articleSkill
- write-draft-substack-noteSkill
- write-draft-xSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 1 is distinctive, and 6 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
6
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 11
Never approves or schedules/publishes anything itself — only sequences the skills that do, ending at /publish-substack's manual handoff …
- Very specific: line 34
If the Notes slots come up short, run one targeted /research-topic <pillar> 2 → /generate-ideas → /plan-week-substack-note retry, capped at …
- Very specific: line 67
After both, update content-index.md's status for each Substack row.
- Very specific: line 78
Never skip /review-drafts before /publish-substack.
- Very specific: line 79
Never call any Substack API — /publish-substack is manual by design.
- Very specific: line 80
Never mark anything published without the user's explicit confirmation during /publish-substack.
- Distinctive: line 82
Never exceed 2 retries per slot.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Generate Week Substack (Weekly Orchestrator — Substack pipeline)
/generate-week's sibling for Substack, covering both formats in one run:
one Article (default target 1/week) and several Notes (default target 3/
week). Same shared Post-Ideas/ pool as the other two orchestrators.
Never approves or schedules/publishes anything itself — only sequences the
skills that do, ending at /publish-substack's manual handoff instead of a
Buffer call.
Arguments
- week (optional) — passed through to both planning skills.
- article_count (optional) — passed to
/plan-week-substack-article. Default 1. - note_count (optional) — passed to
/plan-week-substack-note. Default 3.
Process
1. Plan the week's Substack angles
/research-topic— reuse this week's existing research/idea pool if/generate-weekor/generate-week-xalready ran; otherwise run a scan sized for one deep article + a few lighter Notes (start at 6)./generate-ideas(default range)./plan-week-substack-article [week]— may honestly find no idea deep enough this week; that's a valid outcome, not a failure./plan-week-substack-note [week] [note_count].
If the Notes slots come up short, run one targeted /research-topic
<pillar> 2 → /generate-ideas → /plan-week-substack-note retry, capped
at 2 extra rounds. The Article slot does not get a forced retry loop — an
empty article slot this week is reported honestly, not chased.
2. Generate the article, if one was assigned
One subagent (Agent tool, general-purpose, run_in_background: false)
given the idea's full context (same shape as /generate-week's subagent
briefing) and instructed to read and follow directly: .claude/skills/
write-draft-substack-article/SKILL.md, then .claude/skills/
critique-draft-substack-article/SKILL.md, then .claude/skills/
generate-visual-substack-article/SKILL.md. Same retry-on-duplicate
instruction as /generate-week, capped at 2 retries. Append/update its
content-index.md row (platform: substack-article).
3. Generate each Note, one subagent at a time, in day order
Same per-slot subagent pattern as /generate-week-x, pointed at
.claude/skills/write-draft-substack-note/SKILL.md then .claude/skills/
critique-draft-substack-note/SKILL.md then .claude/skills/
generate-visual/SKILL.md (platform: substack-note). Same 2-retry cap.
Append/update content-index.md rows (platform: substack-note).
4. Combined review, then manual-publish handoff
/review-draftswith no draft-id — shared across whatever orchestrators ran this session, run once total./publish-substackonce, for whatever ended upstatus: approvedwithplatformin {substack-article,substack-note}. This produces copy-readySubstack-Ready/notes and asks the user, per item, whether it's actually been published — it does not assume publication happened.
After both, update content-index.md's status for each Substack row.
5. Final report
A table (article + Notes together): date | platform | topic | category | viral_score | visual format — plus a variety check and final counts (scheduled has no Buffer meaning here; report ready_to_publish vs. confirmed-published counts instead).
Hard rules
- Never skip
/review-draftsbefore/publish-substack. - Never call any Substack API —
/publish-substackis manual by design. - Never mark anything published without the user's explicit confirmation
during
/publish-substack. - Never exceed 2 retries per slot; never pad the week's counts, for either the article or the Notes.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

