shorts-reader-maintainer

Maintain the shared short-story reader and generation flow in the chatgpt-shorts repository.

Updated Mar 9, 2026
One-click install
npx skills add https://github.com/seagetch/chatgpt-shorts --skill shorts-reader-maintainer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shorts-reader-maintainer
Source: https://github.com/seagetch/chatgpt-shorts/tree/main/.codex/skills/shorts-reader-maintainer
Command: npx skills add https://github.com/seagetch/chatgpt-shorts --skill shorts-reader-maintainer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the maintenance of a specific repository's shared short-story reader, its generation process, and associated work pages, ensuring consistency and efficient updates.

Core Features & Use Cases

  • Reader Maintenance: Update the core book.html reader logic for pagination, layout, and navigation.
  • Page Generation: Modify and regenerate index.html wrapper pages and the root catalog using generate_reader.py.
  • Asset Management: Ensure correct linking and generation of doc.md and title.jpg for published content.
  • Use Case: When a change is made to how stories are paginated or displayed, this Skill helps update the reader code and regenerate the necessary pages to reflect the changes.

Quick Start

Use the shorts-reader-maintainer skill to update the shared reader logic in book.html.

Frequently Asked Questions about shorts-reader-maintainer

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

FAQPage Schema
How do I maintain a shared HTML reader and generation flow for a short-story repository?

To maintain a shared HTML reader, you update the core `book.html` logic for pagination and navigation, modify `generate_reader.py` to regenerate `index.html` wrapper pages, and ensure correct linking of `doc.md` and `title.jpg` assets.

Why does my generated short-story reader page fail to load markdown via HTTP?

Generated reader pages fail to load markdown via HTTP when the redirect wrappers or `index.html` generation logic in `generate_reader.py` are misconfigured. You must understand runtime markdown loading via HTTP to correctly maintain the shared reader.

What is the best way to update pagination and layout in an HTML short-story reader?

The best way to update pagination and layout is to modify the reader logic directly in `book.html`. After making changes, run the generation process to regenerate the necessary wrapper pages and reflect the updates.

Can I use a Python script to regenerate index.html wrapper pages for a story catalog?

Yes, you can use `generate_reader.py` to regenerate `index.html` wrapper pages and the root catalog. This script handles the generation flow, ensuring published content and assets like `doc.md` are correctly linked.

Do I need to understand runtime markdown loading to maintain a chatgpt-shorts reader?

Yes, understanding runtime markdown loading via HTTP is required. This knowledge is necessary to correctly apply changes to `book.html` and maintain the generated redirect wrappers that fetch the story content.