Documenting with Sources
Common conventions for writing Markdown documents that cite external sources (survey reports, paper explainers, and any deliverable that surfaces facts from outside). Defines mandatory citation, in-text reference format, quotation-versus-prose separation, the ban on fabricated associations, and the source-list format. Referenced by survey, ja-explainer, and any skill that produces sourced output.
Install
/plugin marketplace add mathbullet/skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add mathbullet/skills --skill documenting-with-sourcesgit clone --depth 1 https://github.com/mathbullet/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/plugins/documenting-with-sources/skills/documenting-with-sources ~/.claude/skills/documenting-with-sourcesPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Documenting with Sources Common conventions for writing Markdown documents that pull from outside sources. Apply to any deliverable that surfaces facts taken from elsewhere — survey reports, paper explainers, and similar. ## Cite every factual claim Every factual claim in the deliverable must carry a citation. A claim with no citation cannot be verified, and is worthless as a documented finding. If a claim cannot be tied to a source, mark it explicitly (e.g. "citation not confirmed"). Do not slip uncited claims in silently. ## Reference format - In-text references take the shape `[label (YYYY/MM), location]`. How to fill the `label` slot (publication name, author short-form, position-only for the paper under review, etc.) is decided by the calling skill. - Do not use bare numeric references such as `[1]` or `[2]`. Numbers alone force the reader to bounce between text and source list; readability drops. - For the formatting of quotation blocks themselves (code-block fencing, original-and-translation pairing, where to place the source reference, anti-patterns), follow the `writing-quotation` skill. Read `writing-quotation` before drafting. ## Quotation vs prose - Keep quotations and prose (the writer's own summary or interpretation) visually and structurally separate. Even when not quoting, write in a way that prevents the source's claim and the writer's interpretation from blending.
Details
- Skill name
documenting-with-sources- Repository
- mathbullet/skills
- Path
plugins/documenting-with-sources/skills/documenting-with-sources/SKILL.md- License
- MIT
- Repo updated
- 11 November 2026
FAQ
What does the Documenting with Sources skill do?
Common conventions for writing Markdown documents that cite external sources (survey reports, paper explainers, and any deliverable that surfaces facts from outside). Defines mandatory citation, in-text reference format, quotation-versus-prose separation, the ban on fabricated associations, and the source-list format. Referenced by survey, ja-explainer, and any skill that produces sourced output.
How do I install the Documenting with Sources skill?
Claude Code plugin: /plugin marketplace add mathbullet/skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Documenting with Sources popular?
It lives in mathbullet/skills, which has 198 GitHub stars and 5 forks.
Related skills
Ja Text Communication
198mathbullet/skills
ユーザーとのあらゆるコミュニケーションの最初に、何かを書く・出力する前に必ず参照すること。チャット応答・レポート・解説・作業報告・ドキュメントなど、文章を書く・出力するすべての場面に適用される。
Survey
198mathbullet/skills
Investigate a topic across papers, articles, social-media posts, and industry signals, then deliver an indexed Markdown report. Use when the user asks to investigate, survey, gather sources, build an index, collect evidence, round up references, or otherwise wants a thorough cross-source roundup on a specific topic.
Writing Quotation
198mathbullet/skills
Formatting rules for quoting external sources (papers, articles, web pages, prompt templates) inside a Markdown document. Quotations always live in fenced code blocks (never the `>` blockquote syntax), original and translation sit together, source references go on the line after the fence, and bare numeric references like `[1]` are forbidden. Other sourced-writing skills (survey, ja-explainer, ...) reference this skill. Consult whenever you write or edit a quotation block.
Paper Glance
106Diaugeia/paper-glance-skill
论文全能处理工具。每当用户上传论文 PDF、粘贴论文文本/摘要,或提到"论文"、"paper"、"文献"、"arxiv"时必须使用此 skill。功能包括:深度分析报告、思维导图、审稿意见、宣传推广脚本、播客音频生成。即使用户只说"帮我看这篇论文"或直接上传 PDF 也必须触发。
Paper Read
190Calix-L/awesome-latex-skills
Summarize and critically analyze academic papers supplied as PDFs, text, arXiv links, or journal URLs. Ground claims in the inspected version and source locations; support focused questions, deeper appraisal, and cross-paper comparison.
Philosopher
107frypan05/philosopher-OKF
Turns any topic or question into one self-contained, white, research-paper-style HTML study page with diagrams drawn in HTML/CSS, a concept map, and linked references. Use this whenever the user wants to learn, understand, study, revise, or have something explained, in any field (technology, engineering, medicine, science, maths, finance, economics, business, law, humanities, social science, or a specific research paper), at any level from school student to PhD, even if they never say "HTML" or "page".
Browse the most popular Claude skills, all research & science skills, or write your own with the skills generator.