Bundled Skill
The AGH skill compiled into the runtime, its reference files, and how contextual loading works.
- Audience
- Operators running durable agent work
- Focus
- Skills guidance shaped for scanability, day-two clarity, and operator context.
The bundled agh skill ships inside the AGH binary. It is the lowest-precedence source in the skills
hierarchy and are available whenever skills.enabled is true.
AGH currently ships one bundled skill: agh. The skill lives at skills/agh/SKILL.md with resource
files under skills/agh/references/. This layout is a normal skill directory, so the same content
can be installed outside AGH by coding agents that want AGH operating guidance without importing the
runtime.
Catalog
| Skill | Description | Use when |
|---|---|---|
agh | Operate and extend AGH, the local-first agent operating system. | You are working with AGH sessions, agents, tools, skills, memory, network channels, tasks, capabilities, bundles, QA, docs, or repository contribution. |
The current runtime does not ship aliases for previous alpha agh-* bundled skill names. A caller
that needs AGH guidance should load agh and then read the reference file selected by its router.
Reference files
The agh skill body is a router. It keeps startup prompts small and sends agents to focused
reference files:
| Reference | Covers |
|---|---|
references/runtime-operations.md | Daemon state, session lifecycle, session CLI, and runtime troubleshooting. |
references/agent-definitions.md | AGENT.md, provider defaults, permission modes, agent MCP sidecars, and setup workflow. |
references/tools-and-skills.md | Tool-first operating model, skill search/view, skill resources, and skill authoring rules. |
references/native-tools.md | Daemon-native toolsets, stable agh__* IDs, descriptor discipline, and CLI fallback rules. |
references/network.md | AGH Network channels, peers, inboxes, threads, direct rooms, work items, receipts, traces, and send safety. |
references/memory.md | Memory scopes, read/write/search flows, hygiene, and consolidation boundaries. |
references/tasks-and-orchestration.md | Coordinator, worker, and reviewer loops, task authority, session-bound tools, and review verdict rules. |
references/capabilities-and-bundles.md | Capabilities, extension resources, bundle presets, hooks, manageability, and config lifecycle. |
references/contributing-to-agh.md | Repository contribution rules, Go/runtime expectations, greenfield cuts, and tests. |
references/qa-and-verification.md | Test placement, verification gates, QA bootstrap, and completion evidence. |
references/docs-design-and-copy.md | Site docs, product copy, generated docs, design/copy authorities, and vocabulary. |
How bundled loading works
Bundled loading follows the same registry path as other skills:
- The binary exposes an embedded filesystem from the root
skillspackage. - The daemon registry scans that filesystem during boot.
skills/agh/SKILL.mdis 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 content is immutable for the running process. It refreshes only when the binary changes.
User, marketplace, extension, additional-root, workspace, and agent-local skills can still override
the bundled agh name by precedence. That is an override, not an alias.
Prompt behavior
The normal prompt catalog lists the bundled skill by name and description:
<available-skills>
<skill name="agh">Operate and extend AGH, the local-first agent operating system...</skill>
</available-skills>Agents load the full router through agh__skill_view with { "name": "agh" }. Operators can read
the same body with:
agh skill view aghAgents and operators read a focused resource file instead of the whole manual when the router names one:
{ "name": "agh", "file": "references/network.md" }agh skill view agh --file references/network.mdThe daemon also injects selected agh reference files when a session context requires them:
| Context | Injected reference |
|---|---|
| Tool prompt section | references/tools-and-skills.md and references/native-tools.md |
| Network channel session | references/network.md |
| Task reviewer routing prompt | references/tasks-and-orchestration.md |
These injections are contextual prompt help. Runtime authority still lives in the daemon services, not in the skill text.
Native tools and authority
The bundled agh skill teaches agents how to find and use AGH-native tools, but it does not grant
tool access. Tool visibility and invocation are enforced by the tool registry, session scope,
toolsets, approval policy, and the owning runtime service. Agents should start with
agh__tool_search, inspect candidates with agh__tool_info, and then call the dedicated tool when
it is available in the active scope.
The review submit path is the clearest example. The reviewer-facing prompt tells the session to load
agh and read references/tasks-and-orchestration.md, but the submit_run_review model-facing
tool is available only when task.Service.LookupReviewForSession(session_id) finds an active bound
review. When available, the tool persists the verdict through task.Service.RecordRunReview. The
skill is instructional; the binding is the authority.
Related pages
- SKILL.md Format documents skill frontmatter, body conventions, sidecars, and resources.
- Skills Overview documents the full source hierarchy and prompt catalog.
- Tools documents native tool discovery and policy.
- Review Gate documents reviewer-bound verdict authority.