mira-references

Organizes per-theme reference folders containing PDFs, images, and notes for slide decks.

Updated Sep 2, 2026
One-click install
npx skills add https://github.com/mayconspirlandelli/slides-podcast-ia-home-office --skill mira-references-mayconspirlandelli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mira-references
Source: https://github.com/mayconspirlandelli/slides-podcast-ia-home-office/tree/main/.agents/skills/mira-references
Command: npx skills add https://github.com/mayconspirlandelli/slides-podcast-ia-home-office --skill mira-references-mayconspirlandelli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Slide creation workflows often lose track of source material because references are scattered across folders or never collected. This Skill creates and manages a dedicated references/ folder inside each slide theme directory, so every deck has its source material stored alongside it and automatically picked up by downstream slide-building skills. ## Core Features & Use Cases - Per-Theme Reference Folders: Creates decks/<theme>/references/ so each slide topic keeps its own source material isolated. - Automatic Inclusion of Existing Files: Any files already present in the references folder are treated as the theme's sources without asking again. - Multiple Input Types: Accepts copied files (PDF, PNG, JPG, SVG, MD, TXT, TEX), pasted text saved as Markdown, and links recorded in a fontes.md file. - Use Case: Before generating a deck on "Spec Driven Development", drop a book chapter PDF and an architecture diagram into the theme; the Skill copies them into decks/spec-driven/references/ so mira-extract, mira-builder, and mira-animator read them as the source of truth. ## Quick Start Ask the assistant to set up the references folder for your slide theme and add a PDF or image as source material.

Frequently Asked Questions about mira-references

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

FAQPage Schema
How do I add reference material to a slide theme?

Provide a file path, pasted text, or link and the Skill copies it into decks/<theme>/references/. Files are copied, never moved, so originals stay intact. Text is saved as Markdown and links are recorded in a fontes.md file.

What file types can be used as slide references?

Accepted reference types include PDFs such as books and articles, images and diagrams in PNG, JPG, or SVG, Markdown and plain text notes, LaTeX files, supporting code or data, and links saved in fontes.md.

Do existing files in the references folder get used automatically?

Yes. If decks/<theme>/references/ already contains files, they are automatically treated as the theme's sources without asking again. New material is only requested when the folder is empty or the user wants to add more.

Where should reference files for slides be stored?

Each theme keeps its references inside its own folder at decks/<theme>/references/, next to the deck's index.html. One folder per theme keeps sources isolated and lets the creation skills read everything from that single location.

Can the Skill modify or delete my original source files?

No. The Skill only copies files from external paths into the theme's references folder and never reads, edits, or deletes anything outside decks/<theme>/references/. Original files remain untouched.