How do I install the Ax Add Ingest Stage skill?

Run npx skillmds@latest add necmttn/ax-add-ingest-stage in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ax Add Ingest Stage safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ax Add Ingest Stage?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ax Add Ingest Stage free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ax Add Ingest Stage?

Necmttn (@necmttn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ax Add Ingest Stage by necmttn — Agent Skill

Name: Ax Add Ingest Stage
Rating: 4.2 (5 reviews)
Author: Necmttn

File contents

Adding an ingest stage / table to ax

Hard-won checklist - each step below has a CI gate that fails if you skip it.

New SurrealDB table

Add the DEFINE TABLE ... SCHEMAFULL + fields to packages/schema/src/schema.surql (top-level fields explicit; nested objects → JSON-encoded string; datetimes via JS Date).
Register it in SCHEMA_TABLES (apps/axctl/src/queries/insights.ts) - a mirror test diffs DEFINE TABLE names vs SCHEMA_TABLES and fails CI if missing.
In a worktree, run bun install so @ax/schema resolves to the worktree copy (not the main tree's symlink) before the mirror test will pass.

New `derive`-tagged ingest stage

Co-locate the StageDef at the bottom of the stage file (mirror apps/axctl/src/ingest/derive-opportunities.ts): export const FooKey = Schema.Literal("foo") + fooStage.
Register in apps/axctl/src/ingest/stage/registry.ts: add the import, add FooKey to the IngestStageKey Schema.Union([...]), add fooStage to ALL_STAGES.
Update apps/axctl/src/cli/effect-cli.test.ts: bump the resolveIngestStages: default runs every stage .toHaveLength(N) by 1, and add your key (sorted) to the --derive-only list. CI fails otherwise.
Isolate failures: wrap the stage body in Effect.catchCause returning a zero-row stat, so a stage error never aborts the surrounding ingest.

New CLI subcommand

Document it in BOTH cli-reference gates or CI fails: docs/cli.md (or README) + apps/site/public/llms.txt (scripts/check-cli-reference.ts), AND a card in apps/site/app/routes/docs/-cli-reference.data.ts (scripts/check-site-cli-reference.test.ts).

Effect v4 beta gotchas

Multi-arg Schema.Literal(...) collapses → use Schema.Literals([...]).
Schema.Date doesn't JSON round-trip → use Schema.DateFromString.check(Schema.isDateValid()).

---name: ax-add-ingest-stagedescription: Use when adding a new ingest stage or a new SurrealDB table to the ax graph. Encodes the exact registration gotchas that fail CI if missed.---# Adding an ingest stage / table to axHard-won checklist - each step below has a CI gate that fails if you skip it.## New SurrealDB table1. Add the `DEFINE TABLE ... SCHEMAFULL` + fields to `packages/schema/src/schema.surql` (top-level fields explicit; nested objects → JSON-encoded `string`; datetimes via JS `Date`).2. **Register it in `SCHEMA_TABLES`** (`apps/axctl/src/queries/insights.ts`) - a mirror test diffs `DEFINE TABLE` names vs `SCHEMA_TABLES` and **fails CI** if missing.3. In a worktree, run `bun install` so `@ax/schema` resolves to the worktree copy (not the main tree's symlink) before the mirror test will pass.## New `derive`-tagged ingest stage1. Co-locate the `StageDef` at the bottom of the stage file (mirror `apps/axctl/src/ingest/derive-opportunities.ts`): `export const FooKey = Schema.Literal("foo")` + `fooStage`.2. Register in `apps/axctl/src/ingest/stage/registry.ts`: add the import, add `FooKey` to the `IngestStageKey` `Schema.Union([...])`, add `fooStage` to `ALL_STAGES`.3. **Update `apps/axctl/src/cli/effect-cli.test.ts`**: bump the `resolveIngestStages: default runs every stage` `.toHaveLength(N)` by 1, and add your key (sorted) to the `--derive-only` list. CI fails otherwise.4. **Isolate failures**: wrap the stage body in `Effect.catchCause` returning a zero-row stat, so a stage error never aborts the surrounding ingest.## New CLI subcommandDocument it in **BOTH** cli-reference gates or CI fails: `docs/cli.md` (or README) + `apps/site/public/llms.txt` (scripts/check-cli-reference.ts), AND a card in `apps/site/app/routes/docs/-cli-reference.data.ts` (scripts/check-site-cli-reference.test.ts).## Effect v4 beta gotchas- Multi-arg `Schema.Literal(...)` collapses → use `Schema.Literals([...])`.- `Schema.Date` doesn't JSON round-trip → use `Schema.DateFromString.check(Schema.isDateValid())`.

Frequently asked questions

Ax Add Ingest Stage