New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Ax Add Ingest Stage

by Necmttn in Necmttn/ax

A skill your agent uses when adding a new ingest stage or a new SurrealDB table to the ax graph.

AGPL-3.0Auto-check passed

Install Ax Add Ingest Stage

skills CLI
$ npx skills add Necmttn/ax --skill ax-add-ingest-stage -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Necmttn/ax ax-add-ingest-stage --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Necmttn/ax.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.ax/skills/ax-add-ingest-stage .claude/skills/ax-add-ingest-stage && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ax-add-ingest-stage
GitHub stars
115
Token cost
~513 tokens
SKILL.md length
214 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
AGPL-3.0

At a glance

A skill your agent uses when adding a new ingest stage or a new SurrealDB table to the ax graph.

  • Works in 3 steps: Add the DEFINE TABLE ... SCHEMAFULL +… → Register it in SCHEMA_TABLES… → In a worktree, run bun install so…
  • Adding a new ingest stage
  • SKILL.md covers New SurrealDB table, New derive-tagged ingest stage, New CLI subcommand and Effect v4 beta gotchas
  • Calls bun

What it does

Ax Add Ingest Stage is an agent skill from Necmttn/ax. 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.

Its SKILL.md is about 510 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with SurrealDB. The repository describes itself as: the agent experience layer · observability + memory for AI coding agents (Claude Code + Codex) · local-first, typed, yours. The licence is AGPL-3.0.

When your agent uses it

  • Adding a new ingest stage
  • A new SurrealDB table to the ax graph

