upload-reading

Parse translated Markdown readings into ReadingContent and update readings.ts and syllabus.ts.

282|23|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/team-attention/stanford-cs146s-kr --skill upload-reading
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upload-reading
Source: https://github.com/team-attention/stanford-cs146s-kr/tree/main/.claude/skills/upload-reading
Command: npx skills add https://github.com/team-attention/stanford-cs146s-kr --skill upload-reading

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Upload Reading Skill streamlines turning translated Korean Markdown readings into a live, queryable content set. It parses frontmatter metadata, converts the content into ReadingContent objects, and updates the central readings and syllabus data so learners can access translated materials online.

Core Features & Use Cases

  • Automated Markdown ingestion: Reads translated KR Markdown, parses sections, summaries, and YouTube-specific data into a consistent ReadingContent schema.
  • Bimodal content support: Handles both simple single-page readings and hierarchical child pages (week/slug and week/parent/child) as well as YouTube content with optional summaries.
  • Syllabus synchronization: Updates readings and translation status in syllabus.ts to reflect progress, enabling end-to-end content publishing.
  • Workflow automation: Optional flags enable immediate publishing, draft creation, and selective content inclusion (quick/full for YouTube).

Quick Start

Use the upload-reading skill to publish a translated reading. For a single page: /upload-reading week1/how-openai-uses-codex. For a hierarchical page: /upload-reading week1/prompt-engineering-guide/zeroshot. You can choose to publish immediately with --publish, or keep as draft with --draft. For YouTube content, you can request a quick summary with --quick or full content with --full.

Frequently Asked Questions about upload-reading

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish translated Markdown readings to a structured syllabus?

To publish translated Markdown readings, you ingest the files to parse frontmatter and content sections into a standardized ReadingContent schema, which automatically updates your central syllabus and readings data for web access.

Can I upload hierarchical Markdown pages using a week and slug structure?

Yes, you can upload hierarchical Markdown pages by specifying a week/parent/child path structure. The parser supports both single-page readings and nested child pages to build a hierarchical content set.

Does this Markdown ingestion process support YouTube content with summaries?

Yes, the Markdown ingestion process supports YouTube content by parsing video-specific data with optional summaries and translations, allowing you to include quick or full YouTube content in your readings.

What is the best way to synchronize translation status in a syllabus file?

The best way to synchronize translation status in a syllabus file is to automate the update during Markdown ingestion, which directly modifies syllabus.ts to reflect the current translation progress of your published readings.

How do I save uploaded Markdown readings as drafts instead of publishing immediately?

To save uploaded Markdown readings as drafts instead of publishing immediately, use the draft flag during the ingestion process to stage the parsed ReadingContent without updating the live syllabus status.