revision-notes-generator
npx machina-cli add skill maaarcooo/claude-skills/revision-notes-generator --openclawRevision Notes Generator
Generate concise, accurate revision notes from PDF or Markdown content in markdown format.
Process
- Read the source PDF or Markdown file thoroughly
- Identify all key content: bolded terms, highlighted text, and Higher Tier material
- Verify accuracy of all information in the source — correct any errors
- Write concise notes covering all essential topic knowledge
- Output as markdown file with the specified title
Writing Guidelines
Concise: Condense information to essential points. Remove filler and redundancy.
Complete: Cover all necessary knowledge for the topic. Don't omit key concepts.
Accurate: Cross-check facts against your knowledge. Flag or correct any errors in the source material.
Structured: Use clear headings and logical organisation. Group related concepts.
Clean: No clutter — exclude specification codes, redundant headers, or formatting artefacts from the source.
Higher Tier: Clearly include all Higher Tier content — optionally mark with (HT) if helpful.
Output Format
Markdown file with:
- Title as H1 heading (use exact title specified by user)
- Logical section headings (H2/H3)
- Key terms in bold
- Equations/formulas in code blocks or LaTeX where appropriate
- Concise bullet points or short paragraphs
Exclude: Specification/syllabus reference codes (e.g., "1.1.3 a)", "1.1.3 b)"). These clutter the notes — focus only on the actual knowledge content.
Example Structure
# [Topic Title]
## Key Concepts
**Term**: Definition.
## Section Name
Core explanation in concise form.
- Key point one
- Key point two (HT)
## Equations
`formula = expression`
Quality Checklist
- Title matches user's specification exactly
- All bolded/highlighted terms from source included
- Higher Tier content included
- Information verified for accuracy
- No unnecessary repetition
- Clear logical structure
- No specification reference codes included
Source
git clone https://github.com/maaarcooo/claude-skills/blob/main/revision-notes-generator/SKILL.mdView on GitHub Overview
Revision notes generator creates concise, accurate study notes from PDF or Markdown sources. It identifies key content, bold terms, and Higher Tier material, verifies accuracy, and outputs a tidy markdown file with a clear title and structured sections.
How This Skill Works
The tool reads the source file, extracts key terms and Higher Tier content, cross-checks facts for accuracy, and compiles structured notes with headings and bullet points. It then outputs a markdown file named after the topic title for easy distribution and review.
When to Use It
- After completing a chapter or module to generate quick revision notes for review
- When studying for exams that include Higher Tier material to ensure HT content is captured
- To consolidate multiple PDFs or Markdown sources into a single, coherent set of notes
- When you need to verify factual accuracy and flag potential errors in source material
- To create a clean, structured outline for last-minute revision
Quick Start
- Step 1: Provide the topic title and the source file (PDF or Markdown).
- Step 2: Run the Revision Notes Generator to extract key terms, HT content, and verify accuracy.
- Step 3: Export or download the output as a Markdown file titled with the topic name.
Best Practices
- Use the exact topic title to name the output for consistency across materials
- Ensure all bolded terms from the source are included in the notes and formatted in bold
- Clearly mark Higher Tier content with (HT) where helpful
- Cross-check facts against reliable knowledge and correct discrepancies
- Maintain logical structure with clear headings and concise bullet points; exclude extraneous codes or artefacts
Example Use Cases
- # Photosynthesis - Overview **Light-dependent reactions**: occur in the thylakoid membranes; produce ATP and NADPH. **Calvin cycle**: fixes CO2 into triose phosphates. HT content: light intensity limits rate.
- # Cell Membrane Structure **Phospholipid bilayer** provides a barrier; **cholesterol** modulates fluidity; **proteins** transport and signaling; selective permeability.
- # Mendelian Genetics (Key Concepts) **Dominant/recessive alleles**, **Punnett squares**, and **genotype vs phenotype** distinctions with simple examples.
- # Newton's Laws of Motion **First Law**: inertia; **Second Law**: F = ma; **Third Law**: action-reaction; real-world examples illustrate each law.
- # World War II: Causes and Turnings Causes include the Treaty of Versailles, rise of totalitarian regimes, imperial aggression, and failures of appeasement; overview of major turning points.
