scriptoriumadmin/claude-skills
1
0
Fork 0
mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-09-07 08:26:02 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
claude-skills/research/syllabus
History
Exact
Claude 7405298b4b
fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 
- #954: strip non-spec source/attribution keys from all 39 plugin.json
  manifests so Claude Code's validator accepts them; metadata preserved in
  new .claude-plugin/authoring-notes.json sidecars; check_plugin_json.py now
  hard-fails manifests carrying those keys and sanity-checks the sidecar;
  CLAUDE.md ClawHub schema section updated to the new rule.
- #949: move the c-level-agents plugin out of c-level-advisor/ to a
  top-level directory so the two marketplace sources no longer overlap;
  updated marketplace.json source, homepage, descriptions, all
  cross-references, docs, harness manifest, mirror-tree symlinks/indexes,
  and rebased the moved files' relative links; domain counters trued up
  (18 -> 19 domains).
- #933: replace dead links to the gitignored maintainer-local megaprompts/
  tree with annotated plain-text references (44 files: SKILL.md, READMEs,
  agents, commands).
- #931: DynamoDB on-demand pricing updated to post-Nov-2024 rates
  ($0.625/M writes, $0.125/M strongly consistent reads).
- #969: skill_security_auditor.py and the three dossier scripts reconfigure
  stdout/stderr to UTF-8 (errors=replace) so legacy Windows codepages no
  longer crash at print time; PYTHONUTF8=1 documented.
- #968: Windows Notes section in INSTALLATION.md + README pointer for the
  core.symlinks mirror-tree checkout caveat.
- #924/#885 residuals: hook commands quote "${CLAUDE_PLUGIN_ROOT}" paths in
  all plugin hooks.json/settings.json (space-safe roots); removed the stale
  pre-rename status/review mirror symlinks and index entries left over from
  the memory-status/memory-review rename.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Qgc6RYXWJPr5oW9DHU7zR4
2026-08-21 05:47:37 +00:00
..
.claude-plugin fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00
agents fix: phantom-path sweep — 888 unresolvable references to zero 2026-06-10 14:33:00 +00:00
commands fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00
skills/syllabus fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00
README.md fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00

README.md

syllabus

Course supplementary reading list generator. Takes any course syllabus (PDF / DOCX / text / image) and produces a curated .docx of recent peer-reviewed papers via Consensus search, with plain-language summaries calibrated to audience level + Bloom-higher-order discussion questions tied to learning outcomes.

What this skill does

  1. Phase 0 grill-me (3 forcing Qs): syllabus input format + course audience + year range
  2. Phase 1: parse syllabus (PDF/DOCX/text/image) → extract topics + learning outcomes
  3. Phase 2: group topics into 6-12 sections + grill-me forcing checkpoint (proceed/merge/split/add/remove)
  4. Phase 3: targeted Consensus searches per section (1-2 queries each, sequential at 1 q/sec, applied-domain weaving)
  5. Phase 4: write summaries (audience-calibrated jargon) + discussion questions (Bloom higher-order)
  6. Phase 5: generate .docx via bundled JS script (scripts/generate_reading_list.js)
  7. Phase 6: deliver file + audit summary

Architectural pattern: bundled JS

This skill uses a bundled JavaScript helper script (scripts/generate_reading_list.js) for DOCX generation rather than inlining the 300+ lines of layout code in SKILL.md. Rationale:

  • 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 skill orchestrates the pipeline and invokes the script with JSON input.

Sibling skill relationship

Part of the research pack (sibling of pulse, litreview, grants, patent, dossier). Shares Agent Integrity Rules. Adds:

  • Audience calibration — undergrad summaries define every term; grad summaries assume technical fluency
  • Applied-domain weaving — search "X applications" not just "X" (boosts relevance dramatically)
  • Bundled JS script pattern — first research-pack skill to use this layout

Source spec

megaprompts/10-syllabus-megaprompt.md (maintainer-local draft spec — gitignored, not in the public repo) (PR #657).

Plugin layout

research/syllabus/
├── .claude-plugin/plugin.json
├── README.md
├── agents/cs-syllabus.md
├── commands/cs-syllabus.md
└── skills/syllabus/
    ├── SKILL.md
    ├── references/
    │   ├── applied_domain_weaving.md       ← search-quality canon (7+ sources)
    │   ├── audience_calibration.md         ← undergrad vs grad summary jargon (7+ sources)
    │   └── bundled_script_pattern.md       ← why bundle vs inline (7+ sources)
    └── scripts/
        ├── citation_tracker.py             ← stdlib: Consensus three-count + 1s sequential
        ├── topic_grouper.py                ← stdlib: heuristic 6-12 section grouping
        ├── discussion_question_validator.py ← stdlib: Bloom higher-order quality check
        └── generate_reading_list.js        ← bundled Node.js: DOCX assembly (~300 lines)

Dependencies

  • Consensus MCP — Required for literature search
  • Node.js with docx package — Required (npm install docx)
  • Bundled script — scripts/generate_reading_list.js (shipped with skill, not external)
  • File reading — PDF reader / DOCX parser via pandoc / vision for images

License

MIT.