Agent skill

Documenting With Sources

by mathbullet in mathbullet/skills

Common conventions for writing Markdown documents that cite external sources (survey reports, paper explainers, and any deliverable that surfaces facts from outside).

MITAuto-check passedResearch & Science

Install Documenting With Sources

skills CLI
$ npx skills add mathbullet/skills --skill documenting-with-sources -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mathbullet/skills documenting-with-sources --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mathbullet/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/documenting-with-sources/skills/documenting-with-sources .claude/skills/documenting-with-sources && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
documenting-with-sources
GitHub stars
173
Token cost
~781 tokens
SKILL.md length
386 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Common conventions for writing Markdown documents that cite external sources (survey reports, paper explainers, and any deliverable that surfaces facts from outside).

  • Tasks that involve Literature review
  • SKILL.md covers Cite every factual claim, Reference format, Quotation vs prose and No fabricated associations or…, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Citation management

What it does

Documenting With Sources is an agent skill from mathbullet/skills. 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, paper-details, and any skill that produces sourced output.

Its SKILL.md is about 780 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science, covering Literature review and Citation management. The repository describes itself as: mathbullet Agent Skills. The licence is MIT.

When your agent uses it

  • Tasks that involve Literature review
  • Tasks that involve Citation management

Example prompts

  • “/documenting-with-sources”

What it can do on your machine

Read from SKILL.md and the folder at commit 5ab997f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Documenting With Sources loads about 781 tokens when it runs. Until then it costs about 106 tokens; SKILL.md has 386 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~106
When it runs · the whole SKILL.md, loaded when a task matches
~781

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mathbullet/skills at commit 5ab997f, republished under its MIT licence (© mathbullet). 386 words, ~781 tokens.

Download SKILL.mdSave it as .claude/skills/documenting-with-sources/SKILL.md (or your agent's skills folder).
name
documenting-with-sources
description
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, paper-details, and any skill that produces sourced output.

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.
  • When quoting a source written in a language other than the writer's working language, place the translation alongside the original inside the same code block (see writing-quotation).
Show full SKILL.md (157 more words)Show less

No fabricated associations or interpretations

Do not write interpretations, speculation, or associations that the source itself does not contain.

  • Do not invent connections such as "this relates to X", "this could be applied to Y", or "this suggests Z" when the source does not say so.
  • Do not import context from the surrounding conversation or the calling project into the body of the document. Descriptions of a source must stay within the source's own content.
  • Good: "Main criticism: even with flipped labels, accuracy does not always drop, and the text-gradient is mathematically distinct from classical gradient descent" (states what the source actually says).
  • Bad: "Relation to AI writing improvement: feedback-based improvement is mathematically different from gradient descent..." (the source does not say this; the connection is fabricated from conversation context).

Source-list format

The source list at the end of the document uses this format:

[label, YYYY/MM] Author. "Title." Publication. URL

Do not use the - [n] list format.

© mathbullet, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/documenting-with-sources/skills/documenting-with-sources of mathbullet/skills.

Open the folder on GitHubat commit 5ab997f

Compare with similar skills

Documenting With Sources next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Documenting With Sources compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Documenting With Sources this skillmathbullet/skills173—~781Automated safety check: PassMIT
Systematic Review ScreenerImbad0202/academic-research-skills51k—~8.4kAutomated safety check: PassCustom licence
Literature Reviewneflibata-feng/MyArxiv-Agent12621 repos~5.9kAutomated safety check: NotesMIT
Preprint Search on bioRxivLigphiDonk/Oh-my--paper73813 repos~3.7kAutomated safety check: PassMIT
Academic Paper Writing PipelineImbad0202/academic-research-skills51k—~16kAutomated safety check: PassCustom licence
Paper Research on arXivXiaomiMiMo/MiMo-Code14k1 repos~1.5kAutomated safety check: PassMIT

Similar skills

  • Systematic Review Screener

    Imbad0202/academic-research-skills

    Screens records for systematic, scoping and rapid reviews against fixed eligibility rules, using two blinded AI reviewers and a third adjudicator, with traceable PRISMA counts.

    51k GitHub stars~8.4k tokensUpdated 4 days ago
    Research & ScienceAuto-check passed
  • Literature Review

    neflibata-feng/MyArxiv-Agent

    Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.).

    126 GitHub starsUsed in 21 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Preprint Search on bioRxiv

    LigphiDonk/Oh-my--paper

    Searches bioRxiv life sciences preprints by keyword, author, date range or category with a Python script, returning JSON metadata and optional PDF downloads.

    738 GitHub starsUsed in 13 repos~3.7k tokens
    Research & ScienceAuto-check passed
  • Academic Paper Writing Pipeline

    Imbad0202/academic-research-skills

    Runs a 12-agent pipeline that plans, drafts, cites, reviews and formats academic papers, with modes for revision, rebuttals, abstracts and citation checks.

    51k GitHub stars~16k tokensUpdated 4 days ago
    Research & ScienceAuto-check passed
  • Paper Research on arXiv

    XiaomiMiMo/MiMo-Code

    Searches arXiv, fetches metadata, generates BibTeX, downloads PDFs and finds citations and related papers using a bundled Python script.

    14k GitHub starsUsed in 1 repo~1.5k tokens
    Research & ScienceAuto-check passed
  • Deep Research Workflow

    TokenRhythm/opensquilla

    Runs multi-round research in three stages with a persisted state file, evidence tracking and a long-form report with per-claim citations.

    7.1k GitHub stars~1.3k tokensUpdated 3 days ago
    Research & ScienceAuto-check passed

