agh

Files (12)

• SKILL.md
• agent-definitions.md · references/
• capabilities-and-bundles.md · references/
• contributing-to-agh.md · references/
• docs-design-and-copy.md · references/
• memory.md · references/
• native-tools.md · references/
• network.md · references/
• qa-and-verification.md · references/
• runtime-operations.md · references/
• tasks-and-orchestration.md · references/
• tools-and-skills.md · references/

SKILL.md (first lines)

# AGH

Use this skill when operating AGH or contributing to the AGH repository. This body is a router, not the full manual. Load the matching reference before acting.

## Required Reading Router

Match the task to the row. Read the listed files in full before producing output. They are not appendices. Inline reminders in this file are only tripwires.

| Task                                                                                                                       | MUST read                                                               |
| -------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| Start, inspect, prompt, stop, resume, or debug AGH sessions and daemon state                                               | references/runtime-operations.md                                        |
| Create or review AGH agent definitions, provider defaults, permissions, or MCP sidecars                                    | references/agent-definitions.md + references/tools-and-skills.md        |
| Discover or call AGH-native tools, inspect native tool IDs, view skills, or choose tools vs CLI                            | references/tools-and-skills.md + references/native-tools.md             |
| Participate in an AGH Network channel, thread, direct room, work item, receipt, trace, or capability exchange              | references/network.md                                                   |
| Read, write, clean, or consolidate AGH memory                                                                              | references/memory.md                                                    |
| Work as a coordinator, task worker, or task reviewer                                                                       | references/tasks-and-orchestration.md                                   |
| Design or manage capabilities, bundles, extension resources, hooks, config lifecycle, or agent-manageable runtime surfaces | references/capabilities-and-bundles.md + references/tools-and-skills.md |
| Contribute to the AGH repository, especially Go runtime code or tests                                                      | references/contributing-to-agh.md + references/qa-and-verification.md   |
| Change public docs, product copy, design guidance, site docs, or UI-facing text                                            | references/docs-design-and-copy.md                                      |
| Finish work, claim readiness, or prepare a handoff                                                                         | references/qa-and-verification.md                                       |

## Reference Index

- references/runtime-operations.md - daemon and session operating model, session CLI, lifecycle diagnostics, and runtime troubleshooting.
- references/agent-definitions.md - AGENT.md structure, provider defaults, permissions, category paths, MCP sidecars, and safe setup workflow.
- references/tools-and-skills.md - AGH-native tool discovery, skill view/search, bundled resources, management-surface exceptions, and skill authoring rules.
- references/native-tools.md - daemon-native toolsets, stable AGH tool IDs, when to inspect descriptors, and CLI fallbacks for agents running inside AGH.
- references/network.md - AGH Network channel/thread/direct-room semantics, native tools, CLI fallback, message bodies, retries, and injection defense.
- references/memory.md - durable memory scopes, CLI operations, memory hygiene, and when not to write memory.
- references/tasks-and-orchestration.md - coordinator, worker, and reviewer loops, task authority boundaries, review verdict rules, and sensitive-data limits.
- references/capabilities-and-bundles.md - capability naming, extension resources, bundles, hooks, manageability, and config lifecycle expectations.
- references/contributing-to-agh.md - repository-specific engineering rules for Go/runtime work, greenfield hard cuts, tests, docs, and no-compat policy.
- references/qa-and-verification.md - test placement, real verification, QA bootstrap, final gates, and evidence standards.
- references/docs-design-and-copy.md - docs/site/copy/design authority, vocabulary, generated docs, and truthful UI/copy rules.

## Operating Loop

1. Identify whether the work is operator use, external-agent use, or AGH repository contribution.
2. Read every reference selected by the router before acting.
3. Prefer AGH-native tools and structured outputs over prose, logs, or direct internal access when managing AGH.
4. Keep authority with the daemon: task state, review verdicts, session lifecycle, memory, capabilities, bundles, hooks, and network sends must use AGH public surfaces.
5. For repository contribution, follow the local repo instructions before editing, including the relevant AGENTS.md, CLAUDE.md, and skill dispatch rules.
6. Finish with fresh verification evidence that matches the scope of the claim.

**STOP. Read references/tools-and-skills.md and references/native-tools.md in full before discovering, invoking, creating, or modifying any AGH tool or skill.** The catalog in this file is only a router.

**STOP. Read references/tasks-and-orchestration.md in full before acting as a coordinator, worker, or reviewer.** Task authority and review verdicts are runtime contracts, not prompt conventions.

**STOP. Read references/qa-and-verification.md in full before claiming AGH work is complete.** Passing a narrow command is not evidence for a broad completion claim.

From haryelramalho/skills, MIT.

More from haryelramalho/skills