paper-sections
Skill0 starsChanged 6 months agoMITView on GitHub
Draft IMRAD paper sections (Introduction, Methods, Results, Discussion, Outlook) in the author's voice, using STYLE_PROFILE.md templates. Includes numeric-superscript citation format rules. Forked from scientific-writing. Use when writing or revising a specific section of a scientific manuscript, or when inserting citations. Triggers - paper draft, IMRAD, introduction draft, results 작성, discussion 섹션, 섹션 초안, manuscript section, citation format, 인용 포맷, bibliography, reference format, in-text cite, superscript citation.
In this repository15 other files it gives its agents.
- analysis-protocolSkill
- blender-atom-renderSkill
- corpus-phrase-checkSkill
- docx-scientific-formattingSkill
- html-minimalSkill
- layout-guardSkill
- matplotlib-scientificSkill
- paper-sentence-loopSkill
- paper-styleSkill
- reference-crosscheckSkill
- slide-auditSkill
- smart-compactSkill
- transcript2htmlSkill
- youtube2mp4Skill
- youtubeSkill
The file
We split this skill into the rules it gives an agent
11 rules. About 0 are common, 9 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈9
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 24
Every sentence passive. Zero first person.
- Distinctive: line 37
Consider bridge B3/B4 for multi-limitation synthesis, B5 for close.
- Very specific: line 40
Start with In summary, ...
- Distinctive: line 41
No hedging adverbs. No rhetorical close.
- Distinctive: line 53
No space between word and superscript.
- Distinctive: line 58
Never cite a review when a primary source exists for the specific claim.
- Distinctive: line 63
When target journal unknown, emit EndNote-style block:
- Distinctive: line 73
Never fabricate DOI, year, or author list.
- Distinctive: line 74
If any required metadata is missing, return FLAG with the missing field name.
- Distinctive: line 83
When inserting citations, use the format in section 7 above.
- Very specific: line 88
No banned word (STYLE_PROFILE 3.1) may appear.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
paper-sections
Fork of global scientific-writing skill, specialized to the author's voice via paper-style. Absorbs former paper-citation-format skill as section 7 below.
Dependencies
- Load
paper-styleMode 1 first. Use its output as hard constraint.
Section playbooks
Introduction (target: 3-5 paragraphs)
- Topic paragraph - field-level fact opener. Define acronyms parenthetically. Citation density 0.9-1.3 refs/sentence. See STYLE_PROFILE G1.
- Gap/motivation paragraph - quantitative gap statement, one subordinate clause. See STYLE_PROFILE G2. Consider bridge B1 (Paradox-Pivot) or B3 (Enumerated-Walls) sparingly.
- Solution/approach paragraph - solution announcement. See STYLE_PROFILE G3.
- Summary of contributions -
In this work, we ...with numbered contributions.
Methods (passive, purpose-forward)
- Every sentence passive. Zero first person.
- Order: materials -> synthesis -> characterization -> computational -> kinetic.
- Parameters in parentheses, not footnotes.
Results (passive + purpose opener)
- Each subsection opens with purpose sentence (see STYLE_PROFILE 4.2).
- Figures referenced parenthetically
(Fig. 2a). NEVERAs shown in Fig.. - One finding per paragraph. Close with mechanistic consequence.
Discussion (mixed voice, active for claims)
- Open with contribution statement + retrace (see G5).
wepermitted for active mechanistic claims.- Citation density drops to 0.2-0.4 refs/sentence.
- Consider bridge B3/B4 for multi-limitation synthesis, B5 for close.
Outlook / Conclusion
- Start with
In summary, ...orBy bridging ...(see STYLE_PROFILE 4.4). - No hedging adverbs. No rhetorical close.
7. Citation format (absorbed from paper-citation-format)
Default style
Numeric superscript, following Nature Commun / ACS Catal convention.
- Single:
text^1 - Range:
text^1-4 - List:
text^1,3,5 - Mixed:
text^1-3,7
No space between word and superscript. Superscripts attach to the concept, not the sentence terminator. Attach before punctuation when the cite scopes the clause, after punctuation when it scopes the sentence.
In-text cite rules (author voice via STYLE_PROFILE)
- Intro: ~1 cite per sentence. Clusters of
^1-4acceptable. - Discussion: cite only for specific comparative claims or contradictions to prior art. Mechanistic own-work statements stay uncited.
- Never cite a review when a primary source exists for the specific claim.
- Novelty claim requires contrast cite:
Unlike previous work that ...^12, here we ....
Bibliography entry format
When target journal unknown, emit EndNote-style block:
[N] Author, A. B.; Author, C. D. Title. Journal Year, Vol, Pages. DOI.If journal known:
- Nature Commun:
Author, A. B. et al. Title. Journal Vol, Pages (Year). - ACS:
Author, A. B.; Author, C. D. Title. Journal Year, Vol, Pages.
Citation hard rules
- Never fabricate DOI, year, or author list.
- If any required metadata is missing, return FLAG with the missing field name. Do not guess.
et al.only when author count > 3 in short form journals.
Workflow when invoked
- Receive args:
section_name, optionalsubsection_identifier, optionalexisting_text, optionaldata_pointers. - Load STYLE_PROFILE via
paper-styleMode 1. - Gather minimal context: read only the referenced data files. Do not load the whole manuscript.
- Draft paragraph(s) following the section playbook above.
- When inserting citations, use the format in section 7 above.
- Self-check against STYLE_PROFILE section 12 quick checklist before returning.
- Return: draft text + list of gaps/assumptions + suggested next command.
Hard rules
- No banned word (STYLE_PROFILE 3.1) may appear.
- Sentence length: 16-22 words mean, 30 word max.
- One subordinate clause per sentence max.
- Active/passive ratio matches section norm.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

