How adkid-zephyr/oral-paper-skill works
Oral Paper Skill is a research-writing aid: users provide an idea, draft, or experiment plan, then use the skill and its distilled paper examples to get bounded, evidence-aware improvement advice or a reflection exercise. Its included research pipeline collects oral-paper records, extracts per-paper lessons, checks and corrects them, and synthesizes reusable practices. The README documents the user-facing capabilities; sampled scripts show parts of the pipeline, but not every stage’s wiring, so uncertain links are omitted or marked unverified.
Main entry points: cards Oral paper records · references Distilled references · distill_abstracts.py Abstract extraction · run_astra_analysis.py Analysis runner
Components 21
User experience
- Oral Paper Skill
skills/oral-paper-skill - Quick prompts
prompts - Distilled references
skills/oral-paper-skill/references
Paper corpus
- Oral paper records
research/abstract_distillation/cards - Corpus collection
scripts/collect_corpus.py - Corpus manifests
research/abstract_distillation/corpus
Extraction and review
- Abstract extraction
scripts/distill_abstracts.py - Source review packets
scripts/prepare_source_review.py - Review summary
scripts/summarize_reviews.py - Compile corrections
scripts/compile_review_corrections.py - Apply corrections
scripts/apply_source_corrections.py - Extraction verification
scripts/verify_distillation.py
Synthesis and guidance
- Synthesis packets
scripts/prepare_synthesis.py - Batch synthesis
scripts/run_synthesis_batches.py - Analysis runner
scripts/run_astra_analysis.py - Final synthesis input
scripts/prepare_final_synthesis.py - Behavior check inputs
scripts/prepare_behavior_checks.py - Synthesis results
research/abstract_distillation/synthesis
Other components
- Researcher
- Source reviewer
- Codex model service
Connections 24
- Researcher → Oral Paper Skill: requests guidance
README.md - Researcher → Quick prompts: uses prompt
README.md - Oral Paper Skill → Distilled references: uses practices
README.md - Distilled references → Oral paper records: cites examples
README.md - Corpus collection → Corpus manifests: collects records
- Corpus manifests → Abstract extraction: supplies abstracts
- Abstract extraction → Codex model service: requests extraction
- Abstract extraction → Oral paper records: writes cards
- Oral paper records → Source review packets: provides cards
scripts/prepare_source_review.py - Source reviewer → Source review packets: reviews packets
- Source review packets → Compile corrections: supplies reviews
- Compile corrections → Apply corrections: provides corrections
scripts/apply_source_corrections.py - Apply corrections → Oral paper records: updates cards
scripts/apply_source_corrections.py - Oral paper records → Review summary: provides cards
scripts/summarize_reviews.py - Oral paper records → Extraction verification: provides cards
scripts/verify_distillation.py - Oral paper records → Synthesis packets: provides cards
scripts/prepare_synthesis.py - Synthesis packets → Batch synthesis: provides batches
- Batch synthesis → Analysis runner: invokes analysis
scripts/run_synthesis_batches.py - Analysis runner → Codex model service: runs analysis
scripts/run_astra_analysis.py - Analysis runner → Synthesis results: writes results
- Synthesis results → Final synthesis input: supplies syntheses
scripts/prepare_final_synthesis.py - Review summary → Final synthesis input: gates assembly
scripts/prepare_final_synthesis.py - Final synthesis input → Distilled references: informs guidance
- Distilled references → Behavior check inputs: supplies skill text
scripts/prepare_behavior_checks.py