agent-skills

Create a structured handoff document for Codex task continuity, capturing decisions, rationale, failed approaches, current state, and next steps so a fresh task can continue without re-explanation. Use when explicitly invoked with $handoff; text supplied alongside the invocation may identify a focus.

Resume a Codex task from a handoff document by verifying it against the current codebase, summarising the actual state, and continuing from the next step. Use when explicitly invoked with $resume; text supplied alongside the invocation may name a handoff file or partial filename.

Extract and clean PDF content to markdown format. Use when the user uploads a PDF file and wants to convert it to clean, readable markdown. Handles text extraction, image extraction, metadata capture, and intelligent content cleanup. Removes repeated footers, watermarks, page numbers, branding, and reorganizes fragmented content into coherent structure.

Convert PDF files to markdown format using visual PDF understanding or image OCR. Use when asked to convert a PDF to markdown, extract PDF content to markdown, transcribe a PDF, or prepare PDF content for further processing. Preserves all text, structure, tables, and equations. Outputs as a markdown file.

Generate Anki flashcard decks from PDF or Markdown study materials. Use only when "Anki flashcard" or "Anki deck" is explicitly mentioned. Do not trigger for generic flashcard requests. Outputs in Anki-importable format (Question | Answer).

Ask clarifying questions and discuss direction before starting work. Trigger whenever the user asks Claude to discuss, clarify, or ask questions before proceeding with a task. Natural phrasings include "let's discuss before proceeding", "ask me questions for clarification or direction", "let's discuss and make a plan first", "clarify the direction before starting", and "feel free to ask me anything before you start". Also trigger on the explicit keyword "discuss-first". Do NOT trigger on conversational uses of "discuss" where the user simply wants Claude to explain or talk about a topic and there is no task being held back.

Extract and clean PDF content to markdown format. Use when the user uploads a PDF file and wants to convert it to clean, readable markdown. Handles text extraction, image extraction, metadata capture, and intelligent content cleanup. Removes repeated footers, watermarks, page numbers, branding, and reorganizes fragmented content into coherent structure.

Create a structured handoff document for seamless continuity across Claude conversations. Use when the user explicitly asks to create a handoff, handover, or session transfer document, or signals they want to stop now and continue this work in a future conversation. Trigger phrases include: "create a handoff", "handoff document", "handover", "save session", "continue later", "session handoff", "transfer context", "let's pick this up tomorrow", "save this so we can continue next time", or "/handoff". Do NOT trigger for general conversation summaries, meeting notes, or when the user simply asks "summarise this conversation" without handoff/continuity intent. Do NOT trigger when the user uploads an existing handoff document to resume from — handoff documents are self-contained and carry their own resumption instructions; this skill is for creating them only.

Use this skill when the user wants intellectual understanding — learning how or why something works, not getting a task done or soliciting Claude's judgment. Trigger for: - Explicit learning requests: teach, explain, ELI5, walk me through, quiz me, flashcards, "I'm rusty on"; definitions ("what is X") - Terse concept names implying "help me understand this": "Galois theory," "transformers, from scratch" - Confusion signals: "won't stick," "keep mixing these up," "not getting it" - Learning-path questions: prerequisites, sequencing, what to study before X - Conceptual questions about mechanisms, causes, or dynamics Don't trigger for: - Tasks: coding, writing, calculation, translation, factual lookup, news updates - Personal troubleshooting; resource/textbook recommendations - Claude's evaluative verdict: opinion prompts ("do you think X", "settle this", "honest take", "is X dead / still taken seriously") and interpretive takes ("was X really as harsh as people say")

Generate concise, self-contained revision notes from PDF or Markdown study materials. Use whenever asked to create revision notes, study notes, topic summaries, or condensed notes from educational PDFs, Markdown files, textbooks, or course materials (e.g. Save My Exams, PMT, A-Level or GCSE resources), even if the word "revision" is not used. Outputs a markdown file.

Generate Anki flashcard decks from PDF or Markdown study materials. Use only when "Anki flashcard" or "Anki deck" is explicitly mentioned. Do not trigger for generic flashcard requests. Outputs in Anki-importable format (Question | Answer).

Create a structured handoff document for seamless continuity across Claude conversations. Use when the user explicitly asks to create a handoff, handover, or session transfer document, or signals they want to stop now and continue this work in a future conversation. Trigger phrases include: "create a handoff", "handoff document", "handover", "save session", "continue later", "session handoff", "transfer context", "let's pick this up tomorrow", "save this so we can continue next time", or "/handoff". Do NOT trigger for general conversation summaries, meeting notes, or when the user simply asks "summarise this conversation" without handoff/continuity intent. Do NOT trigger when the user uploads an existing handoff document to resume from — handoff documents are self-contained and carry their own resumption instructions; this skill is for creating them only.

Use this skill when the user wants intellectual understanding — learning how or why something works, not getting a task done or soliciting Claude's judgment. Trigger for: - Explicit learning requests: teach, explain, ELI5, walk me through, quiz me, flashcards, "I'm rusty on"; definitions ("what is X") - Terse concept names implying "help me understand this": "Galois theory," "transformers, from scratch" - Confusion signals: "won't stick," "keep mixing these up," "not getting it" - Learning-path questions: prerequisites, sequencing, what to study before X - Conceptual questions about mechanisms, causes, or dynamics Don't trigger for: - Tasks: coding, writing, calculation, translation, factual lookup, news updates - Personal troubleshooting; resource/textbook recommendations - Claude's evaluative verdict: opinion prompts ("do you think X", "settle this", "honest take", "is X dead / still taken seriously") and interpretive takes ("was X really as harsh as people say")

Generate concise, self-contained revision notes from PDF or Markdown study materials. Use whenever asked to create revision notes, study notes, topic summaries, or condensed notes from educational PDFs, Markdown files, textbooks, or course materials (e.g. Save My Exams, PMT, A-Level or GCSE resources), even if the word "revision" is not used. Outputs a markdown file.

Ask clarifying questions and discuss direction before starting work. Use when the user invokes $discuss or says "discuss-first", wants to discuss requirements, clarify scope, or asks Codex to ask questions before proceeding with a task. Natural phrasings include "let's discuss before proceeding", "ask me questions for clarification or direction", and "let's discuss and make a plan first". Do not use for general requests to explain or discuss a topic when no pending task is being held back.