mcpField
S
skill-source-citations

skill-source-citations

github.com/arenukvernAgent workflows39444 installsUpdated 2w ago
Repository

About skill-source-citations

A Skill Steward guide for recording research and documentation sources used when creating or revising skills. It helps skill authors and reviewers keep source links in each skill’s references rather than only in conversation.

Key features

  1. 01Per-skill sources.md records
  2. 02Source links before and after research
  3. 03Inline links for non-obvious claims
  4. 04PR source-update reminder
  5. 05Citation scope guidance

Use cases

  1. 01Document references while authoring a skill
  2. 02Review procedural claims in a PR
  3. 03Preserve research links across conversations

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/arenukvern/mcp_flutter --skill skill-source-citations

After installing, type/skill-source-citationsin Claude Code to confirm it loaded.

Bundled filesreferences/citation-template.mdreferences/sources.md

Details

From the project README

Skill source citations

Rule: Knowledge borrowed from docs, papers, other repos, or chat research must be saved as links in the skill tree—not only in conversation.

When to use

  • Creating or editing any skills/{name}/SKILL.md
  • Researching harness/MCP/marketplace patterns before writing a skill
  • Reviewing a PR that adds procedural claims without sources

Per-skill file (required in skill_steward)

Maintain skills/{name}/references/sources.md:

# Sources

| Topic | URL | Used for |
|-------|-----|----------|
| Agent Skills spec | https://agentskills.io/ | Frontmatter rules |
| … | … | … |

## Changelog

- 2026-05-29: initial citations

Template: citation-template.md.

Workflow (create or update skill)

  1. Before writing — list URLs you will rely on in references/sources.md (can start sparse).
  2. In SKILL.md — link to spec/docs inline where non-obvious; prefer references/ for long material.
  3. After research — append new rows + changelog entry; never leave “we read X” only in chat.
  4. In PR — one line in description: “Sources updated in references/sources.md.”
  5. Validate — pnpm run validate warns if sources.md is missing.

What to cite

CiteExample
Official specsagentskills.io, Cursor/Claude/Codex docs
Papers / researchSkillOpt, SkillsBench arXiv
Reference implementationsproduct MCPs, Codex plugin-eval
Blog/guidesOnly if procedure is non-obvious; prefer primary docs

Do not cite ephemeral chat URLs or private tokens.

Cross-skill index

Guild-wide references: docs/STANDARDS.mdx, DESIGN_FAQ.mdx.

Related skills

TaskSkill
Scaffold skillskill-authoring-lifecycle
Evaluate / improveskill-eval-improve
Spec auditskill-authoring-lifecycle

Sources discipline (this skill)

See references/sources.md.

Install

npx skills add arenukvern/skill_steward --skill skill-source-citations

Comments

Markdown supported