add-technical-note

Creates technical or research companion notes for studies and generates their HTML and PDF outputs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adding a technical or research note beside an existing study requires following strict repository conventions: correct file placement, naming prefixes, author/date metadata, SVG and Mermaid validation, and regenerating the companion inventory. This Skill walks through that entire workflow so the note is discoverable and its HTML/PDF outputs match what CI produces. ## Core Features & Use Cases - Companion note authoring: Places Technical-Note-* or Research-Note-* Markdown files as direct children of an existing study directory with correct author and IST date metadata. - Build and verification: Runs the same _regenerate_pdf.py pipeline as CI, checking SVG validity, Mermaid rendering, fenced-code completeness, KaTeX fonts, and PDF outline. - Inventory refresh: Updates the My Submissions registry, generated-PDF keys, and search/offline data so the new note is discoverable. - Use Case: A contributor wants to publish a technical note extending a Draft study. The Skill guides them to author the note, stage it in Git, regenerate its HTML/PDF, and open a study-update PR. ## Quick Start Add a technical note named Technical-Note-Formalization under the Studies/MyStudy directory and generate its HTML and PDF outputs.

Frequently Asked Questions about add-technical-note

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

FAQPage Schema
How do I add a technical note to an existing study?

Create a Markdown file named Technical-Note-<Name>.md or Research-Note-<Name>.md as a direct child of the study directory, include Author and Edited on metadata, stage it in Git, then run _regenerate_pdf.py with the note's path to produce its HTML and PDF.

How do I generate a PDF for a companion research note?

Run python Scripts/_regenerate_pdf.py with the note's full path, not the parent study slug. This uses the same pipeline as CI, producing tracked sibling HTML and an ignored PDF while validating SVGs, Mermaid diagrams, and KaTeX fonts.

Does a technical note need its own catalog entry or status line?

No. Companion notes have no independent catalog row and no Status line, so their PDFs are unwatermarked. They carry their own Author and Edited on fields, and the PDF metadata reads the note's date rather than inheriting the parent's.

Why is my new note not appearing in the submission registry?

Discovery builders omit untracked Markdown files. Add the note and its resources to the Git index before running the generation scripts, then complete the shared finish steps so the note appears in the registry, generated-PDF keys, and search data.

When should I use a different skill instead of adding a technical note?

Use review-study for substantive syntheses or model extensions, update-presenters-companion for slide delivery scripts, remove-study-companions for deleting notes, and relocate-study-companion for renames or moves between studies.