Agent skill

Series Planner

by notque in notque/vexjoy-agent

Plan multi-part content series: structure, cross-linking, cadence.

MITAuto-check: notes

Install Series Planner

skills CLI
$ npx skills add notque/vexjoy-agent --skill series-planner -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install notque/vexjoy-agent series-planner --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/notque/vexjoy-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/content/series-planner .claude/skills/series-planner && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
series-planner
GitHub stars
438
Token cost
~1k tokens
SKILL.md length
401 words
Files
5 (incl. references)
Skills in repo
61
Repo updated
First seen
Licence
MIT

At a glance

Plan multi-part content series: structure, cross-linking, cadence.

  • Works in 3 steps: ASSESS → DECIDE → GENERATE
  • SKILL.md covers Deep References, Usage, Phase 1: ASSESS and Phase 2: DECIDE, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Series Planner is an agent skill from notque/vexjoy-agent. Plan multi-part content series: structure, cross-linking, cadence.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/cadence-guidelines.md`, `references/cross-linking.md` and `references/output-format.md`).

The repository describes itself as: VexJoy AI Agent with Jev Intelligent Routing - /do routes plain-English requests to the right specialist agent and gates the work with reviews, tests, and a learning loop. The licence is MIT.

Example prompts

  • “/series-planner”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Bash, Grep, Glob, Edit, Task

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. ASSESS
  2. DECIDE
  3. GENERATE

What it can do on your machine

Read from SKILL.md and the folder at commit 5218674. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Bash
    • Grep
    • Glob
    • Edit
    • Task

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Series Planner loads about 1k tokens when it runs, and up to ~7.5k if it reads all its reference files. Until then it costs about 20 tokens; SKILL.md has 401 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~20
When it runs · the whole SKILL.md, loaded when a task matches
~1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Bash, Grep, Glob, Edit, Task

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from notque/vexjoy-agent at commit 5218674, republished under its MIT licence (© notque). 401 words, ~1,022 tokens.

Download SKILL.mdSave it as .claude/skills/series-planner/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
series-planner
description
Plan multi-part content series: structure, cross-linking, cadence.
allowed-tools
Read, Write, Bash, Grep, Glob, Edit, Task
promoted_to
content
user-invocable
false
command
/series
routing.triggers
plan series, multi-part content, content series, article series, content arc
routing.category
content-creation
routing.pairs_with
content

Series Planner Skill

Plan multi-part content series: assess viability, select structure, produce plan with cross-linking and cadence. Three phases with strict gates.

Deep References

SignalLoadWhy
Publishing frequency, delay handlingreferences/cadence-guidelines.mdSchedule selection criteria
Navigation links, Hugo implementationreferences/cross-linking.mdPrev/next nav, shortcodes, landing pages
Plan output formatreferences/output-format.mdComplete plan template
Series types, selection matrixreferences/series-types.mdThree type templates with examples

Usage

/series [topic]
/series --type=progressive [topic]     # Force type
/series --parts=5 [topic]              # Target count
/series --with-landing [topic]         # Include landing page
/series --minimal [topic]              # Titles and scope only

Phase 1: ASSESS

Determine viability and natural divisions.

  1. Analyze topic: scope (narrow/medium/broad), natural divisions, audience progression.
  2. Check viability: minimum 3 distinct subtopics, each stands alone, logical progression exists, no filler.
  3. Detect series type:
SignalType
learn, master, deep diveProgressive Depth
build, create, projectChronological Build
why we chose, migration, debuggingProblem Exploration

Gate: 3+ natural divisions identified. If fewer, recommend single post or scope adjustment.

Phase 2: DECIDE

Select type, part count (strict 3-7 bounds), and structure.

  1. Select type and justify. Define part count and word estimate.
  2. Draft breakdown per part: title, scope (1 sentence), standalone value, adjacent links.
  3. Validate standalone value for every part:
    • Reader learns something complete and actionable from this part alone
    • Working code/config/output possible without other parts
    • No critical info deferred to other parts
    • Search landing on this part alone yields value

Red flags (reject): "read Part 1 first" dependency, mid-implementation endings, concepts only in earlier parts.

  1. Select cadence (see references/cadence-guidelines.md). Default: weekly.

Gate: All parts pass standalone test. Part count 3-7. Type justified.

Show full SKILL.md (162 more words)Show less

Phase 3: GENERATE

Produce the complete plan.

  1. Build plan: series header, per-part breakdown, cross-linking (see references/cross-linking.md), publication dates, Hugo frontmatter.
  2. Final validation checklist:
    • Every part has standalone value
    • Word counts 800-1500/part, within 20% variance
    • Cross-linking complete (prev/next for all)
    • No cliff-hangers, no filler
    • Part count within bounds
  3. Output using references/output-format.md format.

Gate: All checks pass. Plan complete.

Series Types

TypeStructureReader flexibility
Progressive DepthShallow to deep masteryBeginners stop at Part 1; advanced skip ahead
Chronological BuildStep-by-step creationEach part produces working output
Problem ExplorationProblem to solution journeyEven failed approaches are instructive

Error Handling

ErrorCauseSolution
Topic too narrowFewer than 3 natural divisionsRecommend single post or scope expansion
Topic too broadWould need 8+ partsSplit into multiple series; narrow scope
No logical progressionParts are loosely related, not buildingConsider standalone posts instead of series
Standalone value missingParts depend on each otherMerge dependent parts or add context inline

© notque, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in skills/content/series-planner of notque/vexjoy-agent.

  • SKILL.md
  • references/cadence-guidelines.md
  • references/cross-linking.md
  • references/output-format.md
  • references/series-types.md

Open the folder on GitHubat commit 5218674

Compare with similar skills

Series Planner next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Series Planner compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Series Planner this skillnotque/vexjoy-agent438—~1kAutomated safety check: NotesMIT
Plannerpenpot/penpot61k—~2.7kAutomated safety check: PassMPL-2.0
Internal Linksthedaviddias/Front-End-Checklist74k—~770Automated safety check: PassMIT
Agent Plannerruvnet/ruflo74k2 repos~1.2kAutomated safety check: PassMIT
External Linksthedaviddias/Front-End-Checklist74k—~773Automated safety check: PassMIT
Invalid Linksthedaviddias/Front-End-Checklist74k—~806Automated safety check: PassMIT

Similar skills

  • Planner

    penpot/penpot

    Read-only planning and architecture analysis — produce a structured implementation plan with task breakdown, acceptance criteria, sizing, and checkpoints.

    61k GitHub stars~2.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Internal Links

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a site's internal link structure, identifying pages that need more incoming links, generating contextual linking opportunities between related content, or…

    74k GitHub stars~770 tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Agent Planner

    ruvnet/ruflo

    Agent skill for planner - invoke with $agent-planner. An agent skill from ruvnet/ruflo.

    74k GitHub starsUsed in 2 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • External Links

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing content pages for citation quality, suggesting authoritative sources to link for factual claims, or reviewing whether a page's external link attributes…

    74k GitHub stars~773 tokensUpdated 2 days ago
    Research & ScienceAuto-check passed
  • Invalid Links

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a page's link elements for crawlability, reviewing JavaScript-heavy SPAs where navigation may not use <a href tags, or checking that dynamically generated links…

    74k GitHub stars~806 tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Agent Goal Planner

    ruvnet/ruflo

    Agent skill for goal-planner - invoke with $agent-goal-planner

    74k GitHub starsUsed in 3 repos~842 tokens
    Auto-check passed

More from notque/vexjoy-agent

All 61 skills in this repo
  • Game Asset Generator

    notque/vexjoy-agent

    Deterministic palette/matrix pixel art (not AI). An agent skill from notque/vexjoy-agent.

    438 GitHub stars~2.3k tokensUpdated 5 days ago
    Auto-check: notes
  • PR Workflow

    notque/vexjoy-agent

    Pull request lifecycle: commit, codex review, sync, review, fix, status, cleanup, and PR mining.

    438 GitHub stars~2.8k tokensUpdated 5 days ago
    Auto-check: notes
  • Architecture Deepening

    notque/vexjoy-agent

    Improve architecture across modules by deepening interfaces.

    438 GitHub stars~3.3k tokensUpdated 5 days ago
    Auto-check: notes
  • Code Quality

    notque/vexjoy-agent

    Code quality: cleanup, linting, formatting, quality gates. An agent skill from notque/vexjoy-agent.

    438 GitHub stars~1.5k tokensUpdated 5 days ago
    Auto-check: notes
  • Codebase Analyzer

    notque/vexjoy-agent

    Statistical rule discovery from Go codebase patterns. An agent skill from notque/vexjoy-agent.

    438 GitHub stars~2k tokensUpdated 5 days ago
    Auto-check: notes
  • Comment Quality

    notque/vexjoy-agent

    Review and fix temporal references in code comments. An agent skill from notque/vexjoy-agent.

    438 GitHub stars~2k tokensUpdated 5 days ago
    Auto-check: notes

Questions about Series Planner

What does Series Planner do?

Plan multi-part content series: structure, cross-linking, cadence. Series Planner is an agent skill from notque/vexjoy-agent. Plan multi-part content series: structure, cross-linking, cadence.

How do I install Series Planner in Claude Code?

Run `npx skills add notque/vexjoy-agent --skill series-planner -a claude-code`. Or copy the skill folder (skills/content/series-planner in notque/vexjoy-agent) into .claude/skills/series-planner in your project. Claude Code loads it when a task matches its description.

How do I install Series Planner in Codex?

Run `npx skills add notque/vexjoy-agent --skill series-planner -a codex`. Or copy the skill folder (skills/content/series-planner in notque/vexjoy-agent) into .agents/skills/series-planner in your project. Codex loads it when a task matches its description.

Can I use Series Planner in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add notque/vexjoy-agent --skill series-planner -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/series-planner, .gemini/skills/series-planner, .github/skills/series-planner and .opencode/skills/series-planner in your project.

What does Series Planner need to run?

SKILL.md names no scripts, command-line tools or credentials: Series Planner is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Bash, Grep, Glob, Edit, Task.

Does Series Planner access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Series Planner safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Series Planner use?

Series Planner is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Series Planner use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 6.5k tokens, read only when the agent opens those files.

What are the alternatives to Series Planner?

Skills that share tags, products or a category with Series Planner: Planner (penpot/penpot, 61k stars), Internal Links (thedaviddias/Front-End-Checklist, 74k stars), Agent Planner (ruvnet/ruflo, 74k stars) and External Links (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Series Planner?

notque (a GitHub user) maintains it in notque/vexjoy-agent, which has 438 GitHub stars. The repository holds 61 skills in this directory. The repository was last updated on October 3, 2026.

Source: notque/vexjoy-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.