Paper Details

Conventions for producing a detailed Markdown explainer of an academic paper. The aim of this skill is to describe the paper accurately, not to critique it.

This skill follows the shared sourced-writing conventions defined in documenting-with-sources. Read documenting-with-sources before drafting.

1. Deliverable structure

1.0 Output location

Write the explainer as a .md file under the project's reports/ directory, where "the project" is the root that contains the source paper PDF. Create the directory if it does not exist.

• Path: {project-root}/reports/{paper-filename-base}.md
• Example: if the PDF is at /path/to/project/papers/foo.pdf, the output is /path/to/project/reports/foo.md

Do not write next to the PDF, and do not write at the project root. Do not ask the user for the output path — determine it mechanically by the rule above.

1.1 Opening