research-idea-format

Format a research idea file to follow the standard template

SKILL.md

GitHub

Goal

  • Given a file <FILE> with raw information about a research idea, apply the research idea template and write the result back into <FILE>

Workflow

Read the Inputs

  • Read <FILE>
  • Read the template .claude/templates/research_idea.template.md
  • Read # Examples in .claude/skills/research_idea.rules.md for a worked example

Apply the Template

  • Map the content of <FILE> onto the template sections (Status, Core Idea, Formalization, Key Examples, Questions, Research Topics, Next steps, Implementation plan, References)
  • Remove or fill every template placeholder bullet. Fill from the idea's own content
  • Do not invent facts, results, or citations. Write only what follows from the idea (e.g., mark a hypothetical example as illustrative)
  • Do not add an Assignee field. Assignees live only in the README table
  • Write references as Author(s), _Title_. (Year)
  • Replace the previous content of <FILE> with the result

Conventions

  • Follow .claude/skills/research_idea.rules.md

Constraints

  • Keep the file name and its status prefix. Formatting does not change status
  • Fit text in 85 character lines, per .claude/skills/research_idea.rules.md

Examples

  • research/ideas/in_progress.RL_for_pickleball.md

Verification

  • <FILE> follows the section order of .claude/templates/research_idea.template.md
  • No template placeholder text is left in the file
  • No fabricated facts or citations were added
  • No Assignee line; references use Author(s), _Title_. (Year)
  • Lines fit in 85 characters