add-study

Registers topical, formal, or applied studies and updates catalogs, references, and PDF artifacts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adding a new study to the Analytic Madhyasth Darshan repository requires coordinated updates across metadata, catalog JSON, README tables, HTML indexes, reference manifests, and PDF generation. Doing this by hand is error-prone and easy to get out of sync. ## Core Features & Use Cases - Automated registration: Runs Scripts/_add_study.py (or the PowerShell wrapper) to set author, date, and status metadata, regenerate HTML/PDF artifacts, and upsert catalog entries. - Multiple registration modes: Supports draft, released, and ongoing placeholder studies, formal and applied catalog tables, and importing external PDFs as stubs or converted markdown. - Use Case: After writing Studies/My-New-Study/My-New-Study.md, run the add-study script with a category, description, and tags to register it in the topical catalog, generate a Draft-watermarked PDF, and update all index pages in one step. ## Quick Start Ask the assistant to register the new study at Studies/<Slug>/<Slug>.md as a draft with a category, one-line description, and tags using the add-study script.

Frequently Asked Questions about add-study

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

FAQPage Schema
How do I register a new study in the catalog?

Run python Scripts/_add_study.py with the path to your study markdown, plus --category, --description, --tags, and --status. The script sets metadata, regenerates HTML and PDF, and updates the catalog JSON and index pages.

How do I import an external PDF as a study?

Pass the PDF path to _add_study.py with --title for a stub import, or add --convert with --slug, --category, and --description to extract a real markdown draft. Converted imports require maintainer review before regenerating the PDF.

What is the difference between draft, released, and ongoing status?

Draft adds a Draft watermark to the generated PDF, released produces a clean PDF, and ongoing creates a markdown-only placeholder row with no PDF. Ongoing placeholders cannot be created from PDF input.

Can I register a study in the formal or applied catalog instead of topical?

Yes, use --formal for the Formal Studies table or --applied for applied studies under Applications/<Slug>/. The flags are mutually exclusive, and a slug already used by another collection is rejected.

What are the slug naming rules for a new study?

Slugs may contain only letters, digits, and hyphens, are limited to 60 characters, and must keep the full Studies/<Slug>/<Slug>.md path at or below 200 characters. The add, rename, and proposal-bootstrap scripts enforce the same contract.

Why does PDF conversion fail on some files?

Scanned PDFs fail with a clear error because they lack a text layer. Diagrams, KaTeX math, and glossary tooltips are also not recovered, so converted drafts need manual cleanup to house style before regeneration.