Skip to content

Latest commit

 

History

16 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Dr. Joe

Dr. Joe is a cross-runtime skill for rigorous, evidence-based evaluation of non-thesis academic coursework. It is a simulated marker, not a real professor or institutional service.

Runtime layout

The canonical repository used by Codex is:

C:\Users\Piero\.agents\skills\dr-joe

Claude uses a junction at:

C:\Users\Piero\.claude\skills\dr-joe

The Claude junction must target the canonical Codex repository. Maintain one source of truth; do not clone or edit a separate Claude copy.

To install the canonical repository and create the junction on Windows:

git clone https://github.com/PieroJF/dr-joe.git 'C:\Users\Piero\.agents\skills\dr-joe'
New-Item -ItemType Junction -Path 'C:\Users\Piero\.claude\skills\dr-joe' -Target 'C:\Users\Piero\.agents\skills\dr-joe'

Scope and thesis boundary

Dr. Joe activates implicitly for coursework such as essays, reports, literature reviews, lab reports, and engineering design reports. It does not activate implicitly for a thesis or dissertation. Use Dr. Pavlov for thesis or dissertation support.

When the user explicitly names Dr. Joe, it may perform a bounded rubric review of a thesis or dissertation using supplied criteria, while making clear that it is a simulated coursework-style evaluation.

Inputs and modes

Provide the document, then the assignment brief, then the official rubric. Dr. Joe requests missing inputs one at a time. After the official rubric is confirmed unavailable, Dr. Joe offers the generic rubric as a fallback option. The user confirms that choice, and only then may Dr. Joe use the generic rubric.

Available modes are full evaluation, focused criterion review, quick feedback, and revision comparison. Marks come directly from rubric descriptors and documented evidence, with no fixed numeric adjustment.

Feedback identifies evidence and high-impact revision work without composing replacement paragraphs, arguments, calculations, citations, or other student-authored content.

Codex

Use the Codex skill invocation:

$dr-joe

Then provide the coursework and marking criteria.

Claude

Use the Claude skill invocation:

/dr-joe

Then provide the coursework and marking criteria.

Plain-language request

You may also name the skill explicitly in a request, for example:

Dr. Joe, evaluate this coursework against its marking criteria.

Reference structure

  • references/input-protocol.md — required inputs and confirmed fallback-rubric protocol.
  • references/report-modes.md — output contracts for the four modes.
  • references/generic-rubric.md — clearly labelled fallback criteria and uncertainty notice.
  • references/deliverable-guides.md — coursework-type-specific evaluation focus.

License

MIT — Piero Flores

About

Get the feedback your professor won't give you — while you can still fix it. A Claude Code skill for rigorous academic evaluation.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages