review-27-github-archive
Organize a medical review manuscript project into a GitHub-ready archive with manuscript drafts, literature search logs, Zotero exports, evidence matrices, figure/table sources, citation audits, and r
SKILL.mdskills/review-27-github-archive/SKILL.md
GitHubReview 27 GitHub Archive
Overview
Use this skill to make each review project reusable, auditable, and easy to demonstrate. GitHub is for workflow provenance and project structure, not for validating medical evidence.
For Chinese users, explain the archive plan in Chinese. Keep folder and file names ASCII when they may be used across systems.
What To Archive
Recommended project structure. For projects started with review-28-six-step-workbench, use this six-folder layout:
review_project/
README.md
project_dashboard.md
decision_log.md
run_log.md
version_log.md
01_topic_journal_outline/
topic_options/
journal_match/
benchmark_reviews/
narrative_spine/
outline_versions/
02_literature_zotero/
search_strings/
raw_exports/
screening/
zotero_exports/
pdf_status/
target_journal_references/
evidence_matrix/
claim_evidence_maps/
private_pdfs_local_only/
03_manuscript_writing/
abstract/
introduction/
main_body/
discussion_conclusion/
section_chain/
claim_citation_maps/
language_polish/
docx_versions/
04_figures_tables/
figure_plan/
svg_sources/
biorender_blueprints/
figma_exports/
source_images/
table_excel/
figure_legends/
permissions/
05_submission_package/
journal_instructions/
final_manuscript/
cover_letter/
title_page/
highlights/
graphical_abstract/
checklists/
citation_audit/
submission_forms/
06_revision_response/
editor_decision/
reviewer_comments/
response_letter/
point_by_point/
revision_drafts/
additional_searches/
additional_figures_tables/
resubmission_package/
Privacy And Copyright Rules
- Do not commit copyrighted PDFs to a public repository.
- Do not commit unpublished manuscripts, patient data, identifiable clinical data, peer-review material, or licensed BioRender assets to public GitHub.
- Store PDF status, metadata, DOI, PMID, and Zotero keys instead of full PDFs when public sharing is intended.
- Keep private repositories for active manuscripts.
- Use redacted demo data for teaching videos.
GitHub Workflow
- Check whether the project is public, private, or teaching-demo only.
- Create or update the folder structure.
- Add artifact files from review skills:
review-23reference curation outputs.review-24section drafts.review-25Zotero and PDF status outputs.review-26figure/table outputs.review-17citation audit outputs.
- Write a short
README.mdexplaining topic, target journal, workflow, and artifact map. - Write
versions/changelog.mdwith major changes. - Recommend commit messages but do not publish sensitive content without user confirmation.
Artifact Naming Rules
- Use dates in
YYYYMMDDformat for major exports. - Use stable claim IDs, figure IDs, and table IDs.
- Keep filenames ASCII when possible.
- Do not rename Zotero exports without recording source date and collection name.
Output Format
Return:
- Archive readiness.
- Proposed folder structure.
- Files to include.
- Files to keep private or exclude.
- Suggested commit message.
- Next action.
Reference File
Read references/archive-gates.md when deciding whether a file belongs in public GitHub, private GitHub, local-only storage, or teaching-demo material.