provenance-trace

provenance-trace is a skill for Claude Code, Codex from ozzy-labs/suasor. It costs 124 tokens per session (948 once invoked), scanned A, original, MIT.

A read-only tool for tracing where a task, decision, or source came from. It follows links between records and can retrieve source text to build an origin chain.

In plain words
What is it for?
Use it to trace the origins of tasks and decisions, follow references across several links, and inspect the source material behind them.
Why use it?
It removes the need to manually search through related records to understand the reasoning or source behind an item.

Skill for Claude CodeCodex

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

Good fit Use it to trace the origins of tasks and decisions, follow references across several links, and inspect the source material behind them.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/ozzy-labs/suasor/provenance-trace
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 ozzy-labs/suasor --skill provenance-trace
Clone the repo
git clone --depth 1 https://github.com/ozzy-labs/suasor

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 provenance-trace

README.md
[![agentmods](https://agentmods.dev/badge/skills/ozzy-labs/suasor/provenance-trace/github.svg)](https://agentmods.dev/skills/ozzy-labs/suasor/provenance-trace)
Your own site
<a href="https://agentmods.dev/skills/ozzy-labs/suasor/provenance-trace"><img src="https://agentmods.dev/badge/skills/ozzy-labs/suasor/provenance-trace/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 provenance-trace

Your own site · 80×15
<a href="https://agentmods.dev/skills/ozzy-labs/suasor/provenance-trace"><img src="https://agentmods.dev/badge/skills/ozzy-labs/suasor/provenance-trace.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 124 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 948 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00124 $0.00948
Opus 5 $0.00062 $0.00474
Sonnet 5 $0.00025 $0.00190
Haiku 4.5 $0.00012 $0.00095

Measured 9d ago against content hash fdd6908f0b88, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

provenance-trace 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 9d 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.

docs/skills/provenance-trace/SKILL.md · 50 lines

What it actually says

provenance-trace

任意の entity(task / decision / source 等)を起点に「何に由来するか」を links projection 上で辿る read-only skill(ADR-0018 / ADR-0020)。decisions(決定の「なぜ」)や find(トピック横断)に埋もれていた汎用 provenance トレースを正面から扱う。

いつ発火するか

  • 「この task の出どころ」「由来を辿って」「<entity> は何から来た」
  • 「この decision の根拠 source」「provenance を遡って」「どこから派生した?」

何をするか(MCP tool flow)

read tool のみ(ADR-0004)。本文は持たず、links projection の有向エッジを辿る。

  1. 起点 entity を kind + id で特定する(例 task / decision / source
  2. provenance を辿る:
    • graph.related(1-hop 隣接)で直近の由来 / 関連を引く。directionout / in / both、既定 both)/ relation で絞る
    • 多段で遡るなら graph.expanddepth 既定 2・max 10 / limit)で BFS 展開する
    • 後方トレース(「この成果物は何に由来するか」)は direction=in で incoming のみを遡る(ADR-0020)。下流の consumer を見るなら direction=out
  3. relation は自動エッジ derived_from / replies_to / references と手動エッジ manual_link(手動 link は linkId 付き)
  4. 辿り着いた node の本文が要るものは source.getexternalId)で補う
  5. 由来チェーン(origin → 由来 source / 先行 entity)を組み立てて返す

制約

  • read-only。persist しない。エッジの追加 / 削除(link.add / link.remove)は本 skill では行わない(別経路の HITL write)
  • graph.expanddepth は max 10。cycle guard と edge dedup は traversal 側で担保される
  • 本 skill は手順書のみで実処理を持たない
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. 9d ago First seen · 50 lines · 124 tokens per session scan A fdd6908f0b88

Subscribe to this mod's changes

provenance-trace is a skill published in the GitHub repository ozzy-labs/suasor (0 stars, last pushed 1mo ago), licensed MIT. It adds 124 tokens to every session and 948 once invoked, about $0.0006 per session on Opus 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-08-31.

Related

Other skills, from other repositories

graph-mutation-plan

Cookbook for composing an applygraphmutations plan — stable entitykey patterns, the canonical label/edge vocabulary, evidence/invalidation/confidence discipline, and a worked example. Load this when building a non-trivial mutation plan.

potpie-ai/potpie · 51 tokens

review

Structured PR review for pygraphistry. Input: PR number/branch (default current branch PR). Output: findings and convergence artifacts under plans/ /. Method: multi-wave, evidence-first review across spec, correctness, tests, security, code quality, DRY, concurrency, performance, architecture, operability, and…

graphistry/pygraphistry · 69 tokens

test-amplification

Methodical bug-driven test amplification for pygraphistry features. Use when hardening a feature area via user-workflow exploration, 5-Whys retrospectives, bug-taxonomy derivation, concrete test planning, implementation, and safety-gated validation.

graphistry/pygraphistry · 56 tokens

plan

OPT-IN file-based planning for multi-session tasks. Only use when user explicitly requests it or work spans multiple sessions. For single-session work, prefer your platform's native planning features.

graphistry/pygraphistry · 38 tokens

deck-graphify-dark

A dark slide-deck template for AI tools, developer tools, and knowledge graphs, using gradients, floating blurred shapes, graph diagrams, code styling, and glass-like cards.

nexu-io/html-anything · 28 tokens

blueprint-graphs

Add, connect, and configure nodes in Blueprint event graphs and function graphs — function-call/event/branch/timer/custom-event/delegate nodes, Standard Macro nodes (ForEachLoop/ForLoop/WhileLoop/DoOnce/Gate/IsValid/FlipFlop via addmacroinstancenode), macro-graph creation, pin wiring, node layout, arrays, comment…

kevinpbuckley/VibeUE · 133 tokens