Skip to content
SlashClone
DiscoverUse in ClaudeSubmit a link
Sign in
Made by@contentstudio

Content calendar

@contentstudio/content-calendar

Plan a few weeks of content across LinkedIn, a newsletter, a blog, and more. A script lays out dated slots per channel with your content pillars rotated evenly, then Claude fills in specific topics and hooks you can actually write. Exports a CSV for your sheet or planner.

SkillContentv1.0.0 (latest)Tested
Use in Claude Save Like Clone Comment
Activity
New: be the first to try it
  1. 1#!/usr/bin/env node
  2. 2// Lays out a content calendar: dated slots per channel, with content pillars rotated evenly.
  3. 3// Usage: node scripts/calendar.mjs [out-dir, default content/calendar]
  4. 4// --start YYYY-MM-DD [--weeks 4]
  5. 5// [--cadence "linkedin:mon,wed,fri newsletter:thu blog:tue"]
  6. 6// [--pillars "Product tips,Customer stories,Behind the scenes"]
  7. 7// [--skip 2026-11-26,2026-12-25] [--name content-calendar]
  8. 8// Writes: <out-dir>/<name>.csv, <out-dir>/<name>.md, <out-dir>/<name>.json
  9. 9// Topics are left blank for a person (or Claude) to fill in.
  10. 10import { existsSync, mkdirSync, writeFileSync } from "node:fs";
  11. 11import { join } from "node:path";
  12. 12
  13. 13const args = process.argv.slice(2);
  14. 14function flag(name, fallback) {
  15. 15 const i = args.indexOf(name);
  16. 16 if (i === -1) return fallback;
  17. 17 const value = args[i + 1] ?? "";
  18. 18 args.splice(i, 2);
  19. 19 return value;
  20. 20}
  21. 21function fail(msg) {
  22. 22 console.error(`calendar: ${msg}`);
  23. 23 process.exit(1);
  24. 24}
  25. 25const start = flag("--start", "");
  26. 26const weeks = Number(flag("--weeks", "4"));
  27. 27// Channels are separated by spaces or semicolons: "linkedin:mon,wed,fri newsletter:thu".
  28. 28const cadenceRaw = flag("--cadence", "linkedin:mon,wed,fri newsletter:thu blog:tue");
  29. 29const pillars = flag("--pillars", "Product tips,Customer stories,Behind the scenes")
  30. 30 .split(",")
  31. 31 .map((s) => s.trim())
  32. 32 .filter(Boolean);
  33. 33const skip = new Set(
  34. 34 flag("--skip", "")
  35. 35 .split(",")
  36. 36 .map((s) => s.trim())
  37. 37 .filter(Boolean),
  38. 38);
  39. 39const name = flag("--name", "content-calendar");
  40. 40const force = args.includes("--force");
  41. 41const [outDir = "content/calendar"] = args.filter((a) => a !== "--force");
  42. 42
  43. 43if (!/^\d{4}-\d{2}-\d{2}$/.test(start) || Number.isNaN(Date.parse(start))) {
  44. 44 fail('--start is required, as YYYY-MM-DD (for example --start 2026-11-09)');
  45. 45}
  46. 46if (!Number.isInteger(weeks) || weeks < 1 || weeks > 26) fail("--weeks must be a whole number from 1 to 26");
  47. 47if (pillars.length === 0) fail("--pillars needs at least one pillar");
  48. 48if (!/^[a-z0-9-]+$/.test(name)) fail("--name may use lowercase letters, digits, and hyphens");
  49. 49for (const d of skip) if (!/^\d{4}-\d{2}-\d{2}$/.test(d)) fail(`--skip dates must be YYYY-MM-DD (got "${d}")`);
  50. 50
  51. 51const DAYS = ["sun", "mon", "tue", "wed", "thu", "fri", "sat"];
  52. 52const DAY_NAMES = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
  53. 53const FORMATS = {
  54. 54 linkedin: "post",
  55. 55 x: "thread",
  56. 56 twitter: "thread",
  57. 57 threads: "post",
  58. 58 bluesky: "post",
  59. 59 instagram: "carousel",
  60. 60 tiktok: "short video",
  61. 61 youtube: "video",
  62. 62 shorts: "short video",
  63. 63 newsletter: "issue",
  64. 64 blog: "article",
  65. 65 podcast: "episode",
  66. 66 webinar: "session",
  67. 67};
  68. 68
  69. 69const cadence = cadenceRaw
  70. 70 .split(/[;\s]+/)
  71. 71 .map((s) => s.trim())
  72. 72 .filter(Boolean)
  73. 73 .map((part) => {
  74. 74 const [channelRaw, daysRaw = ""] = part.split(":");
  75. 75 const channel = channelRaw.trim().toLowerCase();
  76. 76 if (!channel) fail(`--cadence part "${part}" has no channel`);
  77. 77 const days = daysRaw
  78. 78 .split(",")
  79. 79 .map((d) => d.trim().toLowerCase().slice(0, 3))
  80. 80 .filter(Boolean);
  81. 81 if (days.length === 0) fail(`--cadence "${part}" needs days, like linkedin:mon,wed`);
  82. 82 for (const d of days) if (!DAYS.includes(d)) fail(`--cadence "${part}": "${d}" is not a day (use mon, tue, ...)`);
  83. 83 return { channel, days: new Set(days.map((d) => DAYS.indexOf(d))) };
  84. 84 });
  85. 85
  86. 86// ---- slots -----------------------------------------------------------------
  87. 87const slots = [];
  88. 88const skipped = [];
  89. 89const startMs = Date.parse(`${start}T00:00:00Z`);
  90. 90for (let i = 0; i < weeks * 7; i++) {
  91. 91 const date = new Date(startMs + i * 86400000);
  92. 92 const iso = date.toISOString().slice(0, 10);
  93. 93 const dow = date.getUTCDay();
  94. 94 for (const c of cadence) {
  95. 95 if (!c.days.has(dow)) continue;
  96. 96 if (skip.has(iso)) {
  97. 97 skipped.push(`${iso} ${c.channel}`);
  98. 98 continue;
  99. 99 }
  100. 100 slots.push({ date: iso, day: DAY_NAMES[dow], week: Math.floor(i / 7) + 1, channel: c.channel });
  101. 101 }
  102. 102}
  103. 103if (slots.length === 0) fail("no slots: check --start, --weeks, --cadence, and --skip");
  104. 104
  105. 105// Rotate pillars per channel so each channel gets an even mix, offset by channel so
  106. 106// the same day does not lead with the same pillar everywhere.
  107. 107const counters = {};
  108. 108cadence.forEach((c, i) => (counters[c.channel] = i % pillars.length));
  109. 109for (const s of slots) {
  110. 110 s.pillar = pillars[counters[s.channel] % pillars.length];
  111. 111 counters[s.channel]++;
  112. 112 s.format = FORMATS[s.channel] ?? "post";
  113. 113}
  114. 114
  115. 115// ---- write -----------------------------------------------------------------
  116. 116const csvPath = join(outDir, `${name}.csv`);
  117. 117if (existsSync(csvPath) && !force) {
  118. 118 fail(`${csvPath} already exists and may have topics filled in. Use --name for a new file, or --force to replace it.`);
  119. 119}
  120. 120mkdirSync(outDir, { recursive: true });
  121. 121const COLS = ["date", "day", "week", "channel", "format", "pillar", "topic", "hook", "status", "owner", "link"];
  122. 122const cell = (v) => {
  123. 123 const s = String(v ?? "");
  124. 124 return /[",\n]/.test(s) ? `"${s.replace(/"/g, '""')}"` : s;
  125. 125};
  126. 126const csv = [COLS.join(",")]
  127. 127 .concat(slots.map((s) => COLS.map((c) => cell(c === "status" ? "idea" : s[c] ?? "")).join(",")))
  128. 128 .join("\n");
  129. 129writeFileSync(csvPath, `${csv}\n`);
  130. 130
  131. 131const byChannel = {};
  132. 132const byPillar = {};
  133. 133for (const s of slots) {
  134. 134 byChannel[s.channel] = (byChannel[s.channel] ?? 0) + 1;
  135. 135 byPillar[s.pillar] = (byPillar[s.pillar] ?? 0) + 1;
  136. 136}
  137. 137const end = slots[slots.length - 1].date;
  138. 138const md = [`# Content calendar: ${start} to ${end}`, ""];
  139. 139md.push(
  140. 140 `${slots.length} pieces over ${weeks} week(s). ` +
  141. 141 Object.entries(byChannel)
  142. 142 .map(([k, v]) => `${k} ${v}`)
  143. 143 .join(", ") +
  144. 144 ".",
  145. 145);
  146. 146md.push(
  147. 147 `Pillars: ${Object.entries(byPillar)
  148. 148 .map(([k, v]) => `${k} ${v}`)
  149. 149 .join(", ")}.`,
  150. 150);
  151. 151if (skipped.length) md.push(`Skipped: ${skipped.join("; ")}.`);
  152. 152for (let w = 1; w <= weeks; w++) {
  153. 153 const rows = slots.filter((s) => s.week === w);
  154. 154 if (rows.length === 0) continue;
  155. 155 md.push("", `## Week ${w} (from ${rows[0].date})`, "", "| Date | Channel | Format | Pillar | Topic | Status |", "| --- | --- | --- | --- | --- | --- |");
  156. 156 for (const s of rows) md.push(`| ${s.day} ${s.date} | ${s.channel} | ${s.format} | ${s.pillar} | | idea |`);
  157. 157}
  158. 158md.push("");
  159. 159writeFileSync(join(outDir, `${name}.md`), md.join("\n"));
  160. 160writeFileSync(
  161. 161 join(outDir, `${name}.json`),
  162. 162 `${JSON.stringify({ start, end, weeks, slots: slots.length, by_channel: byChannel, by_pillar: byPillar, skipped }, null, 2)}\n`,
  163. 163);
  164. 164console.log(md.join("\n"));
  165. 165console.log(`Wrote ${csvPath}, ${join(outDir, `${name}.md`)}, ${join(outDir, `${name}.json`)}`);
Sign in to comment on a line