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

Ship Checklist

by Necmttn in Necmttn/ax

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

AGPL-3.0Auto-check passedAgent Workflows

Install Ship Checklist

skills CLI
$ npx skills add Necmttn/ax --skill ship-checklist -a claude-code

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

GitHub CLI
$ gh skill install Necmttn/ax ship-checklist --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/skills/ship-checklist .claude/skills/ship-checklist && 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
ship-checklist
GitHub stars
115
Token cost
~873 tokens
SKILL.md length
433 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
AGPL-3.0

At a glance

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

  • Adding a SurrealDB table/edge/field
  • SKILL.md covers A. Write, B. Read - on-demand, C. Read - proactive (the… and D. Documentation, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • An ingest derive-stage

What it does

Ship Checklist is an agent skill from Necmttn/ax. Definition-of-done checklist for shipping a new write, signal, table, edge, or query to the ax graph. Use when adding a SurrealDB table/edge/field, an ingest derive-stage, a new analytic query, or any new ax capability - before opening the PR. Ensures every write gets an on-demand read AND a proactive (agent-facing) read AND docs/distribution, not just the write. Triggers on "ship", "new signal", "new table/edge", "new lens/query", "wire this up", "is this done", or finishing an ax feature branch.

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

It sits in Agent Workflows. 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 SurrealDB table/edge/field
  • An ingest derive-stage
  • A new analytic query
  • Any new ax capability - before opening the PR

Example prompts

  • “new signal”
  • “new table/edge”
  • “new lens/query”
  • “/ship-checklist”

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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Ship Checklist loads about 873 tokens when it runs. Until then it costs about 129 tokens; SKILL.md has 433 words of instructions outside code blocks.

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

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). 433 words, ~873 tokens.

Download SKILL.mdSave it as .claude/skills/ship-checklist/SKILL.md (or your agent's skills folder).
name
ship-checklist
description
Definition-of-done checklist for shipping a new write, signal, table, edge, or query to the ax graph. Use when adding a SurrealDB table/edge/field, an ingest derive-stage, a new analytic query, or any new ax capability - before opening the PR. Ensures every write gets an on-demand read AND a proactive (agent-facing) read AND docs/distribution, not just the write. Triggers on "ship", "new signal", "new table/edge", "new lens/query", "wire this up", "is this done", or finishing an ax feature branch.

ship-checklist - every write needs a read path an agent can find

The recurring miss in ax: we ship the write + an on-demand CLI read, and skip the proactive / agent-facing read. A signal only visible on a manual CLI run is invisible to the self-improvement loop. ax's whole thesis is that agents discover and act on signals - so a new write is not done until an agent can find it without being told.

Organizing rule: every write needs (B) an on-demand read AND (C) a proactive read AND an agent-facing surface (MCP/skill). Most features do A+B and stop.

Run this before opening the PR. Skipping a row is fine - but say so in the PR and why, don't skip silently.

A. Write

  • Schema in schema.surql + registered in SCHEMA_TABLES (CI mirror guard)
  • Ingest idempotent + incremental (since-aware) + deref-free denormalization for reads (no record derefs inside aggregates - they hang prod)
  • Backfill: does history get the signal, or only new data? Note "dark until re-ingest" if so
  • Stage deps = every producer of the input table

B. Read - on-demand

  • CLI: a command or a facet on an existing one (consistent family)
  • --json envelope for scripting
  • Dashboard/studio surface (if visual)

C. Read - proactive (the usually-missed half)

  • MCP tool so an agent can query it in-context (apps/axctl/src/mcp/tools.ts)
  • ax improve recommend generator - mint a proposal when the signal crosses a threshold (agent gets the suggestion unprompted)
  • ax insights / dashboard next-actions wiring (if it implies an action)
  • dojo agenda item (if the overnight loop should act on it)
  • Skill: a cognitive pattern teaching an agent to act on the signal (e.g. the ln skill routes visual judgment to subagents off ax cost images)
Show full SKILL.md (160 more words)Show less

D. Documentation

  • CLAUDE.md command/section docs (there is a docs gate for new subcommands)
  • llms.txt / site docs / README, if user-facing
  • CHANGELOG + release notes (release-please)
  • Spec in docs/superpowers/specs/ for non-trivial features

E. Onboarding / distribution

  • Onboarding prompt (@ax/onboarding-prompt) - should a day-1 user/agent know it exists?
  • Marketing coverage (site page / blog / X), if a user-facing capability
  • /api/version capability flag, if relevant

F. Verify (evidence, not assertion)

  • Tests: unit on pure helpers + schema-mirror guard + CLI command-list test
  • Live-verified against the real DB - paste the actual output in the PR
  • "Dark until data" honesty: state if it needs backfill/telemetry to light up

How to use

Create a TodoWrite item per relevant row, or paste the A-F headers into the PR body as a checked list. The point is the C section - if a new signal has no MCP tool, no improve generator, and no skill, an agent will never surface it on its own, and the feature is half-built no matter how clean the write is.

© 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 skills/ship-checklist of Necmttn/ax.

Open the folder on GitHubat commit fca259c

Compare with similar skills

Ship Checklist 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.

Ship Checklist compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ship Checklist this skillNecmttn/ax115—~873Automated safety check: PassAGPL-3.0
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
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official38k10 repos~4.1kAutomated safety check: NotesApache-2.0

Similar skills

  • 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

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed

  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    38k GitHub starsUsed in 10 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes

  • Using Superpowers

    farm-fe/farm

    A skill your agent uses when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions

    5.6k GitHub starsUsed in 36 repos~1.4k tokens
    Agent WorkflowsAuto-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

Categories

Questions about Ship Checklist

What does Ship Checklist do?

Definition-of-done checklist for shipping a new write, signal, table, edge, or query to the ax graph. Ship Checklist is an agent skill from Necmttn/ax. Definition-of-done checklist for shipping a new write, signal, table, edge, or query to the ax graph.

When should I use Ship Checklist?

Ship Checklist fits situations like: adding a SurrealDB table/edge/field; an ingest derive-stage; A new analytic query; any new ax capability - before opening the PR.

How do I install Ship Checklist in Claude Code?

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

How do I install Ship Checklist in Codex?

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

Can I use Ship Checklist 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 ship-checklist -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ship-checklist, .gemini/skills/ship-checklist, .github/skills/ship-checklist and .opencode/skills/ship-checklist in your project.

What does Ship Checklist need to run?

SKILL.md names no scripts, command-line tools or credentials: Ship Checklist is instructions for the agent only.

Does Ship Checklist 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 Ship Checklist 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 Ship Checklist use?

Ship Checklist 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 Ship Checklist use?

About 873 tokens (SKILL.md is roughly 3.5k 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 Ship Checklist?

Skills that share tags, products or a category with Ship Checklist: Documentation (surrealdb/docs.surrealdb.com, 121 stars), Surrealdb Memory (LeoYeAI/openclaw-master-skills, 2.2k stars), Surrealdb Python (aiskillstore/marketplace, 433 stars) and MCP Server Builder (anthropics/skills, 180k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ship Checklist?

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.