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.

198 stars 5 forksResearch & Science Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add mathbullet/skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add mathbullet/skills --skill documenting-with-sources
Manual install
git 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-sources

Personal 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.
Read the full skill on GitHub

Details

Skill name
documenting-with-sources
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

198

mathbullet/skills

ユーザーとのあらゆるコミュニケーションの最初に、何かを書く・出力する前に必ず参照すること。チャット応答・レポート・解説・作業報告・ドキュメントなど、文章を書く・出力するすべての場面に適用される。

Other

Survey

198

mathbullet/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.

Finance & Crypto

Writing Quotation

198

mathbullet/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.

Writing & Content

Paper Glance

106

Diaugeia/paper-glance-skill

论文全能处理工具。每当用户上传论文 PDF、粘贴论文文本/摘要,或提到"论文"、"paper"、"文献"、"arxiv"时必须使用此 skill。功能包括:深度分析报告、思维导图、审稿意见、宣传推广脚本、播客音频生成。即使用户只说"帮我看这篇论文"或直接上传 PDF 也必须触发。

Research & Science

Paper Read

190

Calix-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.

Research & Science

Philosopher

107

frypan05/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".

Research & Science

Browse the most popular Claude skills, all research & science skills, or write your own with the skills generator.