syllabus

Generates a curated supplementary reading list from any course syllabus using Consensus academic search. Grill-me intake (syllabus input format + course audience + year range) plus a grouping forcing-options checkpoint before any search runs — so the reading list matches the course's level and recency need. Parses the syllabus to extract topics and learning outcomes, searches Consensus for recent peer-reviewed papers per topic, and produces a professionally formatted .docx with clickable Consensus links, plain-language summaries calibrated to audience level, and Bloom-higher-order discussion questions tied to course learning goals. Use when the user uploads a syllabus, course outline, or curriculum document and wants supplementary readings (e.g., 'create a reading list from this syllabus', 'find recent papers for my course') — even casual mentions with a syllabus attached should trigger this skill.

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

—

The risk profile of this skill

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-sequenced, actionable pipeline that offloads mechanics to bundled scripts and canon to reference files, with validation and forcing checkpoints throughout. Its only weakness is mild verbosity in the architectural-rationale and intake 'why I'm asking' sections.

Suggestions

Tighten the 'Architectural Pattern: Bundled Script' section to a single line plus a pointer to references/bundled_script_pattern.md; the five rationale bullets re-explain a concept Claude already grasps.

Trim or collapse the repeated '*Why I'm asking*' blocks in Phase 0 — one short shared rationale would reduce token cost without losing the forcing-question design.

Consider moving the full auditLog JSON schema into the bundled-script reference or a short snippet, keeping only the essential fields inline in SKILL.md.

Dimension	Reasoning	Score
Conciseness	Mostly lean with tight phases and compact good/bad tables, but the 'Architectural Pattern: Bundled Script' rationale bullets and the Q1–Q3 'Why I'm asking' blocks are mild over-explanation of points Claude could grasp; minor trimming possible. Not a 5 because a few sections pad slightly; not a 3 because the bulk is efficient and assumes Claude's competence.	4 / 5
Actionability	Provides a copy-paste ready bash invocation ('node scripts/generate_reading_list.js --input ... --output ...'), a complete JSON input schema, and concrete per-script roles — specific examples cover the common cases and are directly executable.	5 / 5
Workflow Clarity	Clear six-phase (Phase 0–6) sequence with explicit forcing checkpoints ('Refuse to start without a syllabus', 'Refuse to start Phase 3 without explicit user choice'), validation in Phase 6 (zip integrity test + section presence), and an error-handling table with stop conditions and recovery loops for this batch operation.	5 / 5
Progressive Disclosure	SKILL.md is an overview with mechanical logic in scripts/ and canon material in references/, each one level deep and clearly signaled via markdown links ('See [`references/audience_calibration.md`](...) for the canon'); the referenced bundle files all exist and match the body's paths.	5 / 5
	Total	19 / 20 Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is third-person, comprehensive, and explicitly covers both capabilities and trigger conditions with natural user phrasing. It is on the longer side but every clause carries concrete content rather than fluff.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Parses the syllabus to extract topics and learning outcomes', 'searches Consensus for recent peer-reviewed papers per topic', and produces a .docx with 'clickable Consensus links, plain-language summaries calibrated to audience level, and Bloom-higher-order discussion questions' — comprehensive coverage with no major gaps.	5 / 5
Completeness	Explicitly answers both what (generates a curated reading list, parses, searches, produces formatted .docx with summaries and discussion questions) and when ('Use when the user uploads a syllabus, course outline, or curriculum document and wants supplementary readings') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Includes natural phrases users say — 'create a reading list from this syllabus', 'find recent papers for my course', 'uploads a syllabus, course outline, or curriculum document' — with example trigger quotes and a 'casual mentions with a syllabus attached' extension.	5 / 5
Distinctiveness Conflict Risk	Clear niche of syllabus → Consensus academic search → .docx supplementary reading list with distinct, specific triggers unlikely to fire for other skills.	5 / 5
	Total	20 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: alirezarezvani/claude-skills
Path: research/syllabus/skills/syllabus/SKILL.md
Commit: 19392f7

Reviewed: ~1 hour ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.