# napterr/estudio-skill architecture

> Architecture diagram of the GitHub repository napterr/estudio-skill, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/napterr/estudio-skill
- Repository: https://github.com/napterr/estudio-skill

## Overview

Estudio Skill is a study-material workflow for AI agents: a student supplies class notes or readings, selects one or more learning formats, and receives tailored study materials, optionally exported as separate styled PDFs. The skill specification and methodology references define the pedagogical behavior; a separate Python script converts Markdown documents into PDFs. The README documents the capabilities and workflow, while the sampled script confirms the Markdown-to-PDF implementation. The AI-side orchestration is not shown in the sampled source.

Main entry points: [`references/metodologias.md`](https://github.com/napterr/estudio-skill/blob/main/references/metodologias.md) (Format Methodologies), [`SKILL.md`](https://github.com/napterr/estudio-skill/blob/main/SKILL.md) (Study Skill), [`scripts/generar_pdf.py`](https://github.com/napterr/estudio-skill/blob/main/scripts/generar_pdf.py) (PDF Renderer), [`references/apuntes-manuscritos.md`](https://github.com/napterr/estudio-skill/blob/main/references/apuntes-manuscritos.md) (Handwriting Guidance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_study_workflow["Study Workflow"]
  node_study_skill["Study Skill<br/>[SKILL.md]"]
  node_study_inputs["Notes and Readings"]
  node_handwriting_guidance["Handwriting Guidance"]
end

subgraph group_pedagogy["Pedagogical Formats"]
  node_format_specs["Format Methodologies<br/>[metodologias.md]"]
  node_multilevel_summary["Multilevel Summary<br/>[metodologias.md]"]
  node_feynman_explainer["Feynman Explanation<br/>[metodologias.md]"]
  node_practice_exam["Practice Exam<br/>[metodologias.md]"]
  node_study_materials["Study Materials"]
end

subgraph group_export["Document Export"]
  node_pdf_renderer["PDF Renderer<br/>[generar_pdf.py]"]
  node_markdown_input["Markdown Document"]
  node_pdf_output["Styled PDF"]
end

node_student(("Student"))
node_ai_agent(("AI Agent"))
node_libreoffice["LibreOffice"]

node_student -->|"requests study aid"| node_ai_agent
node_student -->|"provides notes"| node_ai_agent
node_ai_agent -->|"uses skill"| node_study_skill
node_study_skill -->|"asks format choice"| node_ai_agent
node_study_inputs -->|"informs reading"| node_handwriting_guidance
node_study_skill -->|"follows methodologies"| node_format_specs
node_format_specs -->|"defines"| node_multilevel_summary
node_format_specs -->|"defines"| node_feynman_explainer
node_format_specs -->|"defines"| node_practice_exam
node_ai_agent -->|"generates selected formats"| node_study_materials
node_study_materials -->|"can be saved as"| node_markdown_input
node_markdown_input -->|"converts Markdown"| node_pdf_renderer
node_pdf_renderer -->|"invokes conversion"| node_libreoffice
node_pdf_renderer -->|"produces PDF"| node_pdf_output

click node_study_skill "https://github.com/napterr/estudio-skill/blob/main/SKILL.md"
click node_handwriting_guidance "https://github.com/napterr/estudio-skill/blob/main/references/apuntes-manuscritos.md"
click node_format_specs "https://github.com/napterr/estudio-skill/blob/main/references/metodologias.md"
click node_multilevel_summary "https://github.com/napterr/estudio-skill/blob/main/references/metodologias.md"
click node_feynman_explainer "https://github.com/napterr/estudio-skill/blob/main/references/metodologias.md"
click node_practice_exam "https://github.com/napterr/estudio-skill/blob/main/references/metodologias.md"
click node_pdf_renderer "https://github.com/napterr/estudio-skill/blob/main/scripts/generar_pdf.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_study_skill,node_study_inputs,node_handwriting_guidance toneBlue
class node_format_specs,node_multilevel_summary,node_feynman_explainer,node_practice_exam,node_study_materials toneAmber
class node_pdf_renderer,node_markdown_input,node_pdf_output toneMint
class node_student,node_ai_agent,node_libreoffice toneIndigo
```

## Components

### Study Workflow

- [Study Skill](https://github.com/napterr/estudio-skill/blob/main/SKILL.md): `SKILL.md`
- **Notes and Readings**
- [Handwriting Guidance](https://github.com/napterr/estudio-skill/blob/main/references/apuntes-manuscritos.md): `references/apuntes-manuscritos.md`

### Pedagogical Formats

- [Format Methodologies](https://github.com/napterr/estudio-skill/blob/main/references/metodologias.md): `references/metodologias.md`
- [Multilevel Summary](https://github.com/napterr/estudio-skill/blob/main/references/metodologias.md): `references/metodologias.md`
- [Feynman Explanation](https://github.com/napterr/estudio-skill/blob/main/references/metodologias.md): `references/metodologias.md`
- [Practice Exam](https://github.com/napterr/estudio-skill/blob/main/references/metodologias.md): `references/metodologias.md`
- **Study Materials**

### Document Export

- [PDF Renderer](https://github.com/napterr/estudio-skill/blob/main/scripts/generar_pdf.py): `scripts/generar_pdf.py`
- **Markdown Document**
- **Styled PDF**

### Other components

- **Student**
- **AI Agent**
- **LibreOffice**

## Connections

- Student → AI Agent: requests study aid (evidence: `README.md`)
- Student → AI Agent: provides notes (evidence: `README.md`)
- AI Agent → Study Skill: uses skill (evidence: `README.md`)
- Study Skill → AI Agent: asks format choice (evidence: `README.md`)
- Notes and Readings → Handwriting Guidance: informs reading (evidence: `README.md`)
- Study Skill → Format Methodologies: follows methodologies (evidence: `README.md`)
- Format Methodologies → Multilevel Summary: defines (evidence: `README.md`)
- Format Methodologies → Feynman Explanation: defines (evidence: `README.md`)
- Format Methodologies → Practice Exam: defines (evidence: `README.md`)
- AI Agent → Study Materials: generates selected formats (evidence: `README.md`)
- Study Materials → Markdown Document: can be saved as (evidence: `README.md`)
- Markdown Document → PDF Renderer: converts Markdown (evidence: `scripts/generar_pdf.py`)
- PDF Renderer → LibreOffice: invokes conversion (evidence: `scripts/generar_pdf.py`)
- PDF Renderer → Styled PDF: produces PDF (evidence: `scripts/generar_pdf.py`)