Example prompts

  • “/ax-add-ingest-stage”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Add the DEFINE TABLE ... SCHEMAFULL + fields to packages/schema/src/schema.surql (top-level fields explicit; nested objects → JSON-encoded…
  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…
  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.

What it can do on your machine

Read from SKILL.md and the folder at commit fca259c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bun

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ax Add Ingest Stage loads about 513 tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 214 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~40
When it runs · the whole SKILL.md, loaded when a task matches
~513

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Necmttn/ax at commit fca259c, republished under its AGPL-3.0 licence (© Necmttn). 214 words, ~513 tokens.

Download SKILL.mdSave it as .claude/skills/ax-add-ingest-stage/SKILL.md (or your agent's skills folder).
name
ax-add-ingest-stage
description
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 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()).

© Necmttn, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .ax/skills/ax-add-ingest-stage of Necmttn/ax.

Open the folder on GitHubat commit fca259c

Compare with similar skills

Ax Add Ingest Stage next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ax Add Ingest Stage compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ax Add Ingest Stage this skillNecmttn/ax115—~513Automated safety check: PassAGPL-3.0
Web Accessibilitysurrealdb/docs.surrealdb.com1211 repos~4.2kAutomated safety check: PassNone
Documentationsurrealdb/docs.surrealdb.com121—~2.4kAutomated safety check: PassNone
Surrealdb MemoryLeoYeAI/openclaw-master-skills2.2k—~5.6kAutomated safety check: PassMIT
Surrealdb Pythonaiskillstore/marketplace433—~2.6kAutomated safety check: PassNone
Ship ChecklistNecmttn/ax115—~873Automated safety check: PassAGPL-3.0

Similar skills

  • Web Accessibility

    surrealdb/docs.surrealdb.com

    Implement web accessibility (a11y) standards following WCAG 2.1 guidelines.

    121 GitHub starsUsed in 1 repo~4.2k tokens
    Frontend & DesignAuto-check passed

  • Documentation

    surrealdb/docs.surrealdb.com

    Writes and rewrites public-facing product documentation with a semi-technical tone, ASD-STE100 Simplified Technical English, clear structure, and careful disclosure.

    121 GitHub stars~2.4k tokensUpdated today
    DatabasesAuto-check passed

  • Surrealdb Memory

    LeoYeAI/openclaw-master-skills

    A comprehensive knowledge graph memory system with semantic search, episodic memory, working memory, automatic context injection, and per-agent isolation.

    2.2k GitHub stars~5.6k tokensUpdated 2 mo ago
    Knowledge ManagementAuto-check passed

  • Surrealdb Python

    aiskillstore/marketplace

    Master SurrealDB 2.3.x with Python for multi-model database operations including CRUD, graph relationships, vector search, and real-time queries.

    433 GitHub stars~2.6k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed

  • Ship Checklist

    Necmttn/ax

    Definition-of-done checklist for shipping a new write, signal, table, edge, or query to the ax graph.

    115 GitHub stars~873 tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed

  • Wiki Ingest

    paperclipai/paperclip

    A skill your agent uses when an operation issue asks to ingest a captured raw/ source into the LLM Wiki, or the user says "ingest <slug".

    100k GitHub stars~933 tokensUpdated today
    Knowledge ManagementAuto-check passed

More from Necmttn/ax

All 12 skills in this repo

  • Tune

    Necmttn/ax

    Retrospective on one coding session that proposes changes to the agent's environment (hooks, checks, steering files, tool access) and files each as an ax proposal.

    115 GitHub stars~1.3k tokensUpdated 4 days ago
    Auto-check passed

  • Ax Narrate

    Necmttn/ax

    Write the agent-generated narration of the current session - the reviewable story of what changed, including what never reaches a PR (user corrections, abandoned attempts, tool failures).

    115 GitHub stars~1.7k tokensUpdated 4 days ago
    Auto-check passed

  • Ax Repo

    Necmttn/ax

    Star the ax repo, file an issue / bug report, or fork-and-open-a-PR against github.com/Necmttn/ax on the user's behalf, by shelling out to the gh CLI.

    115 GitHub stars~1.8k tokensUpdated 4 days ago
    Auto-check passed

  • Release Announcement

    Necmttn/ax

    Draft or revise ax release announcements and website changelog pages.

    115 GitHub stars~1k tokensUpdated 4 days ago
    Auto-check passed

  • Retro

    Necmttn/ax

    Guided experiment-loop retrospective over the ax agent-experience graph.

    115 GitHub stars~3.5k tokensUpdated 4 days ago
    Auto-check passed

  • Retro Meta

    Necmttn/ax

    Deep retro of retros - investigation pass that surfaces improvements across older retros and the current ax setup.

    115 GitHub stars~1.8k tokensUpdated 4 days ago
    Auto-check passed

Works with

Questions about Ax Add Ingest Stage

What does Ax Add Ingest Stage do?

A skill your agent uses when adding a new ingest stage or a new SurrealDB table to the ax graph. Ax Add Ingest Stage is an agent skill from Necmttn/ax. Use when adding a new ingest stage or a new SurrealDB table to the ax graph.

When should I use Ax Add Ingest Stage?

Ax Add Ingest Stage fits situations like: adding a new ingest stage; A new SurrealDB table to the ax graph.

How do I install Ax Add Ingest Stage in Claude Code?

Run `npx skills add Necmttn/ax --skill ax-add-ingest-stage -a claude-code`. Or copy the skill folder (.ax/skills/ax-add-ingest-stage in Necmttn/ax) into .claude/skills/ax-add-ingest-stage in your project. Claude Code loads it when a task matches its description.

How do I install Ax Add Ingest Stage in Codex?

Run `npx skills add Necmttn/ax --skill ax-add-ingest-stage -a codex`. Or copy the skill folder (.ax/skills/ax-add-ingest-stage in Necmttn/ax) into .agents/skills/ax-add-ingest-stage in your project. Codex loads it when a task matches its description.

Can I use Ax Add Ingest Stage in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Necmttn/ax --skill ax-add-ingest-stage -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ax-add-ingest-stage, .gemini/skills/ax-add-ingest-stage, .github/skills/ax-add-ingest-stage and .opencode/skills/ax-add-ingest-stage in your project.

What does Ax Add Ingest Stage need to run?

Going by SKILL.md and its folder, Ax Add Ingest Stage needs the command-line tools its instructions call (bun).

Does Ax Add Ingest Stage access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ax Add Ingest Stage safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ax Add Ingest Stage use?

Ax Add Ingest Stage is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ax Add Ingest Stage use?

About 513 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ax Add Ingest Stage?

Skills that share tags, products or a category with Ax Add Ingest Stage: Web Accessibility (surrealdb/docs.surrealdb.com, 121 stars), Documentation (surrealdb/docs.surrealdb.com, 121 stars), Surrealdb Memory (LeoYeAI/openclaw-master-skills, 2.2k stars) and Surrealdb Python (aiskillstore/marketplace, 433 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ax Add Ingest Stage?

Necmttn (a GitHub user) maintains it in Necmttn/ax, which has 115 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 7, 2026.

Source: Necmttn/ax on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.