reference-source-author

reference-source-author is a skill for Claude Code, Codex from Chael-Chael/dsh-reference-anything. It costs 85 tokens per session (2,084 once invoked), scanned A, original, MIT.

A plugin-building guide for adding a new source to Reference Anything, so users can mention items from places such as files, websites, APIs, databases, or other plugins. The source lets the model list, search, and read those items through the existing reference system.

In plain words
What is it for?
Use it to create a DSH plugin that connects Reference Anything to a chosen data source and exposes its items for model reading.
Why use it?
It removes the need to build a separate tool for every new place the user wants the model to access. It also gives the source a selectable @ menu entry when that is appropriate.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to create a DSH plugin that connects Reference Anything to a chosen data source and exposes its items for model reading.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/chael-chael/dsh-reference-anything/reference-source-author
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Chael-Chael/dsh-reference-anything --skill reference-source-author
Clone the repo
git clone --depth 1 https://github.com/Chael-Chael/dsh-reference-anything

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for reference-source-author

README.md
[![agentmods](https://agentmods.dev/badge/skills/chael-chael/dsh-reference-anything/reference-source-author/github.svg)](https://agentmods.dev/skills/chael-chael/dsh-reference-anything/reference-source-author)
Your own site
<a href="https://agentmods.dev/skills/chael-chael/dsh-reference-anything/reference-source-author"><img src="https://agentmods.dev/badge/skills/chael-chael/dsh-reference-anything/reference-source-author/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for reference-source-author

Your own site · 80×15
<a href="https://agentmods.dev/skills/chael-chael/dsh-reference-anything/reference-source-author"><img src="https://agentmods.dev/badge/skills/chael-chael/dsh-reference-anything/reference-source-author.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 85 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,084 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00085 $0.02084
Opus 5.5 $0.00034 $0.00834
Sonnet 5.5 $0.00017 $0.00417
Haiku 4.5 $0.00009 $0.00208

Measured yesterday against content hash 106bb745f175, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

reference-source-author scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- Optional children: `children: [{ key, title, kind: 'image' | 'file' | 'text', item? }]` plus `fetch(id, child, maxBytes)` returning bytes; the core saves the file (cap from `files.maxBytes`) and adds pixels for images
skills/reference-source-author/SKILL.md · 115 lines

How it starts

The opening of the file, as written. The whole thing — 115 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Write a Reference Anything source

The user describes what they want to @. You deliver a working DSH plugin in their profile that:

  1. registers a Host source plugin the model reaches through the single reference tool (list, search, read; images and files are children read with as: "image" or as: "file"). With defineReferenceSource you write only load and usually list; you write no tools, and
  2. usually adds an @ menu group so the user can pick items in the input box.

There is no fixed list of allowed sources. Read what the user asked for, from wherever it lives: another installed plugin's services, Remotes or browser components, a web page or API, files, a database, a command's output. Build exactly that.

Environment

  • DSH profile: {{profileName}}, directory {{profileDir}}
  • DSH version: {{dshVersion}} (use it for every @deepseek-ai/* package you install)
  • Reference Anything version: {{raVersion}}
  • Reference Anything package directory: {{raDir}} (its lib/reference-source.d.ts and lib/sdk.d.ts are the authoritative types)

1. Pin down the source

Settle these before writing code. Ask the user only about what you cannot work out yourself, in one short message:

  • Items: what one item is, its stable id (must survive restarts without a lookup table; never a credential, a user name or an absolute path; never a path the user could escape with ..), and its title.
  • Origin: where the list and the body come from, and whether reading needs network, a login or a running process.
  • Reading: what load returns: the whole object as records (text blocks, chat turns, rows; oldest first), plus children such as attachments.
  • Menu: whether the user wants an @ group (default yes) and a shortcut prefix such as note:.

To reuse another plugin, find its package under {{profileDir}}/node_modules and read its package.json exports and lib/**/*.d.ts. Host services are reached with inject: ['theirService'] and ctx.theirService. Browser services are reached with ctx.reflect.get('remote.<service>') or the client service they register.

Read the full file on GitHub · 115 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 115 lines · 85 tokens per session scan A 106bb745f175

Subscribe to this mod's changes

reference-source-author is a skill published in the GitHub repository Chael-Chael/dsh-reference-anything (27 stars, last pushed 2d ago), licensed MIT. It adds 85 tokens to every session and 2,084 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-11-15.

Related

reference-source-author compared with skills from other repositories

reference-source-author next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
reference-source-authorChael-Chael/dsh-reference-anythingSkill272d agoMITA85Claude Code, Codex
rea-changelog-updatemorluto/reaSkill462ktodayMITA33Claude Code
feynman-perspectivealchaincyf/nuwa-skillSkill38kyesterdayMITA212Claude Code, Codex
x-mastery-mentoralchaincyf/nuwa-skillSkill38kyesterdayMITA197Claude Code, Codex
elon-musk-perspectivealchaincyf/nuwa-skillSkill38kyesterdayMITA228Claude Code, Codex
ilya-sutskever-perspectivealchaincyf/nuwa-skillSkill38kyesterdayMITA183Claude Code, Codex
novel-reviewerLiPu-jpg/OpenwriteSkill960yesterdayApache-2.0A49Claude Code, Codex