remove-session

Archive or delete seminar sessions from MkDocs projects with dry-run support.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/shuheikomatsuki/lab-seminar-skills --skill remove-session
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: remove-session
Source: https://github.com/shuheikomatsuki/lab-seminar-skills/tree/main/remove-session
Command: npx skills add https://github.com/shuheikomatsuki/lab-seminar-skills --skill remove-session

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Removes a seminar session from a MkDocs-based lab-seminars project by archiving or deleting it, updating navigation and session listings accordingly while preserving associated materials.

Core Features & Use Cases

  • Archive a session to keep it out of public navigation and session lists without data loss.
  • Delete a session entirely when retention is unnecessary or for cleanup, with safe fallback via dry-run.
  • Automatically manage references to the session in mkdocs.yml and docs/index.md to maintain site integrity.

Quick Start

Archive or delete a specific session using the appropriate flags and provide the session identifier.

Frequently Asked Questions about remove-session

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

FAQPage Schema
How do I archive a seminar session from a MkDocs site without losing the files?

To archive a seminar session, the process hides it from the MkDocs site navigation and session lists while preserving all associated materials for historical reference. It automatically updates mkdocs.yml and docs/index.md to remove the session from public view without data loss.

What is the safest way to delete a session from mkdocs.yml and docs/index.md?

The safest way to delete a session is to use the dry-run flag for a safe preview before permanent deletion. This allows you to verify the cascading changes to mkdocs.yml and docs/index.md without actually removing the directory.

Can I remove a session from MkDocs navigation while keeping it on the server?

Yes, you can remove a session from MkDocs navigation while keeping it on the server by archiving it. Archiving updates the navigation and session listings in mkdocs.yml and docs/index.md to hide the session while retaining the files.

Does the session removal process verify directory existence before deleting?

Yes, the session removal process verifies directory existence before deleting or archiving. It enforces argument parsing with a required session ID and optional flags, ensuring the target session directory exists before applying any changes.

What happens to docs/index.md when I delete a seminar session?

When you delete a seminar session, docs/index.md is automatically updated to remove the corresponding session listing. This maintains site integrity by ensuring the index reflects the current active sessions after deletion.