epiphany

A memory-library tool that searches distant notes for one surprising but useful connection. It is designed to find related ideas across different topics or parts of a project, rather than obvious nearby matches.

In plain words
What is it for?
Use it for a broad search across the Ultan library, a topic-focused search, or a search limited to one project and its subsystems.
Why use it?
It can reveal patterns between notes that are far apart and easy to miss during ordinary searches.

Skill for Claude CodeCodex

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.

agentmods
npx agentmods add skills/nickroci/ultan/epiphany
Any agent
npx skills add nickroci/ultan --skill epiphany
Clone the repo
git clone --depth 1 https://github.com/nickroci/ultan

Made for: Claude Code, Codex.

Per session 154 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,145 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00154 $0.03145
Opus 5 $0.00077 $0.01572
Sonnet 5 $0.00031 $0.00629
Haiku 4.5 $0.00015 $0.00314

Measured 2d ago against content hash 1a1e3cc4caa7, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

epiphany 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 2d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (inventory.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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.

skills/epiphany/SKILL.md · 221 lines

How it starts

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

Epiphany

A horizontal connection-finder for the Ultan library. The daemon already does vertical abstraction (rolling children up into a parent rule); this does the thing nothing else does — spots that two distant, unrelated entries share a latent structure, and surfaces the single best one.

The design rationale, and the one rule that makes this worth running: an epiphany is a remote association — a far pair with shared deep structure. Near-neighbours (same folder, same topic, already cross-linked) are obvious and worthless here. The value lives in pairs that are far apart in the graph but structurally rhyme. Everything below is built to find those and reject everything else.

Usage

/epiphany                  # free-roam the whole library (cross-domain)
/epiphany <seed/topic>     # free-roam, biased toward a region or theme
/epiphany <project>        # SCOPED: search one project, bridge across its subsystems

Free-roam finds the most surprising pair anywhere in the library. Scoped (e.g. /epiphany vol-predictor) constrains the search to one project and hunts a non-obvious connection across its subsystems (model/entry-signalinfrastructure/data-pipeline, evaluationpolicy, …), optionally bridging up to a global/ principle. "Distance" rescales from cross-domain to cross-subsystem — still genuinely far, and actionable for the project you're working in. Scoped is the better daily mode.

Method

The agent invoking this skill is the orchestrator. The scouts are the generators — and they do not fire once and stop. They converge over rounds, exchanging findings through a shared pool the orchestrator relays between them. (True peer-to-peer agent chatter isn't available; an orchestrator-mediated blackboard is the realistic — and more faithful — form: it mirrors a global workspace that competing processes read from and write to.) Run every step.

0 — Map the territory.

# free-roam: the whole library
python3 "<this-skill-dir>/inventory.py" --regions
# scoped to a project: partition it into subsystems (those become the scout regions)
python3 "<this-skill-dir>/inventory.py" --region projects/<PROJECT> --depth 3 --regions

Read the full file on GitHub · 221 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 2d ago First seen · 221 lines · 154 tokens per session scan A 1a1e3cc4caa7

Subscribe to this mod's changes

epiphany is a skill published in the GitHub repository nickroci/ultan (4 stars, last pushed 2mo ago), licensed MIT. It adds 154 tokens to every session and 3,145 once invoked, about $0.0008 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

frontend-ui-workflow

Use for frontend/UI build, change, redesign, polish, review, or Figma/screenshot implementation when visual quality, product-appropriate design taste, UX, responsive behavior, accessibility, component composition, or design-system consistency matters. Pair with software-development-workflow for code changes. Do not…

Daaaaave/agentic-workspace-core · 85 tokens

project-knowledge

Use when a task needs shared repository knowledge, project memory recall, durable documentation updates, knowledge routing, trust/safety checks, correction or consolidation of stale docs, crystallizing reusable lessons, or validation of the knowledge core. Use before non-trivial work that depends on project…

Daaaaave/agentic-workspace-core · 74 tokens

write-agent-handoff

Use when temporary task state, delegation payload, cold-start resume packet, review/debug brief, or compaction snapshot must be handed to another agent, workspace, subagent, reviewer, or future session. Do not use for durable project facts, raw transcript dumps, or ordinary same-session status summaries.

Daaaaave/agentic-workspace-core · 64 tokens

write-agent-skill

Use when creating, changing, reviewing, securing, or evaluating an agent skill; deciding whether behavior belongs in a skill; designing skill trigger boundaries, bundled resources, frontmatter, eval prompts, split/merge decisions, or skill security/supply-chain checks; or improving false-positive/false-negative skill…

Daaaaave/agentic-workspace-core · 77 tokens

software-development-workflow

Use this skill when the user asks you to implement, fix, refactor, test, review, or finish software changes that are more than a tiny mechanical edit. Use for vague coding requests like "make it work" when scope, evidence, debugging, security, or completion discipline is needed. Do not use for research-only…

Daaaaave/agentic-workspace-core · 90 tokens

research-to-knowledge

Use when a task asks for deep research, current external information, source-backed comparison, claim verification, source quality assessment, adversarial-source screening, repository/tool/practice evaluation, or saving researched findings into the knowledge core. Do not use for routine local code lookup or project…

Daaaaave/agentic-workspace-core · 67 tokens