> Part of the walkerOS documentation. Project overview and full index: <https://www.walkeros.io/llms.txt>

# walkerOS Skills

Skills are the source of truth for working with walkerOS. Each page below is generated from the matching `skills/<name>/SKILL.md` in the repository.

## Understanding[​](#understanding "Direct link to Understanding")

* [Understanding Destinations](https://www.walkeros.io/skills/walkeros-understanding-destinations.md) — Use when working with walkerOS destinations, understanding the destination interface, or learning about env pattern and configuration. Covers interface, lifecycle, env mocking, and paths.
* [Understanding Development](https://www.walkeros.io/skills/walkeros-understanding-development.md) — Use when contributing to walkerOS, before writing code, or when unsure about project conventions. Covers build/test/lint workflow, XP principles, folder structure, and package usage.
* [Understanding Events](https://www.walkeros.io/skills/walkeros-understanding-events.md) — Use when creating walkerOS events, understanding event structure, or working with event properties. Covers entity-action naming, event properties, statelessness, and vendor-agnostic design.
* [Understanding Flow](https://www.walkeros.io/skills/walkeros-understanding-flow.md) — Use when learning walkerOS architecture, understanding data flow, or designing composable event pipelines. Covers Source→Collector→Destination pattern and separation of concerns.
* [Understanding Mapping](https://www.walkeros.io/skills/walkeros-understanding-mapping.md) — Use when transforming walkerOS events in the flow (source→collector or collector→destination), configuring data/map/loop/set/condition/policy, or using $code: syntax in JSON configs.
* [Understanding Sources](https://www.walkeros.io/skills/walkeros-understanding-sources.md) — Use when working with walkerOS sources, understanding event capture, or learning about the push interface. Covers browser, dataLayer, and server source patterns.
* [Understanding Stores](https://www.walkeros.io/skills/walkeros-understanding-stores.md) — Use when working with walkerOS stores, understanding key-value storage in flows, or learning about store injection via env. Covers interface, lifecycle, $store. wiring, and available store packages.
* [Understanding Transformers](https://www.walkeros.io/skills/walkeros-understanding-transformers.md) — Use when working with walkerOS transformers, understanding event validation/enrichment/redaction, or learning about transformer chaining. Covers interface, return values, and pipeline integration.

## Using[​](#using "Direct link to Using")

* [Using Cli](https://www.walkeros.io/skills/walkeros-using-cli.md) — Use when bundling walkerOS flows, testing events with simulate/push, running local servers, validating configs, or configuring Flow JSON files.
* [Using Logger](https://www.walkeros.io/skills/walkeros-using-logger.md) — Use when working with walkerOS sources/destinations to understand standard logging patterns, replace console.log, or add logging to external API calls. Covers DRY principles, when to log, and migration patterns.
* [Using Step Examples](https://www.walkeros.io/skills/walkeros-using-step-examples.md) — Use when writing, simulating, validating, or testing with walkerOS step examples. Covers the complete lifecycle from authoring examples to CI integration.
* [Using Store Cache](https://www.walkeros.io/skills/walkeros-using-store-cache.md) — Use when adding read-through caching to a walkerOS store, memoizing a slow API/Sheets backing, composing multi-tier cache chains, or deduplicating concurrent store reads. Covers recipes, TTL choice, error policy, and observability counters.
* [Using Transformer Ga4](https://www.walkeros.io/skills/walkeros-using-transformer-ga4.md) — Use when wiring `@walkeros/transformer-ga4` into a server flow, overriding default GA4 event mappings, dropping events, adding custom event keys, or troubleshooting GA4 Measurement Protocol decoding. Covers the `before`-chain wiring contract, configuration recipes, and per-field patching with extend/remove.

## Creating[​](#creating "Direct link to Creating")

* [Create Cmp Source](https://www.walkeros.io/skills/walkeros-create-cmp-source.md) — Use when creating a new walkerOS CMP (consent management platform) source. Structured fill-in-the-blanks workflow that turns any CMP's consent API into a walkerOS source package. Covers CookieFirst, Usercentrics, CookiePro/OneTrust patterns and generalizes to any CMP.
* [Create Destination](https://www.walkeros.io/skills/walkeros-create-destination.md) — Use when creating a new walkerOS destination to send events to a vendor or API (GA4/gtag, Meta/Facebook Pixel, Mixpanel, Amplitude, a custom HTTP API, Measurement Protocol), web or server-side. Example-driven workflow: research the vendor SDK and define step examples before implementing the destination interface, env pattern, and mappings.
* [Create Source](https://www.walkeros.io/skills/walkeros-create-source.md) — Use when creating a new walkerOS source to capture events (browser source, dataLayer interception, server/HTTP source, webhook receiver, event capture), web or server-side. Example-driven workflow: research the input format and define step examples before implementing the push interface, createTrigger, and env pattern.
* [Create Transformer](https://www.walkeros.io/skills/walkeros-create-transformer.md) — Use when creating a new walkerOS transformer to modify events in the pipeline (validate, enrich, or redact) at a before/next chain position. Example-driven workflow for the transformer interface, return values, and chaining.

## Tasks[​](#tasks "Direct link to Tasks")

* [Debugging](https://www.walkeros.io/skills/walkeros-debugging.md) — Use when walkerOS events aren't reaching destinations, debugging event flow, or troubleshooting mapping issues. Covers common problems and debugging strategies.
* [Mapping Configuration](https://www.walkeros.io/skills/walkeros-mapping-configuration.md) — Use when configuring walkerOS event mappings for specific use cases. Provides recipes for GA4, Meta, custom APIs, and common transformation patterns.
* [Mcp Actions](https://www.walkeros.io/skills/walkeros-mcp-actions.md) — Use when an AI agent calls walkerOS MCP tools from code (code execution / Code Mode, a Worker, or an app sandbox) to validate, simulate, bundle, or inspect flows and packages, and wants to filter large results in code instead of issuing many separate tool calls.
* [Testing Strategy](https://www.walkeros.io/skills/walkeros-testing-strategy.md) — Use when writing tests, reviewing test code, or discussing testing approach for walkerOS packages. Covers env pattern, dev examples, and package-specific strategies.
* [Writing Documentation](https://www.walkeros.io/skills/walkeros-writing-documentation.md) — Use when writing or updating walkerOS documentation - README, website docs, or skills. Covers quality standards, example validation, and DRY patterns.