agentleFS
priyanshu-aryapriyanshu-arya/LinkedIn_Automation/.claude/skills/generate-week-substack/SKILL.md

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.

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
  1. Very specific:

    Never approves or schedules/publishes anything itself — only sequences the skills that do, ending at /publish-substack's manual handoff …

    line 11
  2. Very specific:

    If the Notes slots come up short, run one targeted /research-topic <pillar> 2 → /generate-ideas → /plan-week-substack-note retry, capped at …

    line 34
  3. Very specific:

    After both, update content-index.md's status for each Substack row.

    line 67
  4. Very specific:

    Never skip /review-drafts before /publish-substack.

    line 78
  5. Very specific:

    Never call any Substack API — /publish-substack is manual by design.

    line 79
  6. Very specific:

    Never mark anything published without the user's explicit confirmation during /publish-substack.

    line 80
  7. Distinctive:

    Never exceed 2 retries per slot.

    line 82

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

  1. /research-topic — reuse this week's existing research/idea pool if /generate-week or /generate-week-x already ran; otherwise run a scan sized for one deep article + a few lighter Notes (start at 6).
  2. /generate-ideas (default range).
  3. /plan-week-substack-article [week] — may honestly find no idea deep enough this week; that's a valid outcome, not a failure.
  4. /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

  1. /review-drafts with no draft-id — shared across whatever orchestrators ran this session, run once total.
  2. /publish-substack once, for whatever ended up status: approved with platform in {substack-article, substack-note}. This produces copy-ready Substack-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-drafts before /publish-substack.
  • Never call any Substack API — /publish-substack is 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.