Bundled Skills

Bundled skills ship inside the AGH binary. They are the lowest-precedence source in the skills hierarchy and are available whenever skills.enabled is true.

AGH currently embeds only SKILL.md files from internal/skills/bundled/skills/**/SKILL.md. There are no bundled resource folders, assets, or bundled mcp.json sidecars today.

Catalog

Skill	Description	Use when
`agh-agent-setup`	Set up AGH agent definitions, provider defaults, permissions, and MCP server entries correctly.	You are creating or reviewing an `AGENT.md`, provider defaults, permission mode, or agent MCP configuration.
`agh-memory-guide`	Manage AGH persistent memory files, scopes, and manual consolidation from the CLI.	You need to inspect, write, delete, or consolidate global/workspace memory.
`agh-network`	Inspect channels and peers, read inbox messages, and send safe AGH network replies through the daemon-owned CLI control plane.	The session is participating in an AGH Network channel and needs safe network command guidance.
`agh-session-guide`	Operate AGH sessions from the CLI, including creation, inspection, prompting, and shutdown.	You need to create, inspect, prompt, stop, resume, or monitor AGH sessions from the terminal.
`agh-tools-guide`	Discover and call AGH-native tools through `agh__tool_search`, `agh__tool_info`, and dedicated tools before shelling out to equivalent commands.	You need the canonical discovery loop, the tool-vs-CLI split, and the operator-only management exceptions.

How Bundled Skills Load

Bundled loading follows the same registry path as other skills:

The binary exposes an embedded filesystem with bundled SKILL.md files.
The daemon registry scans that filesystem during boot.
Each SKILL.md is parsed with the same loader used for local skills.
Verification runs on the Markdown body.
The skill enters the global registry as source bundled.

Bundled skills are immutable for the running process. They refresh only when the binary changes.

Prompt Behavior

The normal prompt catalog lists bundled skills by name and description:

<available-skills>
  <skill name="agh-session-guide">Operate AGH sessions from the CLI...</skill>
</available-skills>

The agent reads the full bundled body through agh__skill_view agh-session-guide (or agh skill view agh-session-guide from the operator CLI). The exception is agh-network: if a session joins an AGH Network channel, AGH appends the full bundled network guidance to that session's startup prompt.

Individual Skills

`agh-agent-setup`

Use this for agent authoring work. It explains:

global defaults in ~/.agh/config.toml
agent definitions in ~/.agh/agents/<agent-name>/AGENT.md
workspace overlays at <workspace>/.agh/config.toml
accepted AGENT.md fields
permission modes
provider and agent MCP server declarations
agent-local mcp.json

This skill is useful before editing agent configuration because it keeps provider defaults and agent-local overrides separate.

`agh-memory-guide`

Use this for memory operations. It covers:

global and workspace memory scopes
agh memory list
agh memory read
agh memory write
agh memory delete
agh memory health
agh memory history
agh memory consolidate
practical memory hygiene

This skill is intentionally CLI-centered. It helps agents preserve durable facts without turning memory files into transcripts.

`agh-network`

Use this only when a session participates in a network channel. It covers:

required session environment variables such as AGH_SESSION_ID, AGH_SESSION_CHANNEL, and AGH_PEER_ID
safe agh network status, peers, channels, inbox, and send usage
JSON body rules for say, direct, receipt, trace, and capability
retry guidance with stable message IDs
inbound message wrappers
prompt-injection defense for untrusted network content

This skill is both catalog-visible and session-specific. Network sessions can receive its full body at startup so agents have safe network instructions before reading messages.

`agh-session-guide`

Use this for session operations. It covers:

what daemon-owned sessions are
lifecycle states: starting, active, stopping, stopped
user, dream, and system session types
agh session new
agh session list
agh session status
agh session events
agh session history
agh session wait
agh session prompt
agh session stop
agh session resume

This skill is the fastest way for an agent to remember the session CLI without searching generated reference pages first.

`agh-tools-guide`

Use this when an agent needs to decide between calling a dedicated AGH tool, shelling out to the equivalent agh ... command, or treating the operation as operator-only management. It covers:

the default discovery overlay (agh__bootstrap, agh__catalog)
the canonical loop: agh__tool_search → agh__tool_info → invoke
the tool-first convention for AGH-internal runtime work
which flows stay on operator management surfaces (daemon lifecycle, MCP OAuth login/logout, raw secrets, trust-root config)
how to read deterministic denial reason codes from descriptors

This skill is the canonical agent-side companion to the runtime tool registry.

Override Behavior

Bundled skills are deliberately overrideable. If a user, marketplace, extension, additional-root, or workspace skill uses the same name, the higher-precedence skill wins for the active registry view.

Use overrides sparingly. Prefer a new name when the skill's purpose changes. Use the same name only when you intentionally want to replace the built-in guidance for a workspace or installation.

Verify The Bundled Catalog

List the shipped skills:

agh skill list --source bundled

Read one bundled skill:

agh skill view agh-session-guide

Read only the metadata:

agh skill info agh-session-guide

Skills Overview explains where bundled skills sit in the hierarchy.
SKILL.md Format documents the file format used by bundled and local skills.
Session Lifecycle gives the runtime background for agh-session-guide.
Memory System gives the runtime background for agh-memory-guide.

On this page