A set of instructions for adding a parser for session logs from another coding tool. A parser turns log files into Decant's common session format and records malformed or unknown entries as issues.

Use it when adding a new tool under the source parsers, changing how session records are interpreted, or updating discovery rules and parser tests.

It provides a safe way to handle new log formats without exposing real private transcripts. It also keeps discovery, file watching, test fixtures, and parser behavior consistent.

How dosu-ai/decant configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to dosu-ai/decant. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/dosu-ai/decant/main/.claude/skills/add-source/SKILL.md

Clone the repo

git clone --depth 1 https://github.com/dosu-ai/decant

Made for: Claude Code.

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.

README.md

[![agentmods](https://agentmods.dev/badge/skills/dosu-ai/decant/add-source/github.svg)](https://agentmods.dev/skills/dosu-ai/decant/add-source)

Your own site

<a href="https://agentmods.dev/skills/dosu-ai/decant/add-source"><img src="https://agentmods.dev/badge/skills/dosu-ai/decant/add-source/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.

Your own site · 80×15

<a href="https://agentmods.dev/skills/dosu-ai/decant/add-source"><img src="https://agentmods.dev/badge/skills/dosu-ai/decant/add-source.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 54 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 531 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. 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.

Model	Per session	Once invoked
Fable 5.1	$0.00054	$0.00531
Opus 5.5	$0.00022	$0.00212
Sonnet 5.5	$0.00011	$0.00106
Haiku 4.5	$0.00005	$0.00053

Measured 28d ago against content hash 15122c0cc2c4, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

add-source scanned grade A with 0 findings 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 28d ago.

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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/add-source/SKILL.md · 47 lines

What it actually says

Add a source parser

The checklist lives in docs/adding-a-source.md. Read it in full before editing; this skill only lists the steps that are easy to miss.

Privacy first

Never print, quote, or commit transcript content from ~/.claude, ~/.codex, or any other real session store. Inspect record shapes with aggregate counts only (types, key sets, value types).
Every fixture under fixtures/<tool>/ is hand-written with invented content. An edited real transcript is not synthetic.

Touchpoints

discover() in src/ingest.ts (where files live, which sidecars to skip) plus a source-directory env override documented in README.md.
src/sources/<tool>.ts: pure and print-free, returns a ParsedSession, turns malformed lines into unparsed_line issues and unknown record types into one unknown_record_type issue per type, calls linkageIssues. Reuse the JSONL line parser, unknown-type issue builders and block factory in src/sources/shared.ts.
The tool ID in TOOLS in src/model.ts (persisted; choose it once).
watchDirs() in src/watch.ts.
The capability report from the doc, filled in for the pull request.

Tests and goldens

Parser tests in test/<tool>.test.ts, ingest coverage in test/ingest.test.ts, fixture paths in test/golden/meta.json, and the fixture directory in both stagers (scripts/regen-goldens.ts and test/cli-golden.test.ts).
Regenerate goldens only after focused tests pass, then read the whole diff: bun run scripts/regen-goldens.ts --i-reviewed-the-diff. A golden change in an existing source is a regression until explained.

Done

bun test, bunx tsc --noEmit, and bunx biome check . pass, then just check. Use DECANT_DB=<scratch> ... --no-sync for manual runs so the real archive is never touched.

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.

28d ago First seen · 47 lines · 54 tokens per session scan A 15122c0cc2c4

Subscribe to this mod's changes

add-source is a skill published in the GitHub repository dosu-ai/decant (72 stars, last pushed today), licensed Apache-2.0. It adds 54 tokens to every session and 531 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-30.

Building agents Claude Code agent-observability cli codex coding-agents developer-tools

brain-setup

Bootstrap the Open Project Brain Standard into the current project — prefer brain init (ensure BRAIN.md, scaffold empty brain brainRoot-aware, default-wire CLAUDE.md + AGENTS.md). Optionally install a pre-commit hook and a Claude Code or Codex SessionStart hook.

mindmuxai/brain.md · 63 tokens

brain-ingest

The process for digesting a conversation, document, or research result, classifying it, and writing it down as brain content (a root-page update or a new/updated page) through the brain CLI.

mindmuxai/brain.md · 48 tokens

frontend-design

Aesthetic direction for OrkasVideoStudio HTML and motion-graphics compositions. Use before stage-compose writes composition-manifest.json artdirection and index.html to choose a subject-specific visual point of view, type, palette, layout signature, restrained motion, and anti-template checks.

Orkas-AI/Orkas-VideoStudio · 57 tokens

gate-control

Canonical VideoStudio review authorization and state-transition policy. Use after any Gate B/C/Preview/D decision, post-gate revision, resumed approval, or exhausted visual-QA result across COMPOSE/AUTO/GENERATE/EDIT; maps explicit user authority and durable artifact state to one next action with ovs gate transition.…

Orkas-AI/Orkas-VideoStudio · 81 tokens

stage-edit

Intelligent editing of real user-supplied footage—understand it with transcript/inspected-frame/scene/silence/quality evidence, then choose deterministic timeline operations or a constrained semantic AI edit. Trigger for repurpose, montage, cleanup, localization, narration, or local content changes.

Orkas-AI/Orkas-VideoStudio · 62 tokens

agentacct-workflow

Use when working in a repo with agentacct MCP configured, or when asked to track coding-agent work, smoke-test agentacct integrations, or report objective AI-agent task evidence.

mikehasa/agentacct · 40 tokens

decant: Skill for Claude Code