| name | grant-proposal |
| description | Draft a structured grant proposal from research ideas and literature. Supports KAKENHI (Japan), NSF (US), NSFC (China, including 面上/青年/优青/杰青/海外优青/重点), ERC (EU), DFG (Germany), SNSF (Switzerland), ARC (Australia), NWO (Netherlands), and generic formats. Use when user says "write grant", "grant proposal", "申請書", "write KAKENHI", "科研費", "基金申请", "写基金", "NSF proposal", or wants to turn research ideas into a funding application. |
Override for Codex users who want Gemini, not a second Codex agent, to act as the reviewer. Install this package after skills/skills-codex/*.
Grant Proposal: From Research Ideas to Fundable Application
Gemini overlay assurance: review_independence: cross-family and acceptance_status: accepted.
Draft a grant proposal based on: $ARGUMENTS
Overview
This skill turns validated research ideas into a structured, reviewer-ready grant proposal. It chains sub-skills into a grant-specific pipeline:
/research-lit → /novelty-check → [structure design] → [draft] → /research-review → [revise] → GRANT_PROPOSAL.md
(survey) (verify gap) (aims + matrix) (prose) (panel review) (fix) (done!)
This is a parallel branch, not part of the linear Workflow 1→1.5→2→3 pipeline. After /idea-discovery produces validated ideas, the user can either:
- Go to
/experiment-bridge → /auto-review-loop → /paper-writing (implement & publish)
- Go to
/grant-proposal (write funding application first, then implement after funding)
┌→ /experiment-bridge → /auto-review-loop → /paper-writing (publish track)
/idea-discovery ────┤
└→ /grant-proposal → [get funded] → /experiment-bridge → ... (funding track)
Grant proposals argue for future work (feasibility + potential), not completed work (results + claims). This skill handles the unique requirements of grant writing: narrative arc design, reviewer-facing structure, budget justification, timeline planning, and agency-specific formatting.
Constants
- GRANT_TYPE =
KAKENHI — Default grant type. Supported: KAKENHI, NSF, NSFC, ERC, DFG, SNSF, ARC, NWO, GENERIC. Override via argument (e.g., /grant-proposal "topic — NSF").
- GRANT_SUBTYPE =
auto — Sub-type within the grant agency. Examples: KAKENHI Start-up/Wakate/Kiban-B; NSFC Youth/Excellent-Youth/Distinguished/Overseas/Key; NSF CAREER/CRII/Standard. Auto-detected from argument or defaults to the most common sub-type.
- REVIEWER_MODEL =
gemini-review — Gemini reviewer invoked through the local gemini-review MCP bridge for proposal review. Set GEMINI_REVIEW_MODEL if you need a specific Gemini model override.
- OUTPUT_FORMAT =
markdown — Output format. Supported: markdown, latex. LaTeX uses grant-specific templates when available.
- MAX_REVIEW_ROUNDS = 2 — Maximum external review-revise cycles before finalizing.
- OUTPUT_DIR =
grant-proposal/ — Directory for generated proposal files.
- LANGUAGE =
auto — Output language. Auto-detected from grant type: KAKENHI→Japanese, NSF→English, NSFC→Chinese, ERC→English, DFG→English (or German), SNSF→English, ARC→English, NWO→English. Override explicitly if needed.
- AUTO_PROCEED = false — At each checkpoint, always wait for explicit user confirmation before proceeding. Grant proposals require PI-specific judgment at every stage. Set
true only if user explicitly requests fully autonomous mode.
💡 These are defaults. Override by telling the skill, e.g., /grant-proposal "topic — NSF CAREER, latex output" or /grant-proposal "topic — NSFC Youth, language: English".
Grant Type Specifications
KAKENHI (Japan — JSPS)
| Field | Detail |
|---|
| Sections | 研究目的 (Research Objective), 研究計画・方法 (Plan & Methods), 準備状況 (Preparation Status), 人権の保護 (Ethics, if applicable) |
| Sub-types | 基盤研究 A/B/C (Kiban), 若手研究 (Wakate), 研究活動スタート支援 (Start-up), 国際共同研究 (International), 学術変革領域 (Transformative), 挑戦的研究 (Challenging), DC1/DC2 (doctoral) |
| Language | Japanese (English technical terms acceptable) |
| Review criteria | 学術的重要性 (academic significance), 独創性 (originality), 研究計画の妥当性 (plan feasibility), 研究遂行能力 (PI capability) |
| Cultural norms | Explicit yearly milestones (Year 1 / Year 2), budget justification integrated into plan, emphasize 社会的意義 (societal significance), concrete expected outputs (papers, datasets), reference KAKEN database for related funded projects |
NSF (US)
| Field | Detail |
|---|
| Sections | Project Summary (1p), Project Description (15p max), References Cited, Biographical Sketch, Budget Justification, Data Management Plan |
| Sub-types | Standard Grant, CAREER (early career), CRII (research initiation), RAPID, EAGER |
| Language | English |
| Review criteria | Intellectual Merit, Broader Impacts |
| Cultural norms | Aim-based structure (Aim 1/2/3), preliminary data strongly expected, broader impacts must be concrete and specific (not generic "benefit society"), Results from Prior Support section |
NSFC (China — 国家自然科学基金)
| Field | Detail |
|---|
| Sections | 立项依据 (Rationale & Significance), 研究内容 (Content), 研究目标 (Objectives), 研究方案 (Plan & Methods), 可行性分析 (Feasibility), 创新性 (Innovation Points), 预期成果 (Expected Outcomes), 研究基础 (PI Foundation & Track Record) |
| Sub-types | 面上项目 (General Program) — emphasis on scientific problem and research accumulation; 青年基金 (Young Scientists Fund) — age ≤35, emphasis on independence and growth potential; 优秀青年基金/优青 (Excellent Young Scientists) — age ≤38, emphasis on outstanding achievements; 杰出青年基金/杰青 (Distinguished Young Scientists) — age ≤45, emphasis on international-leading level; 海外优青 (Overseas Excellent Young Scientists) — emphasis on overseas experience and return contribution plan; 重点项目 (Key Program) — emphasis on systematic in-depth research |
| Language | Chinese |
| Review criteria | 科学意义 (scientific significance), 创新性 (innovation), 可行性 (feasibility), 研究队伍 (team qualification) |
| Cultural norms | Heavy emphasis on 国际前沿 (international frontier) positioning, detailed feasibility analysis, explicit citation of applicant's prior publications, 研究基础 section is critical for demonstrating PI capability |
ERC (EU — European Research Council)
| Field | Detail |
|---|
| Sections | Extended Synopsis (5p), Scientific Proposal Part B2 (15p) |
| Sub-types | Starting Grant (2-7 years post-PhD), Consolidator Grant (7-12 years), Advanced Grant (established leaders) |
| Language | English |
| Review criteria | Ground-breaking nature, Methodology, PI track record |
| Cultural norms | Emphasis on "high-risk/high-gain", methodology table with WP/deliverables/milestones, Gantt chart expected, strong PI narrative |
DFG (Germany — Deutsche Forschungsgemeinschaft)
| Field | Detail |
|---|
| Sections | State of the Art, Objectives, Work Programme, Bibliography, CV |
| Language | English or German |
| Review criteria | Scientific quality, Originality, Feasibility, PI qualification |
SNSF (Switzerland — Swiss National Science Foundation)
| Field | Detail |
|---|
| Sections | Summary, Research Plan, Timetable, Budget |
| Language | English |
| Review criteria | Scientific relevance, Originality, Feasibility, Track record |
ARC (Australia — Australian Research Council)
| Field | Detail |
|---|
| Sections | Project Description, Feasibility, Benefit, Budget |
| Language | English |
| Review criteria | Research quality, Feasibility, Benefit to Australia |
NWO (Netherlands — Dutch Research Council)
| Field | Detail |
|---|
| Sections | Summary, Proposed Research, Knowledge Utilisation |
| Language | English |
| Review criteria | Scientific quality, Innovative character, Knowledge utilisation |
GENERIC
For any grant not listed above. User provides section names, page limits, and review criteria via argument:
/grant-proposal "topic — GENERIC, sections: Background|Methods|Impact, language: English"
State Persistence (Compact Recovery)
Grant proposal drafting is a long task that may trigger context compaction. Persist state to grant-proposal/GRANT_STATE.json after each phase:
{
"phase": 2,
"grant_type": "KAKENHI",
"grant_subtype": "Start-up",
"language": "Japanese",
"thread_id": "019cfcf4-...",
"gap_statement": "...",
"aims_count": 3,
"status": "in_progress",
"timestamp": "2026-03-18T15:00:00"
}
Write this file at the end of every phase. On invocation, check for this file:
- If absent or
status: "completed" → fresh start
- If
status: "in_progress" and within 24h → resume from saved phase (read GRANT_PROPOSAL.md and GRANT_REVIEW.md to restore context)
- If older than 24h → fresh start (stale state)
On completion, set "status": "completed".
Workflow
Phase 0: Input Parsing & Context Gathering
Parse $ARGUMENTS to extract:
- Research direction/idea — may reference existing files or be a freeform description
- Grant type — detect from keywords (e.g., "科研費"→KAKENHI, "NSF"→NSF, "国自然"→NSFC, "基金"→NSFC)
- Grant sub-type — detect from keywords (e.g., "Start-up", "若手", "青年", "CAREER", "优青", "海外优青")
- Overrides — output format, language, review rounds
Then gather context from the project directory:
- Read
idea-stage/IDEA_REPORT.md if it exists (from /idea-discovery); fall back to ./IDEA_REPORT.md if not found
- Read
refine-logs/FINAL_PROPOSAL.md if it exists (from /research-refine)
- Read
refine-logs/EXPERIMENT_PLAN.md if it exists (from /experiment-plan)
- Read
review-stage/AUTO_REVIEW.md if it exists (from /auto-review-loop — prior review feedback is gold for grants); fall back to ./AUTO_REVIEW.md if not found
- Read
NARRATIVE_REPORT.md or STORY.md if they exist
- Read any existing literature notes or survey documents
- Scan for the user's publication list (e.g.,
publications.md, cv.md, bio.md, CV.pdf)
- Check for
grant-proposal/GRANT_STATE.json (resume from prior interrupted run)
If insufficient context exists:
- No research idea at all → suggest running
/idea-discovery first
- No literature survey → will invoke
/research-lit inline in Phase 1
- No publication list → leave PI qualification section with
[TODO: Add publications] placeholders
- Has
review-stage/AUTO_REVIEW.md → extract reviewer feedback and use it to strengthen the feasibility narrative
Phase 1: Literature & Landscape Positioning
Invoke /research-lit to ground the proposal in real literature, then search for competing funded projects:
/research-lit "$ARGUMENTS"
What this does:
- Reuse existing surveys if
/research-lit was already run and notes exist
- Otherwise invoke
/research-lit for multi-source literature search (arXiv, Scholar, Zotero, local PDFs)
- Search for funded projects in the same area via WebSearch:
- Identify competing groups and their recent publications
- Run
/novelty-check on the proposed research direction to verify the gap is real:
/novelty-check "[proposed gap statement]"
- Build the gap statement — the single most important sentence in the proposal:
"Despite progress in [X], [specific gap] remains unaddressed because [reason].
This proposal addresses this by [approach], which will [expected impact]."
🚦 Checkpoint: Present the landscape summary and gap statement to the user:
📚 Literature & landscape analysis complete:
- [key findings from literature]
- [competing funded projects found]
- Gap statement: "[the gap statement]"
Does this accurately capture the positioning? Should I adjust before designing the proposal structure?
⛔ STOP HERE and wait for user response. Do NOT auto-proceed unless AUTO_PROCEED=true was explicitly set by the user.
Options for the user:
- Reply "go" or "ok" → proceed to Phase 2 with current positioning
- Reply with adjustments (e.g., "focus more on X", "the gap should emphasize Y") → refine and re-present
- Reply "stop" → end the skill, save current progress to
grant-proposal/DRAFT_NOTES.md
State: Write GRANT_STATE.json with phase: 1 and the gap statement.
Phase 2: Narrative Structure & Aims Design
Design the proposal's logical architecture before writing any prose.
2.1 Define Specific Aims (2-4)
Each aim must satisfy:
- Independently valuable — if one aim fails, others still produce publishable results
- Logically connected — Aim 1 enables Aim 2, Aim 2 informs Aim 3
- Concrete deliverables — each aim maps to specific outputs (papers, datasets, tools, benchmarks)
- Feasible within budget and timeline
2.2 Build Claims-Aims-Evidence Matrix
| Aim | Key Claim | Preliminary Evidence | Proposed Validation | Risk Level | Deliverable |
|-----|-----------|---------------------|--------------------|-----------:|-------------|
| Aim 1 | [claim] | [pilot data, prior work] | [experiments] | LOW | [paper, dataset] |
| Aim 2 | [claim] | [theoretical basis] | [experiments] | MEDIUM | [paper, tool] |
2.3 Design the Narrative Arc
Grant proposals follow a fundamentally different arc from papers:
Problem → Why Now → What We Propose → Why It Will Work → What We Will Deliver
(not: Problem → Method → Results → Implications)
- Problem: What gap exists and why it matters (scientific + societal)
- Why Now: What recent developments make this the right time (new data, new methods, new need)
- What We Propose: The specific aims and approach
- Why It Will Work: Preliminary data, PI track record, team expertise, feasibility arguments
- What We Will Deliver: Concrete outputs, timeline, expected publications
2.4 Timeline & Milestones
Design year-by-year (or quarter-by-quarter) plan:
### Year 1
- Q1-Q2: [Aim 1 tasks]
- Q3-Q4: [Aim 1 completion + Aim 2 start]
- Expected outputs: [papers, datasets]
### Year 2
- Q1-Q2: [Aim 2 completion + Aim 3]
- Q3-Q4: [Aim 3 completion + synthesis]
- Expected outputs: [papers, tools, final report]
2.5 Structural Review
Invoke /research-review to get critical feedback on the proposal structure before drafting:
/research-review "[GRANT_TYPE] [GRANT_SUBTYPE] proposal structure:
Gap: [gap statement]
Aims: [aims list with claims-evidence matrix]
Timeline: [timeline]
— reviewer persona: [GRANT_TYPE] review panelist"
What this does:
- Gemini acts as a grant review panelist (not a paper reviewer)
- Evaluates aims independence, narrative arc, risk identification, timeline realism
- Identifies the single biggest reviewer concern
- Provides actionable fixes ranked by severity
Apply structural feedback before proceeding to drafting.
🚦 Checkpoint: Present the proposal structure to the user:
🏗️ Proposal structure designed:
- Gap: [gap statement]
- Aim 1: [title] — Risk: LOW
- Aim 2: [title] — Risk: MEDIUM
- Aim 3: [title] — Risk: LOW
- Timeline: [summary]
- Reviewer feedback: [key points from Gemini]
Proceed to section drafting? Or adjust the structure?
⛔ STOP HERE. This is the most critical checkpoint — the proposal structure determines everything downstream.
Options for the user:
- Reply "go" or "ok" → proceed to Phase 3 (section drafting)
- Reply with structural changes (e.g., "merge Aim 2 and 3", "add an aim about X", "reduce to 2 aims") → redesign and re-present
- Reply "back" → return to Phase 1 to adjust the gap/positioning
- Reply "stop" → save current structure to
grant-proposal/DRAFT_NOTES.md
State: Write GRANT_STATE.json with phase: 2, aims summary, and the completed reviewer thread_id if you ran the reviewer directly.
Phase 3: Section Drafting
Draft each section according to the grant type template. Write complete prose, not outlines or placeholders.
What this does:
- Writes all required sections in the agency-specific language and tone
- Pulls content from
idea-stage/IDEA_REPORT.md, FINAL_PROPOSAL.md, and literature notes
- Uses
/paper-illustration for figure generation (if user requests)
- Leaves
[TODO] only for PI-specific information, [AMOUNT] for budget figures
- Outputs
grant-proposal/GRANT_PROPOSAL.md
Drafting Order (optimized for narrative coherence)
- Specific Aims / Research Objective — the "abstract" of the grant. Write first, refine last.
- Background / Significance / State of the Art — establish the problem and gap.
- Research Plan / Methods — per aim, with feasibility arguments.
- Figures — generate key diagrams (see below).
- Timeline & Milestones — year-by-year deliverables.
- PI Qualification / Preparation Status — track record, team, infrastructure.
- Budget Justification — narrative only (leave dollar/yen amounts as
[AMOUNT] placeholders).
- Broader Impacts / Societal Significance — if required by the grant type.
Figure Generation
Grant proposals benefit greatly from clear diagrams. Generate the following figures using SVG or matplotlib (save to grant-proposal/figures/):
- 全体構成図 / Overview Diagram — Show the relationship between aims (Aim 1 → Aim 2 → Aim 3), shared resources (participants, stimuli, pipeline), and outputs. This is the single most important figure.
- 実験パラダイム図 / Experimental Paradigm — Visual schematic of each paradigm (stimulus timing, conditions, EEG recording).
- 年次計画 / Timeline Gantt Chart — Year-by-year (or H1/H2) milestones with deliverables.
For AI-generated publication-quality figures, invoke /paper-illustration:
/paper-illustration "Overview diagram showing [aims relationship + shared resources] for grant proposal"
For simpler diagrams (flowcharts, Gantt charts), generate clean SVG or matplotlib directly via code.
🚦 Figure Checkpoint: Before generating, ask which figures the user wants:
🎨 The following figures would strengthen this proposal:
1. 全体構成図 / Overview — aims relationship + shared resources
2. 実験パラダイム図 / Paradigm — stimulus timing + conditions
3. 年次計画 / Gantt — timeline with milestones
Which should I generate? (e.g., "1 and 3", "all", "skip")
⛔ Wait for user response. Generate only the requested figures.
Grant-Specific Drafting Guidelines
KAKENHI:
- Write in formal Japanese academic style (である調, not です/ます調)
- Use 「」for Japanese quotations, bold for emphasis
- Structure: 研究の学術的背景 → 研究期間内に何をどこまで明らかにするか → 本研究の学術的な特色・独創性
- Include explicit 年次計画 (yearly plan) with concrete milestones
- Emphasize 社会的意義 (societal significance)
- Reference related KAKEN-funded projects to show awareness of the field
NSF:
- Write in clear, direct English
- Use Aim-based structure with bold headings
- Preliminary data paragraphs for each Aim (with figure references)
- Broader Impacts must be concrete: specific outreach activities, broadening participation plans
- Include Results from Prior Support (if PI has prior NSF funding)
NSFC:
- Write in formal Chinese academic style
- 立项依据 must position work at 国际前沿 (international frontier)
- 创新性 section must list numbered innovation points (创新点)
- 研究基础 must cite PI's own publications (with IF and citations if possible)
- 可行性分析 must address: technical feasibility, team capability, time feasibility, equipment/conditions
ERC:
- Write a compelling "high-risk/high-gain" narrative
- Extended Synopsis must be self-contained and compelling
- Include Work Package table with deliverables and milestones
- Gantt chart (describe in text, or generate as figure)
For Each Section
- Pull relevant content from
idea-stage/IDEA_REPORT.md, FINAL_PROPOSAL.md, literature notes
- Write complete prose — no
[TODO] except for PI-specific information
- Include figure/table placeholders where appropriate (e.g.,
[Figure 1: System architecture])
- Cite references properly — use citation keys, will build bibliography later
- Match the agency's tone and style — formal Japanese for KAKENHI, direct English for NSF, etc.
Phase 4: External Review
Invoke /research-review on the complete draft for grant-type-specific evaluation:
/research-review "Complete [GRANT_TYPE] [GRANT_SUBTYPE] proposal draft. Evaluate as a [GRANT_TYPE] review panelist using official criteria. [PASTE FULL PROPOSAL TEXT]"
What this does:
- Gemini acts as a grant review panelist
- Scores each section 1-5 using agency-specific criteria
- Identifies fatal flaws and recommends funding/revisions/rejection
- Provides ranked action items for improvement
- All feedback saved to
grant-proposal/GRANT_REVIEW.md
⚠️ External review fallback: If gemini-review MCP is unavailable or Gemini credentials are missing, skip external review. Note "External review skipped — gemini-review unavailable." in GRANT_REVIEW.md. The proposal is still usable without external review.
If /research-review is invoked (preferred), it handles the external review internally. If you run the reviewer directly, use mcp__gemini-review__review_start for Round 1 and mcp__gemini-review__review_reply_start for follow-up rounds.
Round 1 (full draft review):
mcp__gemini-review__review_start:
prompt: |
Review this complete [GRANT_TYPE] [GRANT_SUBTYPE] proposal draft.
Act as a [GRANT_TYPE] review panelist. Evaluate using the official criteria:
[INSERT GRANT-TYPE-SPECIFIC CRITERIA — see Grant Type Specifications above]
For each section:
1. Score 1-5 (5 = excellent)
2. Strongest aspect
3. Most critical weakness
4. Specific fix suggestion (actionable, not vague)
Overall assessment:
- Would you recommend funding? (Yes / Yes with revisions / No)
- Single most impactful change to improve funding chances?
- Any fatal flaws?
[PASTE FULL PROPOSAL TEXT]
After this start call, immediately save the returned jobId and poll mcp__gemini-review__review_status with a bounded waitSeconds until done=true. Treat the completed status payload's response as the review output, and save the completed threadId in GRANT_STATE.json if you want to continue the same dialogue in Round 2.
Round 2+ (after revisions):
If MAX_REVIEW_ROUNDS > 1 and revisions were applied:
mcp__gemini-review__review_reply_start:
threadId: [saved completed threadId from Round 1]
prompt: |
[Round N review of revised [GRANT_TYPE] [GRANT_SUBTYPE] proposal]
Since your last review, I have applied the following changes:
1. [Change 1]: [what was done]
2. [Change 2]: [what was done]
3. [Change 3]: [what was done]
Please re-evaluate. Same format: section scores, overall assessment, remaining weaknesses.
Focus on whether the CRITICAL and MAJOR issues from Round 1 have been adequately addressed.
[PASTE REVISED PROPOSAL TEXT]
After this start call, immediately save the returned jobId and poll mcp__gemini-review__review_status with a bounded waitSeconds until done=true. Treat the completed status payload's response as the updated review output.
Phase 5: Revision & Output
5.1 Apply Reviewer Feedback
Parse reviewer feedback into severity levels:
- CRITICAL — fatal flaws that would lead to rejection. Fix immediately.
- MAJOR — significant weaknesses. Fix before submission.
- MINOR — suggestions for improvement. Fix if time allows.
Implement CRITICAL and MAJOR fixes. If MAX_REVIEW_ROUNDS > 1, re-submit for another round via send_input.
5.2 Generate Output
Markdown output (default):
grant-proposal/
├── GRANT_PROPOSAL.md # Complete proposal, all sections
├── GRANT_REVIEW.md # Review history and reviewer feedback
├── GRANT_STATE.json # State persistence file
├── figures/ # Generated diagrams (if any)
└── references.bib # Bibliography (if citations were used)
LaTeX output (when OUTPUT_FORMAT = latex):
grant-proposal/
├── main.tex # Master file
├── sections/
│ ├── aims.tex # Specific Aims / Research Objective
│ ├── background.tex # Background / Significance
│ ├── research_plan.tex # Research Plan / Methods
│ ├── timeline.tex # Timeline & Milestones
│ ├── pi_qualification.tex # PI Qualification / Track Record
│ └── budget.tex # Budget Justification (if applicable)
├── references.bib
└── figures/ # Any generated diagrams
5.3 Final Checks
Before declaring done:
🚦 Final Checkpoint: Present the completed proposal summary:
📝 Grant proposal draft complete:
- Type: [GRANT_TYPE] [GRANT_SUBTYPE]
- Language: [language]
- Aims: [N] aims covering [summary]
- Timeline: [N] years
- Review score: [summary from Gemini]
- Output: grant-proposal/GRANT_PROPOSAL.md
Files saved to grant-proposal/. Please review and customize:
1. PI qualification section (add your publications and track record)
2. Budget amounts (replace [AMOUNT] placeholders)
3. Any [TODO] markers for personal information
What would you like to do next?
- "figures" → generate proposal diagrams
- "review again" → run another round of external review
- "latex" → convert to LaTeX format
- "done" → finalize
Output Protocols
Follow these shared protocols for all output files:
Key Rules
-
Large file handling: If the Write tool fails due to file size, immediately retry using Bash (cat << 'EOF' > file) to write in chunks. Do NOT ask the user for permission — just do it silently.
-
Do NOT fabricate budget amounts. Generate narrative budget justification only. Leave specific dollar/yen/yuan/euro amounts as [AMOUNT] placeholders for the user to fill in.
-
Do NOT fabricate PI information. If no publication list is available, leave [TODO: Add publications] placeholders. Never invent papers, grants, or credentials.
-
Do NOT hallucinate citations. Use references from literature survey. Mark uncertain citations with [VERIFY].
-
Grant ≠ paper. A grant argues for future work (feasibility + potential). A paper argues for completed work (results + claims). Write accordingly — emphasize "what we will do" and "why it will work", not "what we found."
-
Aims must be independently valuable. If Aim 2 fails, Aim 1 and Aim 3 should still produce publishable results.
-
Preliminary data de-risks. Include any pilot results, existing datasets, or prior publications that demonstrate feasibility.
-
Reviewer-facing structure. Bold key sentences. Use numbered lists for clarity. Make the reviewer's job easy.
-
Cultural norms matter. KAKENHI expects 社会的意義; NSF expects Broader Impacts; NSFC expects 国际前沿 positioning. Missing these is a red flag for reviewers.
-
Feishu notifications are optional. If ~/.codex/feishu.json exists, send checkpoint at each phase transition and pipeline_done at final output. If absent, skip silently.
Parameter Pass-Through
Parameters can be passed inline with — separator. They flow to sub-skills when invoked:
/grant-proposal "topic — KAKENHI Start-up, sources: zotero, arxiv download: true"
| Parameter | Default | Description | Passed to |
|---|
grant type | KAKENHI | Agency (KAKENHI/NSF/NSFC/ERC/DFG/SNSF/ARC/NWO/GENERIC) | — |
grant subtype | auto | Sub-type (Start-up/Wakate/CAREER/Youth/etc.) | — |
output format | markdown | markdown or latex | — |
language | auto | Output language override | — |
max review rounds | 2 | External review cycles | — |
sources | all | Literature sources | → /research-lit |
arxiv download | false | Download arXiv PDFs | → /research-lit |
reviewer model | gemini-review | Gemini reviewer bridge | → reviewer thread |
auto proceed | false | Skip checkpoints | — |
Composing with Other Skills
Sub-skills used by this skill
| Sub-skill | Phase | Purpose |
|---|
/research-lit | 1 | Literature survey (if not already done) |
/novelty-check | 1 | Verify the gap is real |
/research-review | 2, 4 | Structural review + full draft review |
/paper-illustration | 3 | Generate proposal figures (optional) |
Funding Track (this skill's primary use case)
/idea-discovery "direction" ← Workflow 1: find validated ideas
/research-refine "idea" ← sharpen the method
/grant-proposal "idea — KAKENHI" ← this skill: write the grant proposal
← [submit & get funded]
/experiment-bridge ← implement experiments with funding
/auto-review-loop "results" ← Workflow 2: iterate until submission-ready
/paper-writing ← Workflow 3: write the paper
Publish Track (skip this skill)
/idea-discovery → /experiment-bridge → /auto-review-loop → /paper-writing → submit
