aidd-observe

aidd-observe is a skill for Claude Code, Codex from paralleldrive/aidd. It costs 61 tokens per session (738 once invoked), scanned A, original, MIT.

A set of rules for using Observe, a way to receive updates when data changes, in Adobe's data library.

In plain words
What is it for?
Use it when creating, combining, filtering, mapping, or managing Observe-based reactive data flows.
Why use it?
It helps prevent incorrect data transformations, missed updates, and subscription-handling mistakes.

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/paralleldrive/aidd/aidd-observe
Any agent
npx skills add paralleldrive/aidd --skill aidd-observe
Clone the repo
git clone --depth 1 https://github.com/paralleldrive/aidd

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 aidd-observe

README.md
[![agentmods](https://agentmods.dev/badge/skills/paralleldrive/aidd/aidd-observe.svg)](https://agentmods.dev/skills/paralleldrive/aidd/aidd-observe)
Your own site
<a href="https://agentmods.dev/skills/paralleldrive/aidd/aidd-observe"><img src="https://agentmods.dev/badge/skills/paralleldrive/aidd/aidd-observe.svg" alt="Measured on agentmods" height="20"></a>
Per session 61 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 738 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.00061 $0.00738
Opus 5 $0.00030 $0.00369
Sonnet 5 $0.00012 $0.00148
Haiku 4.5 $0.00006 $0.00074

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

Security

Grade A, and why

aidd-observe 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 4d 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.

ai/skills/aidd-observe/SKILL.md · 100 lines

How it starts

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

Observe pattern

Observe<T> from @adobe/data/observe — a subscription function: (notify: (value: T) => void) => Unobserve. Callback may be invoked synchronously or asynchronously, zero or more times. Returns Unobserve to stop observing.


Creation helpers

Helper Usage
Observe.fromConstant(value) Observe<T> from a constant value
Observe.fromProperties({ a, b }) Combine named observables into Observe<{ a, b }>
Observe.fromArray([obs1, obs2]) Combine array of observables into Observe<T[]>
Observe.fromPromise(() => Promise) Lazy; notifies once when promise resolves
Observe.createState(initial?) [Observe<T>, (value: T) => void] — mutable state
const constant = Observe.fromConstant(42);
const combined = Observe.fromProperties({ a: db.observe.resources.a, b: db.observe.resources.b });
const [count, setCount] = Observe.createState(0);

Transformation helpers

Helper Usage
Observe.withMap(obs, fn) Transform value; map from one type to another
Observe.withFilter(obs, fn) Transform or filter; return undefined to skip
Observe.withDefault(default, obs) Use default when value is undefined
const doubled = Observe.withMap(count, n => n * 2);
const isDev = Observe.withMap(service.type, t => t === 'development');
const max = Observe.withFilter(
  Observe.fromProperties({ a, b }),
  ({ a, b }) => Math.max(a, b)
);
const withFallback = Observe.withDefault('unknown', maybeName);

Conversion helpers

Helper Usage
Observe.toPromise(obs) Resolve with first value (one-shot)
const first = await Observe.toPromise(service.states);

Common patterns

Derived observable from service:

export const isDevelopment = memoize((service: Pick<EnvironmentService, 'type'>) =>
  Observe.withMap(service.type, type => type === 'development')
);

Computed from multiple resources:

Observe.withFilter(
  Observe.fromProperties({ a: db.observe.resources.a, b: db.observe.resources.b }),
  ({ a, b }) => Math.max(a, b)
);

Read the full file on GitHub · 100 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. 4d ago First seen · 100 lines · 61 tokens per session scan A d10ef85c5ade

Subscribe to this mod's changes

aidd-observe is a skill published in the GitHub repository paralleldrive/aidd (380 stars, last pushed 2mo ago), licensed MIT. It adds 61 tokens to every session and 738 once invoked, about $0.0003 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-30.