Agent skill · writing content · alirezarezvani
syllabus
Use when the user shares a course syllabus or outline and wants supplementary readings. Groups topics with topic_grouper.py, finds recent peer-reviewed papers and writes a .docx with summaries and discussion questions.
Why this skill is useful
Adds a bundled JavaScript script for generating professional .docx reading lists with peer-reviewed papers tailored to course specifics.
What it needs
Requires node installed locally. Requires consensus account access. About 6k tokens when loaded. Last updated 2026-08-05. 23,939 stars on the source repository.
What this skill does
Syllabus — Course Supplementary Reading List Portability: Requires a Consensus MCP connection, Node.js with docx package, and file reading capability for the syllabus. Works in Claude Code CLI natively. In Claude.ai with Consensus MCP + Code Execution + file upload, the workflow is supported. For an instructor or student with a course syllabus, produce a professional supplementary reading list as .docx containing recent peer-reviewed papers per course section. Architectural Pattern: Bundled Script This skill uses a bundled JavaScript helper script for DOCX generation rather than inlining the 300+ lines of layout code: DOCX generation logic is reusable + complex Better separation of concerns: skill = orchestration + intelligence; script = mechanical document assembly Token-efficient: skill doesn't re-derive layout each run Easier to maintain and version The bundled script is at scripts/generatereadinglist.js. The skill orchestrates the pipeline + invokes the script with JSON input. Agent Integrity Rules (Research-Pack Convention) Locked verbatim per PR #657 audit. Only use what Consensus returns. Every paper title, author, journal, year, URL must come from this session's tool calls. Training-knowledge papers labeled [Not from Consensus — model knowledge] and excluded. Confirm before moving on. A search isn't complete until response received and inspected. Track three counts. Queries sent / papers received / papers cited. Surface in audit summary. Surface gaps, don't fill them. Section with one paper + note about limited results > section padded with fabrications. Phase 0: Grill-Me Intake (3 forcing questions) Q1 (root) — Syllabus input Provide the syllabus — pick one: 1. File path (PDF, DOCX, text) — I'll read it 2. Pasted content — paste below 3. Image of a printed syllabus — attach the image Why I'm asking: Each format needs a different reader (PDF / DOCX parser / vision). Picking upfront prevents wasted attempts. Forcing choice. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills alirezarezvani/syllabus--9b2e87