MCP HubMCP Hub
SKILL·C3B9F5

ax-add-ingest-stage

Necmttn
Updated Yesterday
92
9
92
View on GitHub
Developmentai

About

This Claude skill provides a checklist for developers adding new ingest stages or SurrealDB tables to the ax graph system. It encodes specific registration requirements that will cause CI failures if missed, including mandatory table registration in SCHEMA_TABLES. Use it when creating new derive-tagged ingest stages or database tables to avoid common gotchas.

Quick Install

Claude Code

Recommended
Primary
npx skills add Necmttn/ax -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/Necmttn/ax
Git CloneAlternative
git clone https://github.com/Necmttn/ax.git ~/.claude/skills/ax-add-ingest-stage

Copy and paste this command in Claude Code to install this skill

Documentation

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

  1. 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 stage

  1. 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 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()).

GitHub Repository

Necmttn/ax
Path: .ax/skills/ax-add-ingest-stage
0
agent-memoryagent-observabilityai-agentsbunclaude-codecodex
FAQ

Frequently asked questions

What is the ax-add-ingest-stage skill?

ax-add-ingest-stage is a Claude Skill by Necmttn. Skills package instructions and resources that Claude loads on demand, so Claude can perform ax-add-ingest-stage-related tasks without extra prompting.

How do I install ax-add-ingest-stage?

Use the install commands on this page: add ax-add-ingest-stage to Claude Code as a plugin, or clone its repository into your skills directory, then restart Claude so it picks up the skill.

What category does ax-add-ingest-stage belong to?

ax-add-ingest-stage is in the Development category, tagged ai.

Is ax-add-ingest-stage free to use?

Yes. ax-add-ingest-stage is listed on AIMCP and free to install.

Related Skills

qmd
Development

qmd is a local search and indexing CLI tool that enables developers to index and search through local files using hybrid search combining BM25, vector embeddings, and reranking. It supports both command-line usage and MCP (Model Context Protocol) mode for integration with Claude. The tool uses Ollama for embeddings and stores indexes locally, making it ideal for searching documentation or codebases directly from the terminal.

View skill
subagent-driven-development
Development

This skill executes implementation plans by dispatching a fresh subagent for each independent task, with code review between tasks. It enables fast iteration while maintaining quality gates through this review process. Use it when working on mostly independent tasks within the same session to ensure continuous progress with built-in quality checks.

View skill
mcporter
Development

The mcporter skill enables developers to manage and call Model Context Protocol (MCP) servers directly from Claude. It provides commands to list available servers, call their tools with arguments, and handle authentication and daemon lifecycle. Use this skill for integrating and testing MCP server functionality in your development workflow.

View skill
adk-deployment-specialist
Development

This skill deploys and orchestrates Vertex AI ADK agents using A2A protocol, managing AgentCard discovery, task submission, and supporting tools like Code Execution Sandbox and Memory Bank. It enables building multi-agent systems with sequential, parallel, or loop orchestration patterns in Python, Java, or Go. Use it when asked to deploy ADK agents or orchestrate agent workflows on Google Cloud.

View skill