remove-study-companions

Removes study companion files while preserving parent study metadata and catalogs.

Updated Jun 12, 2026
One-click install
npx skills add https://github.com/raghavamohan/AnalyticMadhyasthDarshan --skill remove-study-companions-raghavamohan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: remove-study-companions
Source: https://github.com/raghavamohan/AnalyticMadhyasthDarshan/tree/main/.cursor/skills/remove-study-companions
Command: npx skills add https://github.com/raghavamohan/AnalyticMadhyasthDarshan --skill remove-study-companions-raghavamohan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Deleting a technical note, presentation deck, or presenter's companion from a study repository by hand risks breaking manifests, catalogs, and inbound links. This Skill performs scoped companion deletion that removes only the selected companion and its owned outputs while keeping the parent study intact. ## Core Features & Use Cases - Scoped companion deletion: Removes a technical/research note, deck, or presenter's companion together with its owned HTML, PDF, DOCX, and notes JSON outputs. - Manifest and metadata preservation: Updates deck/companion manifests by exact source identity while preserving the parent study's canonical files, Edited-on/Status fields, catalog, and proposal metadata. - Validated execution: Supports dry-run preview, rejects canonical study files and out-of-scope paths, validates the full plan before writing, and can recover manifest entries from a base ref. - Use Case: A study has an outdated deck and presenter companion. Run the removal script with both filenames in dry-run mode, review the owned-file list, then execute and finalize so the parent study and its catalog remain consistent. ## Quick Start Ask the assistant to remove the companion files Technical-Note-Example.md and Deck.pptx from the study with slug <Slug> using a dry run first, then confirm the deletion and run the shared finalizer.

Frequently Asked Questions about remove-study-companions

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

FAQPage Schema
How do I delete a companion file without deleting the whole study?

Run Scripts/_remove_study_companions.py with the study slug and the companion filenames, first with --dry-run to review owned outputs, then with --yes to execute. Finish with the shared finalizer script and commit everything in a study-update PR.

What files get removed when I delete a presentation deck?

Deleting a deck removes its two manifest-declared PDFs plus any linked presenter's companion MD, HTML, PDF, DOCX, notes JSON, and its ownership row. The parent study and other companions are preserved.

Can I remove multiple companions in one operation?

Yes, pass multiple bare companion filenames to the removal script in a single command. All selected sources are validated together before any writes occur, and they are committed in one study-update PR.

What happens if the manifest entry for a companion is already gone?

For a partial deletion whose manifest entry has already been removed, add --base-ref origin/master to recover that entry from the last known source commit so the deletion plan can be completed.

When should I not use companion removal?

Do not use it to retire an entire study; that requires the separate delete-study operation. Also avoid deleting loose figures unless separately requested and proven unused by all surviving documents and decks.