| name | submit |
| description | Final submission verification gate for the sewage-house-prices paper. Runs full paper excellence review, replication audit, enforces score gates, and generates cover letter draft and submission checklist. This skill should be used when asked to "submit", "prepare for submission", or "submission checklist". |
| argument-hint | [journal name (optional)] |
| allowed-tools | ["Read","Grep","Glob","Write","Bash","Agent"] |
Submit
Final submission gate combining full verification, score enforcement, and submission checklist.
Input: $ARGUMENTS — target journal name (optional).
Workflow
Step 1: Pre-Flight Checks
- Verify manuscript exists at
docs/overleaf/_main.tex
- Check for existing quality reports in
output/log/
- Verify analysis outputs exist in
output/tables/ and output/figures/
- Check
Replication/ directory exists (if not, flag for /data-deposit)
Step 2: Run Full Verification
If /paper-excellence hasn't been run recently (check report dates in output/log/):
- Run the full paper excellence review (econometrics, code, paper, bibliography)
Step 3: Run Replication Audit
If Replication/ exists:
- Run
/audit-replication Replication/
Step 4: Score Gate
Check against thresholds:
| Requirement | Threshold | Status |
|---|
| Aggregate score | >= 90 | PASS/FAIL |
| Econometrics component | >= 80 | PASS/FAIL |
| Code component | >= 80 | PASS/FAIL |
| Paper component | >= 80 | PASS/FAIL |
| Replication (if exists) | >= 8/10 checks | PASS/FAIL |
If any requirement FAILS: List specific blocking issues and stop. Do not generate submission materials.
Step 5: Generate Submission Package
If all gates pass:
-
Cover letter draft (save to output/log/cover_letter_[journal]_[date].tex):
- Addressed to current editor
- 1 paragraph: what the paper does (sewage spill capitalisation using EDM data)
- 1 paragraph: why this journal (fit with environmental/housing economics)
- 1 paragraph: originality confirmation
- Suggested referees (3-5, from
/target-journal if available)
-
Final checklist (save to output/log/submission_checklist_[date].md):
# Submission Checklist: [Journal]
## Manuscript
- [ ] Title page with affiliations and contact info
- [ ] Abstract within word limit
- [ ] JEL codes (2-3): Q53, R31, Q58
- [ ] Keywords: sewage spills, house prices, hedonic pricing, environmental disamenity, EDM
- [ ] Journal formatting guidelines followed
## Data and Code
- [ ] Replication package assembled
- [ ] Data availability statement in manuscript
- [ ] Restricted data flagged (Land Registry, Zoopla)
## Quality Gates
- [ ] Aggregate score: XX/100 (>= 90 required)
- [ ] All components >= 80
- [ ] No unresolved CRITICAL issues
## Submission
- [ ] Upload manuscript PDF
- [ ] Upload replication package (if required)
- [ ] Upload cover letter
- [ ] Submit via [portal]
Step 6: Present Results
# Submission Report
**Date:** YYYY-MM-DD
**Target Journal:** [name]
**Aggregate Score:** XX/100
## Gate Status: [PASS / FAIL]
| Component | Score | Threshold | Status |
|-----------|-------|-----------|--------|
| Aggregate | XX | >= 90 | ... |
| Econometrics | XX | >= 80 | ... |
| Code | XX | >= 80 | ... |
| Paper | XX | >= 80 | ... |
| Replication | X/10 | >= 8/10 | ... |
## Generated Materials
- Cover letter: output/log/cover_letter_*.tex
- Checklist: output/log/submission_checklist_*.md
## Remaining Steps (manual)
1. Review and customise cover letter
2. Upload to [submission portal]
3. Enter suggested referees
4. Submit
Principles
- This is the final gate. Score >= 90 with all components >= 80.
- If it fails, stop. List blocking issues. Don't generate submission materials for a failing paper.
- Cover letter is a draft. The user must review and customise before sending.
- Manual submission. This skill prepares materials but does NOT submit to journals.
- Be realistic. If the paper isn't ready, say so clearly.
