Claude Skills — Coleção de Skills Reutilizáveis
Emmerson-Miranda/claude-skills
Skills reutilizáveis para Claude Code — gerar quizzes, converter PDFs, automatizar workflows
Ver no GitHubRepositório com skills prontos para o Claude Code (agente CLI de codificação da Anthropic). Inclui gerador de quizzes a partir de Markdown, conversor PDF-para-Markdown e versionamento. Cada skill é uma pasta com instruções que Claude lê automaticamente quando relevante.
Instalação
npx convez-ai Emmerson-Miranda/claude-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerar quizzes de múltipla escolha a partir de documentos Markdown para estudos
- Converter PDFs em Markdown preservando estrutura, tabelas e scripts não-latinos
- Automatizar tarefas repetitivas e complexas via prompts com detecção automática de skills
Veredito

Projeto bem estruturado que reduz fricção ao reutilizar workflows no Claude Code. Três skills iniciais cobrem casos reais (estudos, conversão de documentos, versionamento). Abordagem modular incentiva expansão comunitária, mas atual collection é ainda pequena — depende de crescimento do ecossistema.
README
A tradução para o português deste README ainda está na fila.
claude-skills
A collection of reusable skills for Claude Code — Anthropic's CLI coding agent.
Each skill is a folder containing a SKILL.md instruction file that Claude reads automatically when relevant, making complex or repetitive workflows repeatable without re-explaining them every time.
Available Skills
| Skill | Description |
|---|---|
| quiz-generator | Generate multiple-choice study questions from any Markdown document, outputting a structured YAML quiz, a human-readable summary, and an interactive HTML test |
| pdf-to-markdown | Convert an attached PDF into a faithful, complete Markdown file — preserving all content, structure, tables (as lists), and non-Latin scripts |
| claude-skills-version | Reports the current version of this claude-skills collection |
Requirements
- Claude Code installed and authenticated
zipavailable on your system (pre-installed on macOS and most Linux distros)
Installation
Option A — Install script (recommended)
# Clone the repo
git clone https://github.com/Emmerson-Miranda/claude-skills.git
cd claude-skills
# List available skills
./install.sh
# Install a specific skill
./install.sh quiz-generator
Option B — Manual install
git clone https://github.com/Emmerson-Miranda/claude-skills.git
cd claude-skills/skills
# Package the skill as a zip
zip -r quiz-generator.skill quiz-generator/
# Install via Claude Code
claude skill install quiz-generator.skill
Option C — Download the pre-packaged .skill file
- Go to the Releases page
- Download
quiz-generator.skill - Run:
claude skill install ~/Downloads/quiz-generator.skill
Usage after installation
Once installed, Claude Code detects the skill automatically based on your prompt — no flags needed.
# Generate study questions from a Markdown file
claude --file my-notes.md "Generate study questions"
# Spanish prompt works too
claude --file apuntes.md "Genera preguntas de estudio"
# Focus on a specific topic
claude --file chapter3.md "Generate 15 hard questions about memory management"
# Skip the summary file
claude --file notes.md "Generate study questions, skip the summary"
Every run produces three output files:
my-notes-quiz.yaml ← structured quiz data (YAML)
my-notes-quiz-summary.md ← human-readable overview + answer key
my-notes-quiz.html ← interactive browser test with scoring
Skill Reference
quiz-generator
Reads a Markdown document, maps every distinct concept, and generates multiple-choice questions that cover all the knowledge in the file.
Outputs:
| File | Description |
|---|---|
<source>-quiz.yaml | Full quiz with questions, options, correct answers, explanations, difficulty, and tags |
<source>-quiz-summary.md | Coverage map, statistics, questions-at-a-glance answer key, and key concepts list |
<source>-quiz.html | Self-contained interactive test — radio buttons (single) / checkboxes (multiple), per-question validation, final score |
Key behaviours:
- Targets ~20 questions but exceeds that if the document has more concepts — full coverage wins over a round number
- Mixes
singleandmultipleanswer questions (~40% / ~60%) - Balances difficulty: ~30% easy, ~45% medium, ~25% hard
- Output language matches the source document automatically
See skills/quiz-generator/SKILL.md for the full specification and skills/quiz-generator/references/yaml-schema.md for the complete YAML schema.
Example outputs: skills/quiz-generator/examples/
pdf-to-markdown
Converts an attached PDF into a complete Markdown file without summarizing or omitting any content — including parallel columns, footnotes, and metadata.
Key behaviours:
- Preserves every paragraph, list, heading, and footnote — losing information is treated as an error
- Converts tables into bullet lists (no Markdown tables)
- Wraps structured term/word-study analysis in blockquotes
- Preserves Hebrew, Greek, and other non-Latin scripts exactly
- Saves output as
<source-basename>.md(or a chapter-numbered name if specified)
See skills/pdf-to-markdown/SKILL.md for the full specification and skills/pdf-to-markdown/references/term-analysis-block.md for the term-analysis block template.
Contributing
Contributions are welcome! To add a new skill:
- Create a folder under
skills/your-skill-name/ - Add a
SKILL.mdwith a YAML frontmatter block (nameanddescriptionare required) - Optionally add a
references/folder for supporting docs and anexamples/folder - Open a PR with a short description of what the skill does
See the quiz-generator skill as a reference implementation.
License
MIT