site-pages-content-calendar

Build Site Pages Content Calendar

When to use

Use this skill when the user wants an interactive HTML calendar/dashboard for SharePoint Site Pages, especially with page names, published/draft/scheduled status, dates, and click-through detail views. The generated calendar should be full-size by default, using the available browser viewport and content area instead of a small embedded or fixed-height calendar.

Inputs

• Current SharePoint site URL.
• Site Pages library/list ID if available from context. If not available, discover or resolve it before querying.
• Optional user preferences for destination file name, folder, colors, or layout.

Steps

1. Inspect the Site Pages schema with get_list_schema.
   • Include hidden and read-only fields so status fields are visible.
   • Confirm internal names for: FileLeafRef, FileRef, Title, Created, Modified, FirstPublishedDate, _PublishStartDate, _ScheduledVersion, _ModerationStatus, _UIVersionString, _Level, Author, Editor, PageLayoutType, Description, and File_x0020_Type.
2. List the Site Pages items with list_items.
   • Use rowLimit large enough for the whole library.
   • Use viewFields with the verified internal names.
   • Filter to actual pages where possible: File_x0020_Type = aspx.
   • If hasMore is true, process the returned dataRef, not the inline preview.
3. Classify status without guessing.
   • Scheduled: only when _ScheduledVersion is non-empty or _ModerationStatus explicitly contains “Scheduled”.
   • Do not classify pages as scheduled just because _PublishStartDate exists; it can be defaulted/populated without a scheduled page.
   • Draft: _ModerationStatus contains “Draft” or item URL indicates draft.
   • Published: _ModerationStatus contains “Approved/Published” or item URL indicates published.
   • Unknown: no reliable status signal returned.
4. Choose calendar placement date.
   • Scheduled pages: _PublishStartDate if available; otherwise Created with a label saying scheduled date unavailable.
   • Published pages: FirstPublishedDate if available; otherwise Created with a label saying published date unavailable.
   • Draft pages: Created date, labeled as draft placement.
   • Never invent missing dates; display “Not available” where absent.
5. Render the calendar at full size.
   • Make the main calendar fill the available page width and height, using responsive layout such as min-height: 100vh, flexible columns/rows, and no narrow fixed-width wrapper around the calendar.
   • Use a full-width dashboard shell and let the calendar grid expand to the browser viewport.
   • Avoid small embedded previews, constrained cards, or fixed-height containers that make the calendar look miniaturized.
6. Show page titles directly in calendar cells.
   • Each date cell must make the page title visible for pages on that date, using Title when present and falling back to FileLeafRef/file name.
   • Keep titles compact with truncation, wrapping, or a visible “+N more” affordance if the cell has many pages.
   • Do not hide all titles behind counts only; counts may supplement titles but must not replace them.
7. Open a true right-side overlay drawer when a page title is clicked.
   • Clicking a visible page title in the calendar cell must open a fixed-position drawer that slides in from the right side of the browser viewport.
   • Implement the drawer with CSS such as position: fixed; top: 0; right: 0; height: 100vh; z-index: ...; transform: translateX(...), plus an overlay/backdrop and close button.
   • Do not render details below the calendar, below the selected date, or as an inline panel that appears after the calendar.
   • The drawer should overlay the page or sit above the calendar without causing the calendar to collapse into a compact widget.
   • The drawer should show all available metadata for the clicked page, including title, file name, source link, status, source status field, placement logic, created/modified dates, first published date, publish start date, scheduled version, moderation status, version, level, author, editor, page layout, and description.
   • Include a clear source page link that opens the page.
8. Avoid congested calendar cells.
   • Show visible titles while keeping cells readable.
   • Provide compact status counts and a “+N more” affordance when useful.
   • Include month previous/next buttons and status filters.
9. Generate the HTML using execute_code with outputDataRef: true.
   • Keep all CSS and JavaScript inline.
   • Do not reference external scripts, fonts, or images.
10. Save the dashboard with create_file as .html using contentDataRef; omit contentDataPath for raw HTML output from execute_code.