CGPT Project Scaffold
Use this skill to set up a new research or teaching workspace. Default to a proposal first; create folders and files only after the user approves the scaffold or clearly asks to execute it.
Modes
- Research manuscript project: paper, revision, dataset, journal submission, manuscript workspace.
- Teaching project: course, module, slides, handouts, instructor notes, student materials, interactive tools.
- Active manuscript workspace: shallow working area for current QMD, rendered files, and submission artifacts.
Guardrails
- Do not create folders or move files until the user approves the proposed layout unless the request explicitly says to create it now.
- Use
cgpt-onedrive-git-safety when working inside synced Git folders.
- Keep new structures shallow and named clearly. Avoid burying active manuscript files multiple levels down.
- Do not register projects in Claude/Cowork-specific config. This is a Codex skill; create Codex-readable handoff/status files instead.
- Do not run
git init, commit, push, or move existing files unless explicitly requested.
- If creating Markdown proposals or handoffs for the user, also create HTML copies under
REPORTS/CODEX when the user needs readable reports.
Research Scaffold
Recommended structure:
<PROJECT>/
├── MEMORY.md
├── HANDOFF.md
├── SESSION-LOG.md
├── DECISIONS.md
├── quality_reports/
├── manuscript/
├── rendered/
├── data/
├── scripts/
└── references/
Use templates from MANUSCRIPT-DEV-KIT/templates/ when available. Fill only known fields; leave explicit placeholders for missing information.
Teaching Scaffold
For a course:
<COURSE>/
├── HANDOFF.md
├── SESSION-LOG.md
├── COURSE-MATERIALS/
├── SLIDES/
├── HANDOUTS/
├── INSTRUCTOR-NOTES/
├── INTERACTIVE/
├── DATA/
├── SCRIPTS/
└── MEDIA/
For a topic module:
<TOPIC>/
├── HANDOFF.md
├── SESSION-LOG.md
├── slides/
├── handouts/
├── instructor-notes/
├── interactive/
└── media/
Workflow
- Gather project name, type, title, purpose, target journal/course, collaborators, and immediate deliverables.
- Propose the scaffold with exact paths.
- Identify any source files to copy, not move.
- Ask for approval when the request is not explicitly execution-oriented.
- Create folders and starter files.
- Verify file existence and report exact paths.
Output
Report:
- created paths
- skipped optional fields
- next concrete task
- any source files copied
- any assumptions about naming, target journal, course, or folder depth
1---2name: cgpt-project-scaffold3description: Plan and create conservative research or teaching project folder scaffolds with tracking files, handoffs, and template-based starter structure. Use when the user asks to start a new manuscript project, teaching module, course folder, or project workspace.4---56# CGPT Project Scaffold78Use this skill to set up a new research or teaching workspace. Default to a proposal first; create folders and files only after the user approves the scaffold or clearly asks to execute it.910## Modes1112- Research manuscript project: paper, revision, dataset, journal submission, manuscript workspace.13- Teaching project: course, module, slides, handouts, instructor notes, student materials, interactive tools.14- Active manuscript workspace: shallow working area for current QMD, rendered files, and submission artifacts.1516## Guardrails1718- Do not create folders or move files until the user approves the proposed layout unless the request explicitly says to create it now.19- Use `cgpt-onedrive-git-safety` when working inside synced Git folders.20- Keep new structures shallow and named clearly. Avoid burying active manuscript files multiple levels down.21- Do not register projects in Claude/Cowork-specific config. This is a Codex skill; create Codex-readable handoff/status files instead.22- Do not run `git init`, commit, push, or move existing files unless explicitly requested.23- If creating Markdown proposals or handoffs for the user, also create HTML copies under `REPORTS/CODEX` when the user needs readable reports.2425## Research Scaffold2627Recommended structure:2829```text30<PROJECT>/31├── MEMORY.md32├── HANDOFF.md33├── SESSION-LOG.md34├── DECISIONS.md35├── quality_reports/36├── manuscript/37├── rendered/38├── data/39├── scripts/40└── references/41```4243Use templates from `MANUSCRIPT-DEV-KIT/templates/` when available. Fill only known fields; leave explicit placeholders for missing information.4445## Teaching Scaffold4647For a course:4849```text50<COURSE>/51├── HANDOFF.md52├── SESSION-LOG.md53├── COURSE-MATERIALS/54├── SLIDES/55├── HANDOUTS/56├── INSTRUCTOR-NOTES/57├── INTERACTIVE/58├── DATA/59├── SCRIPTS/60└── MEDIA/61```6263For a topic module:6465```text66<TOPIC>/67├── HANDOFF.md68├── SESSION-LOG.md69├── slides/70├── handouts/71├── instructor-notes/72├── interactive/73└── media/74```7576## Workflow77781. Gather project name, type, title, purpose, target journal/course, collaborators, and immediate deliverables.792. Propose the scaffold with exact paths.803. Identify any source files to copy, not move.814. Ask for approval when the request is not explicitly execution-oriented.825. Create folders and starter files.836. Verify file existence and report exact paths.8485## Output8687Report:8889- created paths90- skipped optional fields91- next concrete task92- any source files copied93- any assumptions about naming, target journal, course, or folder depth