Skills

Skills are folders of instructions, scripts and references that follow the Agent Skills specification. 10xGraph uses them in two places: a bundled skill that teaches your coding assistant (Codex, Claude or GitHub Copilot) how to build with 10xGraph, and a runtime feature that lets your own agents load skills on demand. This page is for developers who want an assistant to write correct 10xGraph code, and for those packaging reusable agent behavior.

Start here

To teach an assistant, run agentflow skills --agent claude (or codex, github) from your project root. The sections below list exactly which files get installed. For the command itself, see Install skills and the CLI commands reference.

To give your own agents skills, read How to give an agent skills, then the Skills reference. The tutorial Skills walks through a working example from the repository.

10xGraph uses skills in two places. Both follow the Agent Skills specification, so a skill folder is portable between them:

The 10xGraph skill for coding assistants

10xGraph skills are bundled assistant instructions for coding agents such as Codex, Claude, and GitHub Copilot. They are copied from:

agentflow-api/agentflow_cli/cli/templates/skills

Use these skills when you want an assistant to understand 10xGraph package boundaries, graph patterns, CLI behavior, API routes, TypeScript client conventions, testing, and production guidance while editing an 10xGraph project.

agentflow skills --agent codex
agentflow skills --agent claude
agentflow skills --agent github

What gets installed

The same base skill bundle is copied into the assistant-specific location.

Every assistant gets the same folder, copied from:

agentflow-api/agentflow_cli/cli/templates/skills/agentflow

The bundle follows the Agent Skills specification. Paths inside SKILL.md are relative to the skill folder, so one copy works in every install location. Check it, or your own skills, with agentflow skills --validate <path>.

For GitHub Copilot, 10xGraph also copies:

agentflow-api/agentflow_cli/cli/templates/skills/copilot/agentflow.instructions.md

That file points Copilot at the installed skill bundle under .github/skills/agentflow/.

What the skill contains

The base bundle contains:

agentflow/
+-- SKILL.md
+-- references/
    +-- architecture.md
    +-- agents-and-tools.md
    +-- state-graph.md
    +-- state-and-messages.md
    +-- checkpointing-and-threads.md
    +-- dependency-injection.md
    +-- media-and-files.md
    +-- memory-and-store.md
    +-- streaming.md
    +-- production-runtime.md
    +-- api-client.md
    +-- remote-tools.md
    +-- callbacks-and-command.md
    +-- prebuilt-agents-and-tools.md
    +-- testing-and-evaluation.md
    +-- publishers-and-runtime-protocols.md
    +-- context-id-background.md
    +-- providers-and-adapters.md
    +-- security-and-validators.md
    +-- cli-commands.md
    +-- api-configuration.md
    +-- auth-and-authorization.md
    +-- api-settings-and-middleware.md
    +-- rest-api-and-errors.md
    +-- id-and-thread-name-generators.md
    +-- client-auth-and-errors.md
    +-- client-messages-invoke-stream.md
    +-- client-threads-memory-files.md

SKILL.md is the entry point. It tells the assistant when to use the 10xGraph skill, which packages exist, where the public docs live, and which reference file to read before changing a subsystem.

The reference files cover:

Install for one assistant

Run from the project root:

agentflow skills --agent codex

Supported values are codex, claude, github, or menu numbers 1, 2, 3.

If you omit --agent in an interactive terminal, 10xGraph prompts you to choose:

Which agent?
- 1. Codex
- 2. Claude
- 3. GitHub

In non-interactive environments, pass --agent or --all.

Install for every assistant

agentflow skills --all

If an installation already exists, --all skips that assistant unless you also pass --force.

Install into another project

agentflow skills --agent claude --path ./my-agent

The command refuses to install directly into the filesystem root or your home directory. Point --path at a project folder.

Update an existing install

agentflow skills --agent github --force

Use --force to replace an existing installed 10xGraph skill after updating the CLI.

List supported assistants

agentflow skills --list

Options

Related docs

• CLI commands
• Initialize a project
• Architecture