More from mathbullet/skills

All 8 skills in this repo
  • Paper Details

    mathbullet/skills

    Produce a detailed Markdown explainer of an academic paper. An agent skill from mathbullet/skills.

    173 GitHub stars~3.6k tokensUpdated 28 days ago
    Auto-check passed
  • Survey

    mathbullet/skills

    Investigate a topic across papers, articles, social-media posts, and industry signals, then deliver an indexed Markdown report.

    173 GitHub stars~1.7k tokensUpdated 28 days ago
    Auto-check passed
  • Grilling Viz

    mathbullet/skills

    grilling による質問を、選択肢と自由入力でまとめて回答し、コピーできるHTMLにする. An agent skill from mathbullet/skills.

    173 GitHub stars~310 tokensUpdated 28 days ago
    Auto-check passed
  • Explain

    mathbullet/skills

    Conventions for writing a Markdown explainer that walks the reader through a concept or system.

    173 GitHub stars~659 tokensUpdated 28 days ago
    Auto-check passed
  • HTML

    mathbullet/skills

    概念・仕組み・調査内容を、HTML による視覚的な説明ドキュメントとして作成・編集する. An agent skill from mathbullet/skills.

    173 GitHub stars~905 tokensUpdated 28 days ago
    Auto-check passed
  • Writing Quotation

    mathbullet/skills

    Formatting rules for quoting external sources (papers, articles, web pages, prompt templates) inside a Markdown document.

    173 GitHub stars~1.7k tokensUpdated 28 days ago
    Auto-check passed

Questions about Documenting With Sources

What does Documenting With Sources do?

Common conventions for writing Markdown documents that cite external sources (survey reports, paper explainers, and any deliverable that surfaces facts from outside). Documenting With Sources is an agent skill from mathbullet/skills. Common conventions for writing Markdown documents that cite external sources (survey reports, paper explainers, and any deliverable that surfaces facts from outside).

When should I use Documenting With Sources?

Documenting With Sources fits situations like: tasks that involve Literature review; tasks that involve Citation management.

How do I install Documenting With Sources in Claude Code?

Run `npx skills add mathbullet/skills --skill documenting-with-sources -a claude-code`. Or copy the skill folder (plugins/documenting-with-sources/skills/documenting-with-sources in mathbullet/skills) into .claude/skills/documenting-with-sources in your project. Claude Code loads it when a task matches its description.

How do I install Documenting With Sources in Codex?

Run `npx skills add mathbullet/skills --skill documenting-with-sources -a codex`. Or copy the skill folder (plugins/documenting-with-sources/skills/documenting-with-sources in mathbullet/skills) into .agents/skills/documenting-with-sources in your project. Codex loads it when a task matches its description.

Can I use Documenting With Sources in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mathbullet/skills --skill documenting-with-sources -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/documenting-with-sources, .gemini/skills/documenting-with-sources, .github/skills/documenting-with-sources and .opencode/skills/documenting-with-sources in your project.

What does Documenting With Sources need to run?

SKILL.md names no scripts, command-line tools or credentials: Documenting With Sources is instructions for the agent only.

Does Documenting With Sources access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Documenting With Sources safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Documenting With Sources use?

Documenting With Sources is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Documenting With Sources use?

About 781 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Documenting With Sources?

Skills that share tags, products or a category with Documenting With Sources: Systematic Review Screener (Imbad0202/academic-research-skills, 51k stars), Literature Review (neflibata-feng/MyArxiv-Agent, 126 stars), Preprint Search on bioRxiv (LigphiDonk/Oh-my--paper, 738 stars) and Academic Paper Writing Pipeline (Imbad0202/academic-research-skills, 51k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Documenting With Sources?

mathbullet (a GitHub user) maintains it in mathbullet/skills, which has 173 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on September 9, 2026.

Source: mathbullet/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.